osgGA/Widget

Go to the documentation of this file.

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2013 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 OSGGA_WIDGET
#define OSGGA_WIDGET
 
#include <osg/Group>
#include <osg/BoundingBox>
#include <osgGA/Event>
#include <osgGA/EventVisitor>
 
namespace osgGA
{
 
class OSGGA_EXPORT Widget : public osg::Group
{
public:
    Widget();
    Widget(const Widget& tfw, const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY);
    META_Node(osgGA, 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);
 
    virtual bool computePositionInLocalCoordinates(osgGA::EventVisitor* ev, osgGA::GUIEventAdapter* event, osg::Vec3& localPosition) const;
 
    virtual void createGraphics();
    virtual void createGraphicsImplementation();
 
    virtual void setExtents(const osg::BoundingBoxf& bb);
    const osg::BoundingBoxf& getExtents() const { return _extents; }
 
    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;
 
    virtual osg::BoundingSphere computeBound() const;

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

    virtual void leave();
    virtual void leaveImplementation();
 
 
protected:
    virtual ~Widget() {}
 
    FocusBehaviour      _focusBehaviour;
    bool                _hasEventFocus;
    bool                _graphicsInitialized;
 
    osg::BoundingBoxf   _extents;
};
 
}
 
#endif