makVrv::DtMultiPointSceneObjectUpdater Class Reference

Multi Point Scene Object Updater.

DtMultiPointSceneObjectUpdater is a distributed object managed by DtTickableManager. It provides an API and infrastructure used by deriving objects to update the positions of multi point scene objects in render space. DtMultiPointSceneObjectUpdaters may be chained together in a list to perform multiple position and/or orientation transformations. For example, one updater might dead reckon position and orientation based on kinematic info, the next in the chain could ground clamp the object. A third might adjust the ground clamped position to support terrain scaling.

Inheritance diagram for makVrv::DtMultiPointSceneObjectUpdater:

Public Member Functions
	DtMultiPointSceneObjectUpdater (DtDe &de, DtUniqueID id)
virtual	~DtMultiPointSceneObjectUpdater ()
virtual void	update (DtTime tNow)
virtual void	setInputPositions (const std::vector< DtVector > &positions)
virtual void	setOutputPositions (const std::vector< DtVector > &positions)
virtual void	setInputOrientations (const std::vector< DtTaitBryan > &orientations)
virtual void	setOutputOrientations (const std::vector< DtTaitBryan > &orientations)
Public Member Functions inherited from makVrv::DtSceneObjectUpdater
	DtSceneObjectUpdater (DtDe &de, DtUniqueID id)
virtual	~DtSceneObjectUpdater ()
virtual void	setNextUpdater (DtSceneObjectUpdater *nextUpdater)
virtual void	setPrevUpdater (DtSceneObjectUpdater *prevUpdater)
virtual bool	needsUpdate (DtTime tNow)
virtual void	updateAdaptiveTickrate (const DtVector &lastPos, const DtTime &deltaTime)
virtual void	setVertexToUpdate (unsigned int vertex)
virtual void	setInputPosition (const DtVector &position)
virtual void	setInputOrientation (const DtTaitBryan &orientation)
virtual void	setOutputPosition (const DtVector &position)
virtual DtVector	outputPosition () const
virtual void	setOutputOrientation (const DtTaitBryan &orientation)
virtual DtTaitBryan	outputOrientation () const
virtual void	setOutputPositionAndOrientation (const DtVector &position, const DtTaitBryan &orientation)
virtual DtTime	lastUpdateTime () const
virtual void	setSceneObject (DtSceneObject *sceneObject, bool addToTickableMgrIfHead)
virtual void	setSceneObject (DtSceneObject *sceneObject)
DtUniqueID	uniqueId () const
DtSceneObjectUpdater *	findNextUpdater () const
DtSceneObjectUpdater *	findPrevUpdater () const
virtual bool	isChainThreadSafe (DtSceneObjectUpdater *firstUpdater)
virtual DtSceneObjectUpdater *	chainHead ()
virtual void	setIsThreadSafe (bool safe)
virtual void	setTickableEnabled (bool enabled) override
virtual void	setAdaptiveTickLodEnabled (bool enabled)
virtual bool	adaptiveTickLodEnabled () const override
virtual void	setLodScaleSpeedFactor (float factor)
virtual float	lodScaleSpeedFactor () const
virtual void	setLodRadiusStart (float ratius)
virtual float	lodRadiusStart () const
virtual void	setLodRadiusEnd (float ratius)
virtual float	lodRadiusEnd () const
virtual void	setNearLodUpdateRate (int nearRate)
virtual int	nearLodUpdateRate () const
virtual void	setFarLodUpdateRate (int maxRate)
virtual int	farLodUpdateRate () const
DtSceneObject *	findActiveSceneObject ()
DtSceneObject *const	findActiveSceneObject () const
DtSceneObject *	findSceneObjectForModelSet (DtModelSetId modelSet)
DtSceneObject *const	findSceneObjectForModelSet (DtModelSetId modelSet) const
virtual void	addSceneObjectToUpdate (DtModelSetId modelSet, DtSceneObject *sceneObject, bool addToTickableMgrIfHead=true)
virtual void	removeSceneObjectToUpdate (DtModelSetId modelSet, DtSceneObject *sceneObject)
virtual void	addSceneObjectToUpdateAtChainEnd (DtModelSetId modelSet, DtSceneObject *sceneObject, bool addToTickableMgrIfHead=true)
virtual void	removeSceneObjectToUpdateAtChainEnd (DtModelSetId modelSet, DtSceneObject *sceneObject)
Public Member Functions inherited from makVrv::DtTickable
virtual bool	updateIfNeeded (DtTime tNow)
virtual	~DtTickable ()
virtual bool	isThreadSafe () const
virtual void	setTickableListState (TickableListState safeList)
virtual TickableListState	tickableListState () const
virtual void	setUpdatePeriod (unsigned int period)
virtual unsigned int	updatePeriod () const

