88 lines
2.9 KiB
C++
88 lines
2.9 KiB
C++
/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 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_GUIEVENTHANDLER
|
|
#define OSGGA_GUIEVENTHANDLER 1
|
|
|
|
#include <vector>
|
|
|
|
#include <osg/NodeCallback>
|
|
#include <osg/Drawable>
|
|
#include <osg/ApplicationUsage>
|
|
|
|
#include <osgGA/Export>
|
|
#include <osgGA/GUIEventAdapter>
|
|
#include <osgGA/GUIActionAdapter>
|
|
|
|
|
|
// #define COMPILE_COMPOSITE_EVENTHANDLER
|
|
|
|
namespace osgGA{
|
|
|
|
/**
|
|
|
|
GUIEventHandler provides a basic interface for any class which wants to handle
|
|
a GUI Events.
|
|
|
|
The GUIEvent is supplied by a GUIEventAdapter. Feedback resulting from the
|
|
handle method is supplied by a GUIActionAdapter, which allows the GUIEventHandler
|
|
to ask the GUI to take some action in response to an incoming event.
|
|
|
|
For example, consider a Trackball Viewer class which takes mouse events and
|
|
manipulates a scene camera in response. The Trackball Viewer is a GUIEventHandler,
|
|
and receives the events via the handle method. If the user 'throws' the model,
|
|
the Trackball Viewer class can detect this via the incoming events, and
|
|
request that the GUI set up a timer callback to continually redraw the view.
|
|
This request is made via the GUIActionAdapter class.
|
|
|
|
*/
|
|
|
|
class OSGGA_EXPORT GUIEventHandler : public osg::NodeCallback, public osg::Drawable::EventCallback
|
|
{
|
|
public:
|
|
|
|
GUIEventHandler() {}
|
|
GUIEventHandler(const GUIEventHandler&,const osg::CopyOp&) {}
|
|
|
|
META_Object(osgGA,GUIEventHandler);
|
|
|
|
/** Event traversal node callback method.*/
|
|
virtual void operator()(osg::Node* node, osg::NodeVisitor* nv);
|
|
|
|
/** Event traversal drawable callback method.*/
|
|
virtual void event(osg::NodeVisitor* nv, osg::Drawable* drawable);
|
|
|
|
/** Handle events, return true if handled, false otherwise. */
|
|
virtual bool handle(const GUIEventAdapter& ea,GUIActionAdapter& aa, osg::Object*, osg::NodeVisitor*) { return handle(ea,aa); }
|
|
|
|
/** deprecated, Handle events, return true if handled, false otherwise. */
|
|
virtual bool handle(const GUIEventAdapter&,GUIActionAdapter&) { return false; }
|
|
|
|
/** Get the keyboard and mouse usage of this manipulator.*/
|
|
virtual void getUsage(osg::ApplicationUsage&) const {}
|
|
};
|
|
|
|
#ifdef USE_DEPRECATED_API
|
|
// keep for backwards compatibility
|
|
class GUIEventHandlerVisitor
|
|
{
|
|
public:
|
|
|
|
void visit(GUIEventHandler&) {}
|
|
};
|
|
#endif
|
|
|
|
}
|
|
|
|
#endif
|