Widget.h

Go to the documentation of this file.

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2014 Robert Osfield
 *
 * This library is open source and may be redistributed and/or modified under
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * OpenSceneGraph Public License for more details.
*/

#ifndef OSGUI_WIDGET
#define OSGUI_WIDGET

#include <osg/Group>
#include <osg/BoundingBox>
#include <osg/ScriptEngine>
#include <osgGA/Event>
#include <osgGA/EventVisitor>

#include <osgUI/Style>

namespace osgUI
{

class OSGUI_EXPORT Widget : public osg::Group
{
public:
    Widget();
    Widget(const Widget& widget, const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY);
    META_Node(osgUI, Widget);

    virtual void traverse(osg::NodeVisitor& nv);
    virtual void traverseImplementation(osg::NodeVisitor& nv);

    virtual bool handle(osgGA::EventVisitor* ev, osgGA::Event* event);
    virtual bool handleImplementation(osgGA::EventVisitor* ev, osgGA::Event* event);

    typedef std::vector<osgUtil::LineSegmentIntersector::Intersection> Intersections;
    virtual bool computeIntersections(osgGA::EventVisitor* ev, osgGA::GUIEventAdapter* event, Intersections& intersections, osg::Node::NodeMask traversalMask = 0xffffffff) const;
    virtual bool computePositionInLocalCoordinates(osgGA::EventVisitor* ev, osgGA::GUIEventAdapter* event, osg::Vec3d& localPosition) const;
    virtual bool computeExtentsPositionInLocalCoordinates(osgGA::EventVisitor* ev, osgGA::GUIEventAdapter* event, osg::Vec3d& localPosition, bool withinExtents=true) const;

    virtual void dirty();

    typedef std::map<int, osg::ref_ptr<osg::Node> > GraphicsSubgraphMap;

    void setGraphicsSubgraph(int orderNum, osg::Node* node) { _graphicsSubgraphMap[orderNum] = node; _graphicsInitialized = true; }
    osg::Node* getGraphicsSubgraph(int orderNum) { GraphicsSubgraphMap::iterator itr = _graphicsSubgraphMap.find(orderNum); return (itr!=_graphicsSubgraphMap.end()) ? itr->second.get() :  0; }
    const osg::Node* getGraphicsSubgraph(int orderNum) const { GraphicsSubgraphMap::const_iterator itr = _graphicsSubgraphMap.find(orderNum); return (itr!=_graphicsSubgraphMap.end()) ? itr->second.get() :  0; }

    void setGraphicsSubgraphMap(const GraphicsSubgraphMap& gsm) { _graphicsSubgraphMap = gsm; _graphicsInitialized = true; }
    GraphicsSubgraphMap& getGraphicsSubgraphMap() { return _graphicsSubgraphMap; }
    const GraphicsSubgraphMap& getGraphicsSubgraphMap() const { return _graphicsSubgraphMap; }

    void setWidgetStateSet(osg::StateSet* stateset) { _widgetStateSet = stateset; }
    osg::StateSet* getWidgetStateSet() { return _widgetStateSet.get(); }
    const osg::StateSet* getWidgetStateSet() const { return _widgetStateSet.get(); }
    osg::StateSet* getOrCreateWidgetStateSet() { if (!_widgetStateSet) _widgetStateSet = new osg::StateSet; return _widgetStateSet.get(); }


    virtual void createGraphics();

    virtual void createGraphicsImplementation();


    virtual void setExtents(const osg::BoundingBoxf& bb);
    const osg::BoundingBoxf& getExtents() const { return _extents; }

    void setStyle(Style* style) { _style = style; }
    Style* getStyle() { return _style.get(); }
    const Style* getStyle() const { return _style.get(); }

    void setAlignmentSettings(AlignmentSettings* alignmentSettings) { _alignmentSettings = alignmentSettings; }
    AlignmentSettings* getAlignmentSettings() { return _alignmentSettings.get(); }
    const AlignmentSettings* getAlignmentSettings() const { return _alignmentSettings.get(); }

    void setFrameSettings(FrameSettings* textSettings) { _frameSettings = textSettings; }
    FrameSettings* getFrameSettings() { return _frameSettings.get(); }
    const FrameSettings* getFrameSettings() const { return _frameSettings.get(); }

    void setTextSettings(TextSettings* textSettings) { _textSettings = textSettings; }
    TextSettings* getTextSettings() { return _textSettings.get(); }
    const TextSettings* getTextSettings() const { return _textSettings.get(); }

    virtual void setAutoFillBackground(bool enabled) { _autoFillBackground = enabled; }
    virtual bool getAutoFillBackground() const { return _autoFillBackground; }

    virtual void setVisible(bool visible) { _visible = visible; }
    virtual bool getVisible() const { return _visible; }

    virtual void setEnabled(bool enabled) { _enabled = enabled; }
    virtual bool getEnabled() const { return _enabled; }

    enum FocusBehaviour
    {
        CLICK_TO_FOCUS,
        FOCUS_FOLLOWS_POINTER,
        EVENT_DRIVEN_FOCUS_DISABLED
    };

    void setFocusBehaviour(FocusBehaviour behaviour) { _focusBehaviour = behaviour; }
    FocusBehaviour getFocusBehaviour() const { return _focusBehaviour; }

    virtual void updateFocus(osg::NodeVisitor& nv);

    virtual void setHasEventFocus(bool focus);

    virtual bool getHasEventFocus() const;


    bool runCallbacks(const std::string& name, osg::Parameters& inputParameters, osg::Parameters& outputParameters) { return osg::runNamedCallbackObjects(this, name, inputParameters, outputParameters); }

    bool runCallbacks(const std::string& name) { osg::Parameters inputParameters, outputParameters; return osg::runNamedCallbackObjects(this, name, inputParameters, outputParameters); }


    virtual osg::BoundingSphere computeBound() const;

    virtual void enter();
    virtual void enterImplementation();

    virtual void leave();
    virtual void leaveImplementation();

    virtual void resizeGLObjectBuffers(unsigned int maxSize);
    virtual void releaseGLObjects(osg::State* = 0) const;

protected:
    virtual ~Widget() {}

    FocusBehaviour                      _focusBehaviour;
    bool                                _hasEventFocus;
    bool                                _graphicsInitialized;

    GraphicsSubgraphMap                 _graphicsSubgraphMap;
    osg::ref_ptr<osg::StateSet>         _widgetStateSet;

    osg::BoundingBoxf                   _extents;

    osg::ref_ptr<Style>                 _style;

    osg::ref_ptr<AlignmentSettings>     _alignmentSettings;
    osg::ref_ptr<FrameSettings>         _frameSettings;
    osg::ref_ptr<TextSettings>          _textSettings;
    bool                                _autoFillBackground;

    bool                                _visible;
    bool                                _enabled;
};

}

#endif