An articulated model manipulator for controlling an articulated model. More...

Inheritance diagram for makVrv::DtArticulatedModel:

Public Types
enum	AnimationState { START, STOP, PAUSE, RESUME }
typedef std::vector< int >	PartList

Public Member Functions
	DtArticulatedModel (DtDe &, DtUniqueID id)
	CTOR.
virtual	~DtArticulatedModel ()
	DTOR.
virtual void	setModelScalingEnabled (bool b)=0
	Indicate whether or not this model may be model-scaled Default is false.
virtual void	setModelDefinition (const std::string &def)=0
	Override the set model definition function.
virtual void	setLocalModelScalingEnabled (bool enabled)=0
	Indicates whether local model scaling for the model is enabled.
virtual void	setLocalModelScalingAmount (float localScl)=0
	Sets the amount of local scaling to apply to the model.
virtual std::string	className () const =0
	Get the class name of the model instance owner.
virtual bool	findPartPositionAndOrientation (int partNumber, DtVector &position, DtQuat &ori)=0
	Finds the absolute position and orientation of a part.

virtual void	setPartTranslation (int partNumber, const DtVector &transform, const DtVector &velocity)=0
	Update the part translation.
virtual void	setPartOrientation (int partNumber, const DtTaitBryan &orientation, const DtVector &rotationalVelocity)=0
	Rotate the part.
virtual void	setPartVisibility (int partNumber, bool onOff)=0
virtual void	setState (int stateNumber, int stateValue)=0
	Set the state on the model.
virtual void	setLightpointMaxDistance (float distance)=0
	Specify the maximum range at which lightpoints on this model will be visible.
virtual void	setAnimationFrame (const std::string &animationName, int frameIndex)=0
	Set the current frame of an animation.
virtual void	setAnimationRange (const std::string &animationName, int firstFrameIndex, int lastFrameIndex)=0
	Set the animation range.
virtual void	setAnimationSpeed (const std::string &animationName, double framesPerSecond)=0
	Set the animation speed.
virtual void	setAnimationState (const std::string &animationName, AnimationState mode)=0
virtual void	getParts (PartList &parts) const =0
	Get the part list.
virtual void	setUvOffset (const std::string &annotation, float uOffset, float vOffset)=0
	Groups using a texture atlas are identified using an annotation (ex.
virtual void	setDynamicSensorRegion (const std::string &region, bool state)=0
	Set the state of a dynamic sensor region.
virtual bool	dynamicSensorRegion (const std::string &region)=0
	Get the state of a dynamic sensor region.
virtual void	setLinkageConfigPair (const std::string &linkageName, const std::string &configName)=0
	Configure an entity according to a (linkageName, configName) pair.
Public Member Functions inherited from makVrv::DtModel
	DtModel (DtDe &de, DtUniqueID id)
	CTOR.
virtual	~DtModel ()
	DTOR.
virtual void	saveModelToFile (const std::string &filename)
unsigned int	transformSize () const
	Get the number of position/orientations this model has.
virtual void	setPosition (int vtx, const DtVector &position)
	Set the position of a control vertex in the model.
virtual void	removePosition (int vtx)
	Remove a transform at the given position.
const DtVector &	position (int vtx=0) const
	Get the Position of a given point.
const DtTaitBryan &	orientation (int vtx=0) const
	Get the Orientation of a given point.
virtual void	setOrientation (int vtx, const DtTaitBryan &orientation)
	Set the orientation of a vertex in the model.
virtual void	enableColorBlending (bool b)
	Enable / disable color blending for this model.
virtual void	setBlendColor (float r, float g, float b, float a)
	Set color to use if color blending is enabled.
virtual void	getBlendColor (float &r, float &g, float &b, float &a)
	Returns the blend color.
virtual bool	colorBlendingEnabled () const
	Returns whether or not blending is enabled.
virtual void	setColor (float r, float g, float b, float a)
	set the model's color
virtual void	enableLighting (bool l)
	set whether the model is lit; this may not be an option on all models
virtual int	modelSet () const
	Get the model set this model is part of.
const DtVector &	boundingBoxExtents () const
	Get the bounding box extents of the model instance.
void	getBoundingBoxExtents (double &x, double &y, double &z) const
	Get the bounding box extents of the model instance.
const DtVector &	boundingBoxCenter () const
	Get the bounding box center of the model instance.
virtual void	getBoundingBoxCenter (double &x, double &y, double &z) const
	Get the bounding box center of the model instance.
virtual void	getBoundingBoxComponents (DtVector &minimum, DtVector &maximum)
	Get the minimum and maximum X,Y,Z components of the bounding box.
void	setContributesToBound (bool trueOrFalse)
	Set whether this model instance contributes to an object's overall bounding volume.
bool	contributesToBound () const
	Get whether this model instance contributes to an object's overall bounding volume.
DtDe &	de ()
	Get the DtDe object.
virtual void	setModelInstance (DtModelInstance *modelInstance)
	Internally set the model instance pointer.
virtual void	setVisible (bool isVisible)
	Set the visible state of the model.
virtual bool	visible () const
	Get the visible state of the model.
DtUniqueID	parentSceneObjectID () const
	Parent of the model.
virtual void	addedToSceneObjectAsProp (const DtUniqueID &sceneObj)
	Called when a scene object added the model as a prop.
virtual void	addedToSceneObject (const DtUniqueID &sceneObj, int modelSet, int visualizerType)
	Called when a scene object added the model with the given model set and visualizer type.
virtual void	setElementId (DtUniqueID id)
	Called when the element ID of the model's parent object is set.
virtual void	removedFromSceneObject ()
	Called when the model was removed from a scene object.
virtual void	setIsSupportModel (bool isSupport)=0
	Is this model part of the support group? (determines whether or not other scene objects can ground clamp to this model)
virtual void	setSolid (bool isSolid)
	Set whether or not other this model is drawn filled in.
virtual bool	isProp ()
	Return whether or not this model was added as a prop.
virtual DtModelInstance *	modelInstance ()
	Get the model instance.
virtual const DtModelInstance *	modelInstance () const
int	visualizerType () const
	The visualizer type determines which channel-specific group node this model will be parented to, and consequently, which observer setting will cause it to be rendered in which channel.

Additional Inherited Members
Public Attributes inherited from makVrv::DtModel
boost::signal< void(DtModel *)>	signal_modelToBeDestroyed
	Signal emitted when the model is to be destroyed.
boost::signal< void(DtModel *)>	signal_modelChanged
boost::signal< bool(DtModel *, bool), SlotReturnOR >	signal_visibilityChangeRequested
	Signal when the visibility has been requested, if any slot returns false, it will not change.
boost::signal< void(DtModelInstance , DtModel )>	signal_modelInstanceCreated
	Signal emitted when the model instance is created.
boost::signal< void(DtModelInstance , DtModel )>	signal_modelInstanceToBeDestroyed
	Signal emitted when the model instance is to be destroyed.
Protected Types inherited from makVrv::DtModel
typedef std::vector < ObjectTransform >	TransformList
Protected Member Functions inherited from makVrv::DtModel
virtual void	addToScene (const DtUniqueID &sceneObjectId, int modelSet, int visualizerType)=0
	Virtual Functions to be implemented, add this model to the scene.
virtual void	addToSceneAsProp (const DtUniqueID &sceneObjectId)
	Add this model to the scene as a prop.
virtual void	removeFromScene ()=0
	Virtual Functions to be implemented, remove this model from the scene.
virtual void	initializeModelInstance ()
	Push any state maintained by the model to the model instance.
void	slot_modelInstanceChanged (DtModelInstance *instance)
	Called when the model instance changed.
Protected Attributes inherited from makVrv::DtModel
DtDe &	myDe
const DtUniqueID	myUniqueId
bool	myColorBlendingEnabled

Detailed Description

An articulated model manipulator for controlling an articulated model.

Member Typedef Documentation

typedef std::vector<int> makVrv::DtArticulatedModel::PartList

Member Enumeration Documentation

enum makVrv::DtArticulatedModel::AnimationState

Enumerator:

START
STOP
PAUSE
RESUME

Constructor & Destructor Documentation

makVrv::DtArticulatedModel::DtArticulatedModel	(	DtDe &	,
		DtUniqueID	id
	)

CTOR.

virtual makVrv::DtArticulatedModel::~DtArticulatedModel ( )

virtual

DTOR.

Member Function Documentation

virtual void makVrv::DtArticulatedModel::setModelScalingEnabled ( bool b )

pure virtual

Indicate whether or not this model may be model-scaled Default is false.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setModelDefinition ( const std::string & def )

pure virtual

Override the set model definition function.

Use this to parse a model after it is loaded.

Reimplemented from makVrv::DtModel.

Implemented in makVrv::DtOsgArticulatedModel, and makVrf::DtVrfOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setLocalModelScalingEnabled ( bool enabled )

pure virtual

Indicates whether local model scaling for the model is enabled.

Local model scaling overrides generic (global) model scaling. Default is false.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setLocalModelScalingAmount ( float localScl )

pure virtual

Sets the amount of local scaling to apply to the model.

Only applies when local model scaling is enabled.

Implemented in makVrv::DtOsgArticulatedModel.

virtual std::string makVrv::DtArticulatedModel::className ( ) const

pure virtual

Get the class name of the model instance owner.

This is used to control how model instances are created.

Reimplemented from makVrv::DtModel.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setPartTranslation	(	int	partNumber,
		const DtVector &	transform,
		const DtVector &	velocity
	)

pure virtual

Update the part translation.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setPartOrientation	(	int	partNumber,
		const DtTaitBryan &	orientation,
		const DtVector &	rotationalVelocity
	)

pure virtual

Rotate the part.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setPartVisibility	(	int	partNumber,
		bool	onOff
	)

pure virtual

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setState	(	int	stateNumber,
		int	stateValue
	)

pure virtual

Set the state on the model.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setLightpointMaxDistance ( float distance )

pure virtual

Specify the maximum range at which lightpoints on this model will be visible.

This sets ALL lightpoints to the same range.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setAnimationFrame	(	const std::string &	animationName,
		int	frameIndex
	)

pure virtual

Set the current frame of an animation.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setAnimationRange	(	const std::string &	animationName,
		int	firstFrameIndex,
		int	lastFrameIndex
	)

pure virtual

Set the animation range.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setAnimationSpeed	(	const std::string &	animationName,
		double	framesPerSecond
	)

pure virtual

Set the animation speed.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setAnimationState	(	const std::string &	animationName,
		AnimationState	mode
	)

pure virtual

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::getParts ( PartList & parts ) const

pure virtual

Get the part list.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setUvOffset	(	const std::string &	annotation,
		float	uOffset,
		float	vOffset
	)

pure virtual

Groups using a texture atlas are identified using an annotation (ex.

annotation label_char_1). setUvOffset is used to set the offset into the atlas texture for the group indicated by the annotation.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setDynamicSensorRegion	(	const std::string &	region,
		bool	state
	)

pure virtual

Set the state of a dynamic sensor region.

Implemented in makVrv::DtOsgArticulatedModel.

virtual bool makVrv::DtArticulatedModel::dynamicSensorRegion ( const std::string & region )

pure virtual

Get the state of a dynamic sensor region.

Implemented in makVrv::DtOsgArticulatedModel.

virtual void makVrv::DtArticulatedModel::setLinkageConfigPair	(	const std::string &	linkageName,
		const std::string &	configName
	)

pure virtual

Configure an entity according to a (linkageName, configName) pair.

Additional entity state may be configured via a metafile referenced by the DtModelDefinition. The linkageName is the name of the linkage within the metafile, either the NodeName or the Annotation. The configName is how the linkage of the entity is to be configured using data a from the configName mappings of the FeatureData for the linkage according to the FeatureName tag.

Implemented in makVrv::DtOsgArticulatedModel.

virtual bool makVrv::DtArticulatedModel::findPartPositionAndOrientation	(	int	partNumber,
		DtVector &	position,
		DtQuat &	ori
	)

pure virtual

Finds the absolute position and orientation of a part.

This function is more efficient than calling both the position and orientation functions.

Implemented in makVrv::DtOsgArticulatedModel.

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

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

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation