VgSpatial Class Reference

Inheritance diagram for VgSpatial:

Public Member Functions
void	setAnimation (String pAnimationName, VgAnimationRefPtr pAnimation)
void	setAnimation (VgAnimationRefPtr pAnimation)
void	setLocalAnimation (VgAnimationRefPtr pAnimation)
VgAnimationConstRefPtr	getAnimation (String pName)
VgAnimationRefPtr	editAnimation (String pName)
void	getAnimationNames (VgStringList pNameList)
VgValue	getAnimationChannelValue (String pChannelName)
VgPosition	getPosition ()
void	setPosition (VgPosition pPosition, boolean pHaveGeographicCoherence)
void	setPosition (VgPosition pPosition)
VgOrientation	getOrientation ()
void	setOrientation (VgOrientation pOrientation)
float	getScale ()
void	setScale (float pScale)
int	getZIndex ()
void	setZIndex (int pZIndex)
boolean	isDrawnOnTop ()
void	setDrawOnTop (boolean pEnable)
void	setVisible (boolean pIsVisible)
boolean	isVisible ()
VgIGeometry	asGeometry ()
VgPoint	asPoint ()
VgLine	asLine ()
Public Member Functions inherited from VgReferenced
synchronized void	release ()
	VgReferenced ()
	VgReferenced (VgReferenced pThis)
void	ref ()
int	unref ()
int	getNbReferences ()

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

Member Function Documentation

VgIGeometry VgSpatial.asGeometry

(

)

Casts this instance into a VgIGeometry.

Version

2.0.9590

Returns

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

VgLine VgSpatial.asLine

(

)

Casts this instance into a VgLine.

Version

2.0.9590

Returns

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

VgPoint VgSpatial.asPoint

(

)

Casts this instance into a VgPoint.

Version

2.0.9590

Returns

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

VgAnimationRefPtr VgSpatial.editAnimation

(

String

pName

)

Edits an animation from the spatial's animation map.

Parameters

pName

The name of the animation to fetch.

Version

2.0.8744

Returns

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

VgAnimationConstRefPtr VgSpatial.getAnimation

(

String

pName

)

Gets an animation from the spatial's animation map.

Parameters

pName

The name of the animation to fetch.

Version

2.0.8744

Returns

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

VgValue VgSpatial.getAnimationChannelValue

(

String

pChannelName

)

Get the current value of a given animation channel.

Parameters

pChannelName

The name of the channel.

Version

2.1.19

Returns

The value stored in a VgValue object.

void VgSpatial.getAnimationNames

(

VgStringList

pNameList

)

Gets the list of the stored animation names.

Parameters

pNameList

The list of strings to feed with the names.

Version

2.0.8744

VgOrientation VgSpatial.getOrientation

(

)

Gets spatial's orientation.

Version

2.0.8744

Returns

The spatial's orientation.

VgPosition VgSpatial.getPosition

(

)

Gets spatial's position.

Version

2.0.7445

Returns

The spatial's position.

float VgSpatial.getScale

(

)

Version

2.0.9263

Returns

the spatial's scale.

int VgSpatial.getZIndex

(

)

Version

2.0.9263

2.1.0 Updated documentation with default value

Returns

Z index. default value is 0.

boolean VgSpatial.isDrawnOnTop

(

)

Version

2.0.9263

2.1.0 Updated documentation with default value

Returns

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

boolean VgSpatial.isVisible

(

)

Version

2.0.9334

Returns

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

void VgSpatial.setAnimation	(	String	pAnimationName,
		VgAnimationRefPtr	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

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

Version

2.0.8744

void VgSpatial.setAnimation

(

VgAnimationRefPtr

pAnimation

)

Sets an animation with an empty name on this spatial.

Deprecated:

Parameters

pAnimation

An animation to animate the spatial with.

Version

2.0.7445

void VgSpatial.setDrawOnTop

(

boolean

pEnable

)

Sets the drawOnTop flag. The VgSpatial will be visible even if there are objects in front.

Parameters

pEnable

Version

2.0.9263

void VgSpatial.setLocalAnimation

(

VgAnimationRefPtr

pAnimation

)

Sets an animation on this spatial.

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.

Parameters

pAnimation

An animation to animate the spatial with.

void VgSpatial.setOrientation

(

VgOrientation

pOrientation

)

Sets the spatial orientation.

Parameters

pOrientation

The orientation to set on the spatial.

Version

2.0.8744

void VgSpatial.setPosition	(	VgPosition	pPosition,
		boolean	pHaveGeographicCoherence
	)

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 VgSpatial.setPosition

(

VgPosition

pPosition

)

void VgSpatial.setScale

(

float

pScale

)

Sets the spatial's scale.

Parameters

pScale

The scale to set on the spatial.

Version

2.0.8744

void VgSpatial.setVisible

(

boolean

pIsVisible

)

Sets the visibility. By default, a VgSpatial is visible.

Parameters

pIsVisible

Version

2.0.9334

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

Parameters

pZIndex

Version

2.0.9263

2.1.2 Updated documentation

---

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

• VgSpatial.java