Protected Attributes
std::vector< DtVector >	myInputPositions
std::vector< DtTaitBryan >	myInputOrientations
Protected Attributes inherited from makVrv::DtSceneObjectUpdater
DtDe &	myDe
DtUniqueID	myUniqueId
DtModelSetId	myModelSet
boost::signalslib::connection	mySceneObjectConnection
DtSceneObjectUpdater *	myNextUpdater
DtSceneObjectUpdater *	myPrevUpdater
unsigned int	myVertexToUpdate
DtVector	myLastPositionForAdaptiveTickRate
DtVector	myInputPosition
DtTaitBryan	myInputOrientation
DtVector	myLastOutputPosition
DtTaitBryan	myLastOutputOrientation
bool	myPositionDataOutputted
bool	myOrientationDataOutputted
ModelSetToSceneObjectMap	mySceneObjectMap
SceneObjectConnectionsMap	mySceneObjectConnectionsMap
AdaptiveTickRateLODParams	myAdaptiveTickRateLODParams
Protected Attributes inherited from makVrv::DtTickable
DtTickableManagerInterface *	myManager
DtSignalConnectionManager	myConnections
unsigned int	myFrameCounter
unsigned int	myFrameToUpdate
unsigned int	myUpdatePeriod
unsigned int	myTickableIndex
DtTime	myLastUpdateTime
bool	myIsThreadSafe
TickableListState	myTickableListState

Additional Inherited Members
Public Types inherited from makVrv::DtTickable
enum	TickableListState { TickableNotOnList, TickableOnMainList, TickableOnThreadSafeList }
Public Attributes inherited from makVrv::DtSceneObjectUpdater
boost::signalslib::signal < void(const DtUniqueID &) >	signal_updaterToBeDeleted
Protected Types inherited from makVrv::DtSceneObjectUpdater
using	ModelSetToSceneObjectMap = std::map< DtModelSetId, DtSceneObject * >
using	SceneObjectConnectionsMap = std::unordered_map< DtUniqueID, boost::signalslib::connection >
Protected Member Functions inherited from makVrv::DtSceneObjectUpdater
virtual void	removeThreadSafeChainFromManager (DtSceneObjectUpdater *head)
virtual void	removeUnThreadSafeChainFromManager (DtSceneObjectUpdater *head)
virtual void	addThreadSafeChainToManager (DtSceneObjectUpdater *head)
virtual void	addUnThreadSafeChainToManager (DtSceneObjectUpdater *head)
virtual void	placeChainOnCorrectTickableList (DtSceneObjectUpdater *head)
virtual void	slot_sceneObjectToBeDeleted (const DtUniqueID &id)
Protected Member Functions inherited from makVrv::DtTickable
	DtTickable (DtTickableManagerInterface *manager)
	DtTickable ()=delete
virtual void	slot_managerAboutToBeDeleted ()

Constructor & Destructor Documentation

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

CTOR.

Parameters

[in]	de	is the display engine.
[in]	id	is a unique identifier for this distributed object.

virtual makVrv::DtMultiPointSceneObjectUpdater::~DtMultiPointSceneObjectUpdater ( )

virtual

Virtual DTOR.

Member Function Documentation

virtual void makVrv::DtMultiPointSceneObjectUpdater::update ( DtTime  tNow )

virtual

The update function called by DtTickableManager during update-ticks.

Parameters

[in]

tNow

is the current time-stamp.

Note

All classes deriving from DtMultiPointSceneObjectUpdater must call DtMultiPointSceneObjectUpdater::update() AFTER their own update completes for chaining (and pass-thru) to work correctly.

Reimplemented from makVrv::DtSceneObjectUpdater.

Reimplemented in makVrv::DtMultiPointEmbarkationUpdater.

virtual void makVrv::DtMultiPointSceneObjectUpdater::setInputPositions ( const std::vector< DtVector > &  positions )

virtual

Set the positions input to this updater.

Parameters

[in]

positions

is the position to use.

virtual void makVrv::DtMultiPointSceneObjectUpdater::setOutputPositions ( const std::vector< DtVector > &  positions )

virtual

Output the resultant positions. If there is a next updater, this will call that updater's setInputPositions with the result. Otherwise the result will be provided to the specified scene object.

Parameters

[in]

position

is the position to set.

virtual void makVrv::DtMultiPointSceneObjectUpdater::setInputOrientations ( const std::vector< DtTaitBryan > &  orientations )

virtual

Set the orientations input to this updater.

Parameters

[in]

orientations

is the orientation to use.

virtual void makVrv::DtMultiPointSceneObjectUpdater::setOutputOrientations ( const std::vector< DtTaitBryan > &  orientations )

virtual

Output the resultant orientations. If there is a next updater, this will call that updater's setInputOrientations with the result. Otherwise the result will be provided to the specified scene object.

Parameters

[in]

orientations

is the orientation to set.

Member Data Documentation

std::vector<DtVector> makVrv::DtMultiPointSceneObjectUpdater::myInputPositions

protected

Input positions.

std::vector<DtTaitBryan> makVrv::DtMultiPointSceneObjectUpdater::myInputOrientations

protected

---

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

• /data/exports/nrhent7-1/nightly/docs/vrForces.vrf5-2-branch/include/vrvCore/DtMultiPointSceneObjectUpdater.h