makVrv::DtEllipseUpdater Class Reference

DtEllipseUpdater is an updater that updates the orientation of ellipse (2D or 3D) based on the origin and first point in the model. More...

Inheritance diagram for makVrv::DtEllipseUpdater:

Public Member Functions
	DtEllipseUpdater (makVrv::DtDe &de, makVrv::DtUniqueID id)
	CTOR.
virtual	~DtEllipseUpdater ()
	DTOR.
virtual void	update (double simTime)
	If origin or to point have changed, recalc orientation.
virtual void	setOrientationDelta (double)
virtual void	setClamped (bool)
	Sets to clamp. Will recalculate orientations and clamp position on next update.
virtual void	setPosition (int, const DtVector &)
	Sets positions of ellipse.
virtual void	setSceneObject (DtSceneObject *sceneObject)
	Set the scene object to be updated.
virtual bool	needsUpdate (DtTime tNow)
	The check function called by DtTickableManager to verify if an update is required.
virtual void	setUpdaterPosition (int vtx, const DtVector &pos)
	Set the position of a vertex.
virtual void	setUpdaterOrientation (int vtx, const DtTaitBryan &ori)
	Set the orientation of a vertex.
virtual void	setDynamicOrigin (bool)
	Sets whether or origin is set in the updater or retrieved from the scene object.
Public Member Functions inherited from makVrv::DtTickable
virtual void	update (DtTime tNow)=0
	The update function called by DtTickableManager during update-ticks.
virtual	~DtTickable ()
	Virtual DTOR.
virtual void	setUpdatePeriod (unsigned int period)
	Specify how often (in # of frames) this tickable should call update.
virtual unsigned int	updatePeriod () const

Protected Member Functions
virtual bool	computeGroundClampingHit (const DtVector &up, const DtVector &unclampedPosition, DtVector &hitLocation, DtVector &hitNormal)
virtual DtTaitBryan	computeOrientation (const DtVector &pos, double topoHeading) const
	Computes orientation of the ellipse as level to terrain.
Signals
virtual void	slot_sceneObjectToBeDeleted (const DtUniqueID &id)
Protected Member Functions inherited from makVrv::DtTickable
	DtTickable (DtTickableManagerInterface *manager)
	CTOR.
	DtTickable ()
	Unimplemented default CTOR.
virtual void	slot_managerAboutToBeDeleted ()

Protected Attributes
DtVector	myOrigin
DtVector	myClampedOrigin
double	myOrientationDelta
bool	mySceneObjectChanged
bool	myClamped
DtDe &	myDe
	The display engine.
DtUniqueID	myUniqueId
	This distributed object's unique identifier.
DtSceneObject *	mySceneObject
	A pointer to the current scene object.
DtSceneObject::TransformList	myTransforms
	Local copy of the vertex positions and orientations.
DtTime	myLastUpdateTime
DtTaitBryan	myInitialOrientation
bool	myDynamicOrigin
DtVector	myLastAnglePosition
DtVector	myDynamicOriginPosition
Protected Attributes inherited from makVrv::DtTickable
DtTickableManagerInterface *	myManager
	Pointer to manager for removal during destruction.
DtSignalConnectionManager	myConnections
unsigned int	myFrameCounter
unsigned int	myFrameToUpdate
unsigned int	myUpdatePeriod

Private Member Functions
DtSceneObject::ObjectTransform &	getOrCreateTransform (int vtx)
	Helper function to get the transform at a given vertex.

Detailed Description

DtEllipseUpdater is an updater that updates the orientation of ellipse (2D or 3D) based on the origin and first point in the model.

Constructor & Destructor Documentation

makVrv::DtEllipseUpdater::DtEllipseUpdater	(	makVrv::DtDe &	de,
		makVrv::DtUniqueID	id
	)

CTOR.

virtual makVrv::DtEllipseUpdater::~DtEllipseUpdater ( )

virtual

DTOR.

Member Function Documentation

virtual void makVrv::DtEllipseUpdater::update ( double  simTime )

virtual

If origin or to point have changed, recalc orientation.

virtual void makVrv::DtEllipseUpdater::setOrientationDelta ( double  )

virtual

virtual void makVrv::DtEllipseUpdater::setClamped ( bool  )

virtual

Sets to clamp. Will recalculate orientations and clamp position on next update.

virtual void makVrv::DtEllipseUpdater::setPosition ( int  , const DtVector &    )

virtual

Sets positions of ellipse.

Will update orientation and radii appropriately. Vector is considered in local coordinates

virtual void makVrv::DtEllipseUpdater::setSceneObject ( DtSceneObject *  sceneObject )

virtual

Set the scene object to be updated.

Parameters

[in]

sceneObject

is the scene object to receive updates.

virtual bool makVrv::DtEllipseUpdater::needsUpdate ( DtTime  tNow )

virtual

The check function called by DtTickableManager to verify if an update is required.

If this function returns true, the DtTickableManager will then call update().

Parameters

[in]

tNow

is the current time-stamp.

Return values

true	if this object needs to be ticked.
false	otherwise.

Reimplemented from makVrv::DtTickable.

virtual void makVrv::DtEllipseUpdater::setUpdaterPosition ( int  vtx, const DtVector &  pos  )

virtual

Set the position of a vertex.

Parameters

[in]	vtx	is the vertex.
[in]	pos	is the position to set.

virtual void makVrv::DtEllipseUpdater::setUpdaterOrientation ( int  vtx, const DtTaitBryan &  ori  )

virtual

Set the orientation of a vertex.

Parameters

[in]	vtx	is the vertex.
[in]	ori	is the orientation to set.

virtual void makVrv::DtEllipseUpdater::setDynamicOrigin ( bool  )

virtual

Sets whether or origin is set in the updater or retrieved from the scene object.

Default is false (retrieved from origin)

virtual bool makVrv::DtEllipseUpdater::computeGroundClampingHit ( const DtVector &  up, const DtVector &  unclampedPosition, DtVector &  hitLocation, DtVector &  hitNormal  )

protectedvirtual

virtual DtTaitBryan makVrv::DtEllipseUpdater::computeOrientation ( const DtVector &  pos, double  topoHeading  ) const

protectedvirtual

Computes orientation of the ellipse as level to terrain.

virtual void makVrv::DtEllipseUpdater::slot_sceneObjectToBeDeleted ( const DtUniqueID &  id )

protectedvirtual

DtSceneObject::ObjectTransform& makVrv::DtEllipseUpdater::getOrCreateTransform ( int  vtx )

private

Helper function to get the transform at a given vertex.

If the vertex is above range, new transforms are created.

Parameters

[in]

vtx

is the vertex of the transform to get.

Returns

The transform at the given vertex.

Exceptions

DtCorruptedState

if vtx is less than zero.

Member Data Documentation

DtVector makVrv::DtEllipseUpdater::myOrigin

protected

DtVector makVrv::DtEllipseUpdater::myClampedOrigin

protected

double makVrv::DtEllipseUpdater::myOrientationDelta

protected

bool makVrv::DtEllipseUpdater::mySceneObjectChanged

protected

bool makVrv::DtEllipseUpdater::myClamped

protected

DtDe& makVrv::DtEllipseUpdater::myDe

protected

The display engine.

DtUniqueID makVrv::DtEllipseUpdater::myUniqueId

protected

This distributed object's unique identifier.

DtSceneObject* makVrv::DtEllipseUpdater::mySceneObject

protected

A pointer to the current scene object.

DtSceneObject::TransformList makVrv::DtEllipseUpdater::myTransforms

protected

Local copy of the vertex positions and orientations.

These are typically pre-calculated, and then pushed to the scene object at a later time, making the concatenation of updaters simpler.

DtTime makVrv::DtEllipseUpdater::myLastUpdateTime

protected

DtTaitBryan makVrv::DtEllipseUpdater::myInitialOrientation

protected

bool makVrv::DtEllipseUpdater::myDynamicOrigin

protected

DtVector makVrv::DtEllipseUpdater::myLastAnglePosition

protected

DtVector makVrv::DtEllipseUpdater::myDynamicOriginPosition

protected

---

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

• /exports/nfedora7-1/nightly/docs/vrforcesDevelopment.tot/include/vrvCore/DtEllipseUpdater.h