class OSGGA_EXPORT osgGA::MatrixManipulator

Inheritance:

Public Classes

class CoordinateFrameCallback: public osg::Referenced

callback class to use to allow matrix manipulators to querry the application for the local coordinate frame

Public Methods

virtual const char* className() const

virtual void setMinimumDistance(float minimumDistance)

set the minimum distance (as ratio) the eye point can be zoomed in towards the center before the center is pushed forward

float getMinimumDistance() const

get the minimum distance (as ratio) the eye point can be zoomed in

virtual void setCoordinateFrameCallback(CoordinateFrameCallback* cb)

set the coordinate frame which callback tells the manipulator which way is up, east and north

CoordinateFrameCallback* getCoordinateFrameCallback()

get the coordinate frame callback which tells the manipulator which way is up, east and north

const CoordinateFrameCallback* getCoordinateFrameCallback() const

get the coordinate frame callback which tells the manipulator which way is up, east and north

osg::CoordinateFrame getCoordinateFrame(const osg::Vec3d& position) const

get the coordinate frame

osg::Vec3d getSideVector(const osg::CoordinateFrame& cf) const

osg::Vec3d getFrontVector(const osg::CoordinateFrame& cf) const

osg::Vec3d getUpVector(const osg::CoordinateFrame& cf) const

virtual void setByMatrix(const osg::Matrixd& matrix)

set the position of the matrix manipulator using a 4x4 Matrix

virtual void setByInverseMatrix(const osg::Matrixd& matrix)

set the position of the matrix manipulator using a 4x4 Matrix

virtual osg::Matrixd getMatrix() const

get the position of the manipulator as 4x4 Matrix

virtual osg::Matrixd getInverseMatrix() const

get the position of the manipulator as a inverse matrix of the manipulator, typically used as a model view matrix

virtual osgUtil::SceneView::FusionDistanceMode getFusionDistanceMode() const

Get the FusionDistanceMode.

virtual float getFusionDistanceValue() const

Get the FusionDistanceValue.

virtual void setNode(osg::Node*)

Attach a node to the manipulator, automatically detaching any previously attached node.

virtual const osg::Node* getNode() const

Return const node if attached

virtual osg::Node* getNode()

Return node if attached

virtual void setHomePosition(const osg::Vec3d& eye, const osg::Vec3d& center, const osg::Vec3d& up)

virtual void getHomePosition(osg::Vec3d& eye, osg::Vec3d& center, osg::Vec3d& up)

virtual void setAutoComputeHomePosition(bool flag)

bool getAutoComputeHomePosition() const

virtual void computeHomePosition()

virtual void home(const GUIEventAdapter&, GUIActionAdapter&)

Move the camera to the default position.

virtual void init(const GUIEventAdapter&, GUIActionAdapter&)

Start/restart the manipulator.

virtual bool handle(const GUIEventAdapter& ea, GUIActionAdapter& us)

Handle events, return true if handled, false otherwise.

virtual void accept(GUIEventHandlerVisitor& v)

Handle visitations

Protected Fields

double _minimumDistance

bool _autoComputeHomePosition

osg::Vec3d _homeEye

osg::Vec3d _homeCenter

osg::Vec3d _homeUp

osg::ref_ptr<CoordinateFrameCallback> _coordinateFrameCallback

Protected Methods

MatrixManipulator()

virtual ~MatrixManipulator()

Inherited from GUIEventHandler:

Public Methods

META_Object (osgGA, GUIEventHandler) const () const

virtual CompositeGUIEventHandler* getComposite()

virtual void getUsage(osg::ApplicationUsage&) const

Documentation

MatrixManipulator is an abstract base class defining the interface, and a certain amount of default functionality, for classes which wish to control OSG cameras in response to GUI events.

virtual const char* className() const

virtual void setMinimumDistance(float minimumDistance)

set the minimum distance (as ratio) the eye point can be zoomed in towards the center before the center is pushed forward

float getMinimumDistance() const

get the minimum distance (as ratio) the eye point can be zoomed in

virtual void setCoordinateFrameCallback(CoordinateFrameCallback* cb)

set the coordinate frame which callback tells the manipulator which way is up, east and north

CoordinateFrameCallback* getCoordinateFrameCallback()

get the coordinate frame callback which tells the manipulator which way is up, east and north

const CoordinateFrameCallback* getCoordinateFrameCallback() const

get the coordinate frame callback which tells the manipulator which way is up, east and north

osg::CoordinateFrame getCoordinateFrame(const osg::Vec3d& position) const

get the coordinate frame

osg::Vec3d getSideVector(const osg::CoordinateFrame& cf) const

osg::Vec3d getFrontVector(const osg::CoordinateFrame& cf) const

osg::Vec3d getUpVector(const osg::CoordinateFrame& cf) const

virtual void setByMatrix(const osg::Matrixd& matrix)

set the position of the matrix manipulator using a 4x4 Matrix

virtual void setByInverseMatrix(const osg::Matrixd& matrix)

set the position of the matrix manipulator using a 4x4 Matrix

virtual osg::Matrixd getMatrix() const

get the position of the manipulator as 4x4 Matrix

virtual osg::Matrixd getInverseMatrix() const

get the position of the manipulator as a inverse matrix of the manipulator, typically used as a model view matrix

virtual osgUtil::SceneView::FusionDistanceMode getFusionDistanceMode() const

Get the FusionDistanceMode. Used by SceneView for setting up setereo convergence.

virtual float getFusionDistanceValue() const

Get the FusionDistanceValue. Used by SceneView for setting up setereo convergence.

virtual void setNode(osg::Node*)

Attach a node to the manipulator, automatically detaching any previously attached node. setNode(NULL) detaches previous nodes. May be ignored by manipulators which do not require a reference model.

virtual const osg::Node* getNode() const

Return const node if attached

virtual osg::Node* getNode()

Return node if attached

virtual void setHomePosition(const osg::Vec3d& eye, const osg::Vec3d& center, const osg::Vec3d& up)

virtual void getHomePosition(osg::Vec3d& eye, osg::Vec3d& center, osg::Vec3d& up)

virtual void setAutoComputeHomePosition(bool flag)

bool getAutoComputeHomePosition() const

virtual void computeHomePosition()

virtual void home(const GUIEventAdapter&, GUIActionAdapter&)

Move the camera to the default position. May be ignored by manipulators if home functionality is not appropriate.

virtual void init(const GUIEventAdapter&, GUIActionAdapter&)

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

virtual bool handle(const GUIEventAdapter& ea, GUIActionAdapter& us)

Handle events, return true if handled, false otherwise.

virtual void accept(GUIEventHandlerVisitor& v)

Handle visitations

MatrixManipulator()

virtual ~MatrixManipulator()

double _minimumDistance

bool _autoComputeHomePosition

osg::Vec3d _homeEye

osg::Vec3d _homeCenter

osg::Vec3d _homeUp

osg::ref_ptr<CoordinateFrameCallback> _coordinateFrameCallback

Direct child classes:

TrackerManipulator
TrackballManipulator
TerrainManipulator
KeySwitchMatrixManipulator
HoverManipulator
FlightManipulator
DriveManipulator
AnimationPathManipulator

Alphabetic index HTML hierarchy of classes or Java