56 lines
2.2 KiB
Plaintext
56 lines
2.2 KiB
Plaintext
|
//C++ header - Open Scene Graph - Copyright (C) 1998-2001 Robert Osfield
|
|||
|
//Distributed under the terms of the GNU Library General Public License (LGPL)
|
|||
|
//as published by the Free Software Foundation.
|
|||
|
|
|||
|
#ifndef OSGGA_GUIACTIONADAPTER
|
|||
|
#define OSGGA_GUIACTIONADAPTER 1
|
|||
|
|
|||
|
#include <osgGA/Export>
|
|||
|
|
|||
|
namespace osgGA{
|
|||
|
|
|||
|
|
|||
|
/** Pure virtual base class for adapting the GUI actions requested by CameraManipulators
|
|||
|
* into actions which are handled by the GUI toolkit of the users application.
|
|||
|
*
|
|||
|
* There are several was of using the ActionAdapter either inheriting it as
|
|||
|
* done with osgGLUT::Viewer class or passing a simple struct to the camera
|
|||
|
* manipulator then unpacking the results and working out what to do to respond
|
|||
|
* to the requests.
|
|||
|
*
|
|||
|
* Also there are several ways to run your app and handle the updating of
|
|||
|
* the window. osgGLUT::Viewer always has a idle callback registered which does a
|
|||
|
* redraw all the time. osgGLUT::Viewer can safely ignore both requestRedraw() and
|
|||
|
* requestContinousUpdate() as these are happening all the time anyway.
|
|||
|
*
|
|||
|
* Other apps will probably want to respond to the requestRedraw() and
|
|||
|
* requestContinousUpdate(bool) and again there is more than one way to handle it.
|
|||
|
* You can override requestRedraw() and implement to call your own window
|
|||
|
* redraw straight away. Or you can implement so that a flag is set and
|
|||
|
* then you then respond the flag being set in your own leisure.
|
|||
|
*
|
|||
|
* requestContinousUpdate(bool) is for enabling a throw or idle
|
|||
|
* callback to be requested by the camera manipulator. Again you can respond
|
|||
|
* to this immediately by registering a idle callback or a timed callback, or
|
|||
|
* you can delay setting the callback and do at you own leisure.
|
|||
|
*
|
|||
|
* requestWarpPointer(int,int) is requesting a respositioning of a mouse pointer
|
|||
|
* to a specified x,y location on the window. Used by some camera manipulators
|
|||
|
* to initialize the mouse pointer when mouse position relative to a controls
|
|||
|
* neutral mouse position is required, i.e when mimicking a aircrafts joystick.
|
|||
|
*/
|
|||
|
class GUIActionAdapter
|
|||
|
{
|
|||
|
public:
|
|||
|
|
|||
|
virtual void requestRedraw() = 0;
|
|||
|
virtual void requestContinuousUpdate(bool needed=true) = 0;
|
|||
|
virtual void requestWarpPointer(int x,int y) = 0;
|
|||
|
|
|||
|
};
|
|||
|
|
|||
|
}
|
|||
|
|
|||
|
#endif
|
|||
|
|