Inheritance diagram for osgGA::CameraManipulator:

Classes
class	CoordinateFrameCallback

Public Member Functions
virtual const char *	className () const

virtual void	setCoordinateFrameCallback (CoordinateFrameCallback *cb)

CoordinateFrameCallback *	getCoordinateFrameCallback ()

const CoordinateFrameCallback *	getCoordinateFrameCallback () const

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

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)=0

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

virtual osg::Matrixd	getMatrix () const =0

virtual osg::Matrixd	getInverseMatrix () const =0

virtual void	updateCamera (osg::Camera &camera)

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

virtual float	getFusionDistanceValue () const

void	setIntersectTraversalMask (unsigned int mask)

unsigned int	getIntersectTraversalMask () const

virtual void	setNode (osg::Node *)

virtual const osg::Node *	getNode () const

virtual osg::Node *	getNode ()

virtual void	setHomePosition (const osg::Vec3d &eye, const osg::Vec3d &center, const osg::Vec3d &up, bool autoComputeHomePosition=false)

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

virtual void	setAutoComputeHomePosition (bool flag)

bool	getAutoComputeHomePosition () const

virtual void	computeHomePosition (const osg::Camera *camera=NULL, bool useBoundingBox=false)

virtual void	home (const GUIEventAdapter &, GUIActionAdapter &)

virtual void	home (double)

virtual void	init (const GUIEventAdapter &, GUIActionAdapter &)

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

Public Member Functions inherited from osgGA::GUIEventHandler
	GUIEventHandler ()

	GUIEventHandler (const GUIEventHandler &eh, const osg::CopyOp &copyop)

	META_Object (osgGA, GUIEventHandler)

virtual void	operator() (osg::Node node, osg::NodeVisitor nv)

virtual void	event (osg::NodeVisitor nv, osg::Drawable drawable)

virtual bool	handle (const GUIEventAdapter &ea, GUIActionAdapter &aa, osg::Object , osg::NodeVisitor )

bool	handleWithCheckAgainstIgnoreHandledEventsMask (const GUIEventAdapter &ea, GUIActionAdapter &aa, osg::Object object, osg::NodeVisitor nv)

bool	handleWithCheckAgainstIgnoreHandledEventsMask (const GUIEventAdapter &ea, GUIActionAdapter &aa)

virtual void	getUsage (osg::ApplicationUsage &) const

void	setIgnoreHandledEventsMask (unsigned int mask)

unsigned int	getIgnoreHandledEventsMask () const

Public Member Functions inherited from osg::NodeCallback
	NodeCallback ()

	NodeCallback (const NodeCallback &nc, const CopyOp &)

	META_Object (osg, NodeCallback)

void	traverse (Node node, NodeVisitor nv)

void	setNestedCallback (NodeCallback *nc)

NodeCallback *	getNestedCallback ()

const NodeCallback *	getNestedCallback () const

void	addNestedCallback (NodeCallback *nc)

void	removeNestedCallback (NodeCallback *nc)

Public Member Functions inherited from osg::Object
	Object ()

	Object (bool threadSafeRefUnref)

	Object (const Object &, const CopyOp &copyop=CopyOp::SHALLOW_COPY)

virtual Object *	cloneType () const =0

virtual Object *	clone (const CopyOp &) const =0

virtual bool	isSameKindAs (const Object *) const

virtual const char *	libraryName () const =0

virtual void	setThreadSafeRefUnref (bool threadSafe)

virtual void	setName (const std::string &name)

void	setName (const char *name)

const std::string &	getName () const

void	setDataVariance (DataVariance dv)

DataVariance	getDataVariance () const

virtual void	computeDataVariance ()

void	setUserDataContainer (osg::UserDataContainer *udc)

osg::UserDataContainer *	getUserDataContainer ()

const osg::UserDataContainer *	getUserDataContainer () const

osg::UserDataContainer *	getOrCreateUserDataContainer ()

virtual void	setUserData (Referenced *obj)

virtual Referenced *	getUserData ()

virtual const Referenced *	getUserData () const

template<typename T >
bool	getUserValue (const std::string &name, T &value) const

template<typename T >
void	setUserValue (const std::string &name, const T &value)

virtual void	resizeGLObjectBuffers (unsigned int)

virtual void	releaseGLObjects (osg::State *=0) const

template<typename T >
BoolValueObject UCharValueObject UShortValueObject UIntValueObject DoubleValueObject Vec3fValueObject Vec2dValueObject Vec4dValueObject PlaneValueObject MatrixdValueObject bool	getUserValue (const std::string &name, T &value) const

Public Member Functions inherited from osg::Referenced
	Referenced ()

	Referenced (bool threadSafeRefUnref)

	Referenced (const Referenced &)

Referenced &	operator= (const Referenced &)

bool	getThreadSafeRefUnref () const

OpenThreads::Mutex *	getRefMutex () const

int	ref () const

int	unref () const

int	unref_nodelete () const

int	referenceCount () const

ObserverSet *	getObserverSet () const

ObserverSet *	getOrCreateObserverSet () const

void	addObserver (Observer *observer) const

void	removeObserver (Observer *observer) const

Public Member Functions inherited from osg::Drawable::EventCallback
	EventCallback ()

	EventCallback (const EventCallback &, const CopyOp &)

	META_Object (osg, EventCallback)

Protected Member Functions
	CameraManipulator ()

	CameraManipulator (const CameraManipulator &mm, const osg::CopyOp &copyOp=osg::CopyOp::SHALLOW_COPY)

virtual	~CameraManipulator ()

std::string	getManipulatorName () const

Protected Member Functions inherited from osg::NodeCallback
virtual	~NodeCallback ()

Protected Member Functions inherited from osg::Object
virtual	~Object ()

Protected Member Functions inherited from osg::Referenced
virtual	~Referenced ()

void	signalObserversAndDelete (bool signalDelete, bool doDelete) const

void	deleteUsingDeleteHandler () const

Protected Attributes
unsigned int	_intersectTraversalMask

bool	_autoComputeHomePosition

osg::Vec3d	_homeEye

osg::Vec3d	_homeCenter

osg::Vec3d	_homeUp

osg::ref_ptr < CoordinateFrameCallback >	_coordinateFrameCallback

Protected Attributes inherited from osgGA::GUIEventHandler
unsigned int	_ignoreHandledEventsMask

Protected Attributes inherited from osg::Object
std::string	_name

DataVariance	_dataVariance

osg::UserDataContainer *	_userDataContainer

Protected Attributes inherited from osg::Referenced
OpenThreads::AtomicPtr	_observerSet

OpenThreads::Atomic	_refCount

Additional Inherited Members
Public Types inherited from osg::Object
enum	DataVariance { DYNAMIC, STATIC, UNSPECIFIED }

Static Public Member Functions inherited from osg::Referenced
static OpenThreads::Mutex *	getGlobalReferencedMutex ()

static void	setThreadSafeReferenceCounting (bool enableThreadSafeReferenceCounting)

static bool	getThreadSafeReferenceCounting ()

static void	setDeleteHandler (DeleteHandler *handler)

static DeleteHandler *	getDeleteHandler ()

Public Attributes inherited from osg::NodeCallback
ref_ptr< NodeCallback >	_nestedCallback

Detailed Description

CameraManipulator 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.

Constructor & Destructor Documentation

osgGA::CameraManipulator::CameraManipulator ( )

protected

osgGA::CameraManipulator::CameraManipulator	(	const CameraManipulator &	mm,
		const osg::CopyOp &	copyOp = `osg::CopyOp::SHALLOW_COPY`
	)

protected

virtual osgGA::CameraManipulator::~CameraManipulator ( )

protectedvirtual

Member Function Documentation

virtual const char* osgGA::CameraManipulator::className ( ) const

inlinevirtual

return the name of the object's class type. Must be defined by derived classes.

Implements osg::Object.

Reimplemented in osgGA::UFOManipulator, osgGA::StandardManipulator, osgGA::AnimationPathManipulator, osgGA::KeySwitchMatrixManipulator, osgGA::DriveManipulator, osgGA::SphericalManipulator, and osgGA::CameraViewSwitchManipulator.

virtual void osgGA::CameraManipulator::computeHomePosition	(	const osg::Camera *	camera = `NULL`,
		bool	useBoundingBox = `false`
	)

virtual

Compute the home position.

bool osgGA::CameraManipulator::getAutoComputeHomePosition ( ) const

inline

Get whether the automatic compute of the home position is enabled.

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

inline

get the coordinate frame.

CoordinateFrameCallback* osgGA::CameraManipulator::getCoordinateFrameCallback ( )

inline

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

const CoordinateFrameCallback* osgGA::CameraManipulator::getCoordinateFrameCallback ( ) const

inline

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

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

inline

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

inlinevirtual

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

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::OrbitManipulator, and osgGA::SphericalManipulator.

References osgUtil::SceneView::PROPORTIONAL_TO_SCREEN_DISTANCE.

virtual float osgGA::CameraManipulator::getFusionDistanceValue ( ) const

inlinevirtual

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

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::OrbitManipulator, and osgGA::SphericalManipulator.

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

inlinevirtual

Get the manually set home position.

unsigned int osgGA::CameraManipulator::getIntersectTraversalMask ( ) const

inline

Get the mask to use when set up intersection traversal such as used in manipulators that follow terrain or have collision detection.

virtual osg::Matrixd osgGA::CameraManipulator::getInverseMatrix ( ) const

pure virtual

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

Implemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::NodeTrackerManipulator, osgGA::AnimationPathManipulator, osgGA::DriveManipulator, osgGA::OrbitManipulator, osgGA::FirstPersonManipulator, osgGA::SphericalManipulator, and osgGA::CameraViewSwitchManipulator.

std::string osgGA::CameraManipulator::getManipulatorName ( ) const

protected

virtual osg::Matrixd osgGA::CameraManipulator::getMatrix ( ) const

pure virtual

get the position of the manipulator as 4x4 Matrix.

Implemented in osgGA::KeySwitchMatrixManipulator, osgGA::NodeTrackerManipulator, osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::OrbitManipulator, osgGA::DriveManipulator, osgGA::FirstPersonManipulator, osgGA::SphericalManipulator, and osgGA::CameraViewSwitchManipulator.

virtual const osg::Node* osgGA::CameraManipulator::getNode ( ) const

inlinevirtual

Return const node if attached.

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, osgGA::DriveManipulator, and osgGA::CameraViewSwitchManipulator.

References NULL.

virtual osg::Node* osgGA::CameraManipulator::getNode ( )

inlinevirtual

Return node if attached.

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, osgGA::CameraViewSwitchManipulator, and osgGA::DriveManipulator.

References NULL.

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

inline

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

inline

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

virtual

Handle events, return true if handled, false otherwise.

Reimplemented from osgGA::GUIEventHandler.

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, osgGA::DriveManipulator, osgGA::CameraViewSwitchManipulator, and osgGA::MultiTouchTrackballManipulator.

virtual void osgGA::CameraManipulator::home	(	const GUIEventAdapter &	,
		GUIActionAdapter &
	)

inlinevirtual

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

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, osgGA::FirstPersonManipulator, osgGA::DriveManipulator, and osgGA::FlightManipulator.

virtual void osgGA::CameraManipulator::home ( double )

inlinevirtual

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 in osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, and osgGA::FirstPersonManipulator.

virtual void osgGA::CameraManipulator::init	(	const GUIEventAdapter &	,
		GUIActionAdapter &
	)

inlinevirtual

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

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, osgGA::FirstPersonManipulator, osgGA::DriveManipulator, osgGA::CameraViewSwitchManipulator, and osgGA::FlightManipulator.

virtual void osgGA::CameraManipulator::setAutoComputeHomePosition ( bool flag )

inlinevirtual

Set whether the automatic compute of the home position is enabled.

Reimplemented in osgGA::KeySwitchMatrixManipulator.

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

pure virtual

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

Implemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::OrbitManipulator, osgGA::FirstPersonManipulator, osgGA::DriveManipulator, osgGA::SphericalManipulator, and osgGA::CameraViewSwitchManipulator.

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

pure virtual

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

Implemented in osgGA::KeySwitchMatrixManipulator, osgGA::NodeTrackerManipulator, osgGA::UFOManipulator, osgGA::AnimationPathManipulator, osgGA::TerrainManipulator, osgGA::OrbitManipulator, osgGA::FirstPersonManipulator, osgGA::DriveManipulator, osgGA::SphericalManipulator, and osgGA::CameraViewSwitchManipulator.

virtual void osgGA::CameraManipulator::setCoordinateFrameCallback ( CoordinateFrameCallback * cb )

inlinevirtual

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

Reimplemented in osgGA::KeySwitchMatrixManipulator.

virtual void osgGA::CameraManipulator::setHomePosition	(	const osg::Vec3d &	eye,
		const osg::Vec3d &	center,
		const osg::Vec3d &	up,
		bool	autoComputeHomePosition = `false`
	)

inlinevirtual

Manually set the home position, and set the automatic compute of home position.

Reimplemented in osgGA::KeySwitchMatrixManipulator.

void osgGA::CameraManipulator::setIntersectTraversalMask ( unsigned int mask )

inline

Set the mask to use when set up intersection traversal such as used in manipulators that follow terrain or have collision detection. The intersection traversal mask is useful for controlling what parts of the scene graph should be used for intersection purposes.

virtual void osgGA::CameraManipulator::setNode ( osg::Node * )

inlinevirtual

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.

Reimplemented in osgGA::KeySwitchMatrixManipulator, osgGA::UFOManipulator, osgGA::NodeTrackerManipulator, osgGA::StandardManipulator, osgGA::SphericalManipulator, osgGA::DriveManipulator, osgGA::TerrainManipulator, and osgGA::CameraViewSwitchManipulator.

virtual void osgGA::CameraManipulator::updateCamera ( osg::Camera & camera )

inlinevirtual

update the camera for the current frame, typically called by the viewer classes. Default implementation simply set the camera view matrix.

References osg::Camera::setViewMatrix().

Member Data Documentation

bool osgGA::CameraManipulator::_autoComputeHomePosition

protected

osg::ref_ptr<CoordinateFrameCallback> osgGA::CameraManipulator::_coordinateFrameCallback

protected

osg::Vec3d osgGA::CameraManipulator::_homeCenter

protected

osg::Vec3d osgGA::CameraManipulator::_homeEye

protected

osg::Vec3d osgGA::CameraManipulator::_homeUp

protected

unsigned int osgGA::CameraManipulator::_intersectTraversalMask

protected

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

CameraManipulator

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation