This class gives access to the spatial aspect of an object (layer, point, etc). More...

Inheritance diagram for VgEngine::VgSpatial:

Public Member Functions
void	setAnimation (const std::string &pAnimationName, VgEngine::VgRefPtr< VgEngine::VgAnimation > &pAnimation)
	Sets an animation on this spatial. More...

void	setAnimation (VgEngine::VgRefPtr< VgEngine::VgAnimation > pAnimation)
	Sets an animation with an empty name on this spatial. More...

void	setLocalAnimation (VgEngine::VgRefPtr< VgEngine::VgAnimation > pAnimation)
	Sets an animation on this spatial. More...

VgConstRefPtr< VgAnimation >	getAnimation (const std::string &pName) const
	Gets an animation from the spatial's animation map. More...

VgRefPtr< VgAnimation >	editAnimation (const std::string &pName)
	Edits an animation from the spatial's animation map. More...

void	getAnimationNames (std::list< std::string > &pNameList) const
	Gets the list of the stored animation names. More...

VgEngine::VgPosition	getPosition () const
	Gets spatial's position. More...

virtual void	setPosition (const VgEngine::VgPosition &pPosition, bool pHaveGeographicCoherence=true)
	Sets the spatial position. More...

VgEngine::VgOrientation	getOrientation () const
	Gets spatial's orientation. More...

void	setOrientation (const VgEngine::VgOrientation &pOrientation)
	Sets the spatial orientation. More...

float	getScale () const

void	setScale (float pScale)
	Sets the spatial's scale. More...

int	getZIndex () const

void	setZIndex (int pZIndex)
	Sets the Z Index, an object with a smaller ZIndex will be drawn in front of another with a larger one. More...

bool	isDrawnOnTop () const

void	setDrawOnTop (bool pEnable)
	Sets the drawOnTop flag. More...

virtual void	setVisible (bool pIsVisible)
	Sets the visibility. More...

virtual bool	isVisible () const

virtual Vg3DModule::VgIGeometry *	asGeometry ()
	Casts this instance into a VgIGeometry. More...

virtual Vg3DModule::VgPoint *	asPoint ()
	Casts this instance into a VgPoint. More...

virtual Vg3DModule::VgLine *	asLine ()
	Casts this instance into a VgLine. More...

Public Member Functions inherited from VgEngine::VgReferenced
	VgReferenced ()
	Constructor. More...

	VgReferenced (const VgReferenced &pThis)
	Copy constructor. More...

virtual	~VgReferenced ()
	Destructor. More...

VgReferenced &	operator= (const VgReferenced &pThis)
	Assignment operator. More...

void	ref () const
	This method is used to add a reference to this object. More...

int	unref () const
	This method is used to remove a reference to this object. More...

int	getNbReferences () const
	Retrieves the number of references to this object. More...

Protected Member Functions
	VgSpatial ()
	Default constructor. More...

virtual	~VgSpatial ()
	Destructor. More...

Protected Attributes
Private *	mPrivate
	Private. More...

Protected Attributes inherited from VgEngine::VgReferenced
int	mNbReferences
	The number of references to this object. More...

Friends
class	VgObjectBridge

class	VgLayer

Detailed Description

This class gives access to the spatial aspect of an object (layer, point, etc).

The spatial aspect controls the object's position in scene space. It also enables animation features on spatial objects.

Version: 2.0

Constructor & Destructor Documentation

VgEngine::VgSpatial::VgSpatial ( )

protected

Default constructor.

This is protected since it is not possible to create a spatial directly. Instead, instantiate a spatial object (like point for example) and access it's spatial aspect.

virtual VgEngine::VgSpatial::~VgSpatial ( )

protectedvirtual

Destructor.

Member Function Documentation

virtual Vg3DModule::VgIGeometry* VgEngine::VgSpatial::asGeometry ( )

virtual

Casts this instance into a VgIGeometry.

Returns: A valid pointer if this instance as the correct type, NULL otherwise.

Version: 2.0.9590

Reimplemented in Vg3DModule::VgIGeometry.

virtual Vg3DModule::VgLine* VgEngine::VgSpatial::asLine ( )

virtual

Casts this instance into a VgLine.

Returns: A valid pointer if this instance as the correct type, NULL otherwise.

Version: 2.0.9590

Reimplemented in Vg3DModule::VgPoint, Vg3DModule::VgLine, and Vg3DModule::VgIGeometry.

virtual Vg3DModule::VgPoint* VgEngine::VgSpatial::asPoint ( )

virtual

Casts this instance into a VgPoint.

Returns: A valid pointer if this instance as the correct type, NULL otherwise.

Version: 2.0.9590

Reimplemented in Vg3DModule::VgPoint, Vg3DModule::VgLine, and Vg3DModule::VgIGeometry.

VgRefPtr< VgAnimation > VgEngine::VgSpatial::editAnimation ( const std::string & pName )

Edits an animation from the spatial's animation map.

Parameters

pName The name of the animation to fetch.

Returns: A reference pointer that is valid if an animation exists by that name in this spatial.

Version: 2.0.8744

VgConstRefPtr< VgAnimation > VgEngine::VgSpatial::getAnimation ( const std::string & pName ) const

Gets an animation from the spatial's animation map.

Parameters

pName The name of the animation to fetch.

Returns: A const reference pointer that is valid if an animation exists by that name in this spatial.

Version: 2.0.8744

void VgEngine::VgSpatial::getAnimationNames ( std::list< std::string > & pNameList ) const

Gets the list of the stored animation names.

Parameters

pNameList The list of strings to feed with the names.

Version: 2.0.8744

VgEngine::VgOrientation VgEngine::VgSpatial::getOrientation ( ) const

Gets spatial's orientation.

Returns: The spatial's orientation.

Version: 2.0.8744

VgEngine::VgPosition VgEngine::VgSpatial::getPosition ( ) const

Gets spatial's position.

Returns: The spatial's position.

Version: 2.0.7445

float VgEngine::VgSpatial::getScale ( ) const

Returns: the spatial's scale.

Version: 2.0.9263

int VgEngine::VgSpatial::getZIndex ( ) const

Returns: Z index. default value is 0.

Version: 2.0.9263; 2.1.0 Updated documentation with default value

bool VgEngine::VgSpatial::isDrawnOnTop ( ) const

Returns: True if the current spatial is drawn on top. Default value is false.

Version: 2.0.9263; 2.1.0 Updated documentation with default value

virtual bool VgEngine::VgSpatial::isVisible ( ) const

virtual

Returns: True if visible. By default, a VgSpatial is visible.

Version: 2.0.9334

Reimplemented in VgEngine::VgLayer.

void VgEngine::VgSpatial::setAnimation	(	const std::string &	pAnimationName,
		VgEngine::VgRefPtr< VgEngine::VgAnimation > &	pAnimation
	)

Sets an animation on this spatial.

As of version 2.0.8744, multiple animations can be set (and played) on a spatial at the same time. This is the reason why a name has to be provided along with the animation. If an animation already exists in the spatial with that name, the new one will replace the old one (and the previous one will one less reference to it).

Parameters

pAnimation	An animation to animate the spatial with.
pAnimationName	The name to associate the animation with in this spatial

Version: 2.0.8744

void VgEngine::VgSpatial::setAnimation ( VgEngine::VgRefPtr< VgEngine::VgAnimation > pAnimation )

Sets an animation with an empty name on this spatial.

Parameters

pAnimation An animation to animate the spatial with.

Deprecated:

Version: 2.0.7445

void VgEngine::VgSpatial::setDrawOnTop ( bool pEnable )

Sets the drawOnTop flag.

The VgSpatial will be visible even if there are objects in front.

Version: 2.0.9263

void VgEngine::VgSpatial::setLocalAnimation ( VgEngine::VgRefPtr< VgEngine::VgAnimation > pAnimation )

Sets an animation on this spatial.

Parameters

pAnimation An animation to animate the spatial with.

Deprecated:

Warning: This method is kept for compatibility concerns. It will set all of the animation's channels to address the local animation node. The animation will be named "local". YOUR ANIMATION MAY BE MODIFIED BY THIS CALL.

void VgEngine::VgSpatial::setOrientation ( const VgEngine::VgOrientation & pOrientation )

Sets the spatial orientation.

Parameters

pOrientation The orientation to set on the spatial.

Version: 2.0.8744

virtual void VgEngine::VgSpatial::setPosition	(	const VgEngine::VgPosition &	pPosition,
		bool	pHaveGeographicCoherence = `true`
	)

virtual

Sets the spatial position.

Parameters

pPosition	The position to put the spatial at.
pHaveGeographicCoherence	An optional parameter who by default is true. Is used to determine the geographic coherence of the spatial. If set to false, then the spatial will be coherent with the scene.

Version: 2.0.7445

void VgEngine::VgSpatial::setScale ( float pScale )

Sets the spatial's scale.

Parameters

pScale The scale to set on the spatial.

Version: 2.0.8744

virtual void VgEngine::VgSpatial::setVisible ( bool pIsVisible )

virtual

Sets the visibility.

By default, a VgSpatial is visible.

Version: 2.0.9334

Reimplemented in VgEngine::VgLayer.

void VgEngine::VgSpatial::setZIndex ( int pZIndex )

Sets the Z Index, an object with a smaller ZIndex will be drawn in front of another with a larger one.

Version: 2.0.9263; 2.1.2 Updated documentation

Friends And Related Function Documentation

friend class VgLayer

friend

friend class VgObjectBridge

friend

Member Data Documentation

Private* VgEngine::VgSpatial::mPrivate

protected

Private.

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

VgSpatial.h

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation