Public Member Functions | Protected Member Functions | Protected Attributes

osgGA::UFOManipulator Class Reference

A UFO manipulator driven with keybindings. More...

Inheritance diagram for osgGA::UFOManipulator:
osgGA::MatrixManipulator osgGA::GUIEventHandler osg::NodeCallback osg::Drawable::EventCallback osg::Object osg::Object osg::Referenced osg::Referenced

List of all members.

Public Member Functions

 UFOManipulator ()
virtual const char * className () const
virtual void setByMatrix (const osg::Matrixd &matrix)
virtual void setByInverseMatrix (const osg::Matrixd &invmat)
virtual osg::Matrixd getMatrix () const
virtual osg::Matrixd getInverseMatrix () const
virtual void setNode (osg::Node *node)
virtual const osg::NodegetNode () const
virtual osg::NodegetNode ()
virtual void computeHomePosition ()
virtual void home (const osgGA::GUIEventAdapter &, osgGA::GUIActionAdapter &)
void home (double)
virtual void init (const GUIEventAdapter &, GUIActionAdapter &)
bool handle (const osgGA::GUIEventAdapter &ea, osgGA::GUIActionAdapter &aa)
void getUsage (osg::ApplicationUsage &usage) const
void getCurrentPositionAsLookAt (osg::Vec3 &eye, osg::Vec3 &center, osg::Vec3 &up)
void setMinHeight (double in_min_height)
double getMinHeight () const
void setMinDistance (double in_min_dist)
double getMinDistance () const
void setForwardSpeed (double in_fs)
double getForwardSpeed () const
void setSideSpeed (double in_ss)
double getSideSpeed () const
void setRotationSpeed (double in_rot_speed)
double getRotationSpeed () const

Protected Member Functions

virtual ~UFOManipulator ()
bool intersect (const osg::Vec3d &start, const osg::Vec3d &end, osg::Vec3d &intersection) const
void _stop ()
void _keyDown (const osgGA::GUIEventAdapter &ea, osgGA::GUIActionAdapter &)
void _keyUp (const osgGA::GUIEventAdapter &ea, osgGA::GUIActionAdapter &)
void _frame (const osgGA::GUIEventAdapter &ea, osgGA::GUIActionAdapter &)
void _adjustPosition ()

Protected Attributes

osg::ref_ptr< osg::Node_node
float _viewAngle
osg::Matrixd _matrix
osg::Matrixd _inverseMatrix
osg::Matrixd _offset
double _minHeightAboveGround
double _minDistanceInFront
double _speedEpsilon
double _forwardSpeed
double _sideSpeed
double _upSpeed
double _speedAccelerationFactor
double _speedDecelerationFactor
bool _decelerateUpSideRate
double _directionRotationEpsilon
double _directionRotationRate
double _directionRotationAcceleration
double _directionRotationDeceleration
double _viewOffsetDelta
double _pitchOffsetRate
double _pitchOffset
double _yawOffsetRate
double _yawOffset
double _t0
double _dt
osg::Vec3d _direction
osg::Vec3d _position
bool _shift
bool _ctrl
bool _decelerateOffsetRate
bool _straightenOffset

Detailed Description

A UFO manipulator driven with keybindings.

The UFOManipulator is better suited for applications that employ architectural walk-throughs, or situations where the eyepoint motion model must move slowly, deliberately and well controlled.

The UFO Manipulator allows the following movements with the listed Key combinations:

Parameters:
UpArrowAcceleration forward.
DownArrowAcceleration backward (or deceleration forward).
LeftArrowRotate view and direction of travel to the left.
RightArrowRotate view and direction of travel to the right.
SpaceBarBrake. Gradually decelerates linear and rotational movement.
Shift/UpArrowAccelerate up.
Shift/DownArrowAccelerate down.
Shift/LeftArrowAccelerate (linearly) left.
Shift/RightArrowAccelerate (linearly) right.
Shift/SpaceBarInstant brake. Immediately stop all linear and rotational movement.

When the Shift key is released, up, down, linear left and/or linear right movement is decelerated.

Parameters:
Ctrl/UpArrowRotate view (but not direction of travel) up.
Ctrl/DownArrowRotate view (but not direction of travel) down.
Ctrl/LeftArrowRotate view (but not direction of travel) left.
Ctrl/RightArrowRotate view (but not direction of travel) right.
Ctrl/ReturnStraightens out the view offset.

Constructor & Destructor Documentation

osgGA::UFOManipulator::UFOManipulator (  )

Default constructor

virtual osgGA::UFOManipulator::~UFOManipulator (  ) [protected, virtual]

Member Function Documentation

void osgGA::UFOManipulator::_adjustPosition (  ) [protected]
void osgGA::UFOManipulator::_frame ( const osgGA::GUIEventAdapter ea,
osgGA::GUIActionAdapter  
) [protected]
void osgGA::UFOManipulator::_keyDown ( const osgGA::GUIEventAdapter ea,
osgGA::GUIActionAdapter  
) [protected]
void osgGA::UFOManipulator::_keyUp ( const osgGA::GUIEventAdapter ea,
osgGA::GUIActionAdapter  
) [protected]
void osgGA::UFOManipulator::_stop (  ) [protected]
virtual const char* osgGA::UFOManipulator::className (  ) const [virtual]

return className

Returns:
returns constant "UFO"

Reimplemented from osgGA::MatrixManipulator.

virtual void osgGA::UFOManipulator::computeHomePosition (  ) [virtual]

Computes the home position based on the extents and scale of the scene graph rooted at node

Reimplemented from osgGA::MatrixManipulator.

void osgGA::UFOManipulator::getCurrentPositionAsLookAt ( osg::Vec3 eye,
osg::Vec3 center,
osg::Vec3 up 
)

Report the current position as LookAt vectors

double osgGA::UFOManipulator::getForwardSpeed (  ) const [inline]
virtual osg::Matrixd osgGA::UFOManipulator::getInverseMatrix (  ) const [virtual]

Get the current inverse view matrix

Implements osgGA::MatrixManipulator.

virtual osg::Matrixd osgGA::UFOManipulator::getMatrix (  ) const [virtual]

Get the current viewmatrix

Implements osgGA::MatrixManipulator.

double osgGA::UFOManipulator::getMinDistance (  ) const [inline]
double osgGA::UFOManipulator::getMinHeight (  ) const [inline]
virtual osg::Node* osgGA::UFOManipulator::getNode (  ) [virtual]

Get the root node of the subgraph this manipulator is driving the eye through

Reimplemented from osgGA::MatrixManipulator.

virtual const osg::Node* osgGA::UFOManipulator::getNode (  ) const [virtual]

Get the root node of the subgraph this manipulator is driving the eye through (const)

Reimplemented from osgGA::MatrixManipulator.

double osgGA::UFOManipulator::getRotationSpeed (  ) const [inline]
double osgGA::UFOManipulator::getSideSpeed (  ) const [inline]
void osgGA::UFOManipulator::getUsage ( osg::ApplicationUsage usage ) const [virtual]

Reports Usage parameters to the application

Reimplemented from osgGA::GUIEventHandler.

bool osgGA::UFOManipulator::handle ( const osgGA::GUIEventAdapter ea,
osgGA::GUIActionAdapter aa 
) [virtual]

Handles incoming osgGA events

Reimplemented from osgGA::MatrixManipulator.

virtual void osgGA::UFOManipulator::home ( const osgGA::GUIEventAdapter ,
osgGA::GUIActionAdapter  
) [virtual]

Sets the viewpoint matrix to the home position

Reimplemented from osgGA::MatrixManipulator.

void osgGA::UFOManipulator::home ( double   ) [virtual]

Move the camera to the default position. This version does not require GUIEventAdapter and GUIActionAdapter so may be called from somewhere other than a handle() method in GUIEventHandler. Application must be aware of implications.

Reimplemented from osgGA::MatrixManipulator.

virtual void osgGA::UFOManipulator::init ( const GUIEventAdapter ,
GUIActionAdapter  
) [virtual]

Start/restart the manipulator. FIXME: what does this actually mean? Provide examples.

Reimplemented from osgGA::MatrixManipulator.

bool osgGA::UFOManipulator::intersect ( const osg::Vec3d start,
const osg::Vec3d end,
osg::Vec3d intersection 
) const [protected]
virtual void osgGA::UFOManipulator::setByInverseMatrix ( const osg::Matrixd invmat ) [virtual]

Set the current position with the inverse matrix

Parameters:
invmatThe inverse of a viewpoint matrix

Implements osgGA::MatrixManipulator.

virtual void osgGA::UFOManipulator::setByMatrix ( const osg::Matrixd matrix ) [virtual]

Set the current position with a matrix

Parameters:
matrixA viewpoint matrix.

Implements osgGA::MatrixManipulator.

void osgGA::UFOManipulator::setForwardSpeed ( double  in_fs ) [inline]
void osgGA::UFOManipulator::setMinDistance ( double  in_min_dist ) [inline]
void osgGA::UFOManipulator::setMinHeight ( double  in_min_height ) [inline]
virtual void osgGA::UFOManipulator::setNode ( osg::Node node ) [virtual]

Set the subgraph this manipulator is driving the eye through.

Parameters:
noderoot of subgraph

Reimplemented from osgGA::MatrixManipulator.

void osgGA::UFOManipulator::setRotationSpeed ( double  in_rot_speed ) [inline]
void osgGA::UFOManipulator::setSideSpeed ( double  in_ss ) [inline]

Member Data Documentation

bool osgGA::UFOManipulator::_ctrl [protected]
double osgGA::UFOManipulator::_dt [protected]
double osgGA::UFOManipulator::_t0 [protected]
double osgGA::UFOManipulator::_upSpeed [protected]

The documentation for this class was generated from the following file: