WildMagic.LibGraphics.Detail

Class BillboardNode

java.lang.Object

WildMagic.LibGraphics.ObjectSystem.GraphicsObject

WildMagic.LibGraphics.SceneGraph.Spatial

WildMagic.LibGraphics.SceneGraph.Node

WildMagic.LibGraphics.Detail.BillboardNode

All Implemented Interfaces:

Serializable, NameIdInterface, StreamInterface

public class BillboardNode
extends Node
implements NameIdInterface, StreamInterface

The model space of the billboard has an up vector of (0,1,0) that is chosen to be the billboard's axis of rotation.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class WildMagic.LibGraphics.SceneGraph.Spatial

Spatial.CullingMode

Field Summary

Fields

Modifier and Type	Field and Description
protected Matrix3f	m_kRotate
protected Camera	m_spkCamera Camera to which the billboard is aligned
private static long	serialVersionUID

Fields inherited from class WildMagic.LibGraphics.SceneGraph.Node

m_kChild

Fields inherited from class WildMagic.LibGraphics.SceneGraph.Spatial

Culling, Local, m_iStartEffect, m_kEffects, m_kGlobalStates, m_kLights, m_pkParent, World, WorldBound, WorldBoundIsCurrent, WorldIsCurrent

Constructor Summary

Constructors

Constructor and Description
BillboardNode() Default constructor, uninitialized
BillboardNode(Camera pkCamera) Construction and destruction.

Method Summary

Methods

Modifier and Type	Method and Description
void	AlignTo(Camera pkCamera) the camera to which the billboard is aligned
void	dispose() delete memory
void	GetAllObjectsByName(String rkName, Vector<GraphicsObject> rkObjects) Writes all GraphicsObjects with the name that matches the input parameter, rkName into the Vector parameter rkObjects.
int	GetDiskUsed(StreamVersion rkVersion) Returns the size of this object and it's children on disk for the current StreamVersion parameter.
GraphicsObject	GetObjectByID(int uiID) Returns the GraphicsObject with the ID that matches the input parameter, uiID.
GraphicsObject	GetObjectByName(String rkName) Returns the GraphicsObject with the name that matches the input parameter, rkName.
void	Link(Stream rkStream, Stream.Link pkLink) Copies this objects children objects from the input Stream's HashTable, based on the LinkID of the child stored in the pkLink parameter.
void	Load(Stream rkStream, Stream.Link pkLink) Loads this object from the input parameter rkStream, using the input Stream.Link to store the IDs of children objects of this object for linking after all objects are loaded from the Stream.
boolean	Register(Stream rkStream) Registers this object with the input Stream parameter.
void	Save(Stream rkStream) Write this object and all it's children to the Stream.
StringTree	SaveStrings(String acTitle) Write this object into a StringTree for the scene-graph visualization.
void	SetLocalRotate(Matrix3f kRotate)
protected void	UpdateWorldData(double dAppTime) geometric updates

Methods inherited from class WildMagic.LibGraphics.SceneGraph.Node

AttachChild, DetachAllChildren, DetachChild, DetachChildAt, GetChild, GetQuantity, GetVisibleSet, SetChild, UpdateState, UpdateWorldBound

Methods inherited from class WildMagic.LibGraphics.SceneGraph.Spatial

AttachEffect, AttachGlobalState, AttachLight, DetachAllEffects, DetachAllGlobalStates, DetachAllLights, DetachEffect, DetachGlobalState, DetachLight, GetEffect, GetEffectQuantity, GetGlobalState, GetGlobalState, GetGlobalStateQuantity, GetLight, GetLightQuantity, GetParent, GetStartEffect, OnGetVisibleSet, PopState, PropagateBoundToRoot, PropagateStateFromRoot, PushState, SetParent, SetStartEffect, UpdateBS, UpdateGS, UpdateGS, UpdateRS, UpdateRS

Methods inherited from class WildMagic.LibGraphics.ObjectSystem.GraphicsObject

GetID, GetName, GetNextID, GetObjectByIDBase, GetObjectByNameBase, SetName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

m_spkCamera

protected Camera m_spkCamera

Camera to which the billboard is aligned

m_kRotate

protected Matrix3f m_kRotate

Constructor Detail

BillboardNode

public BillboardNode(Camera pkCamera)

Construction and destruction.

Parameters:

pkCamera - to which the billboard is aligned

BillboardNode

public BillboardNode()

Default constructor, uninitialized

Method Detail

dispose

public void dispose()

delete memory

Overrides:

dispose in class Node

AlignTo

public void AlignTo(Camera pkCamera)

the camera to which the billboard is aligned

Parameters:

pkCamera - to which the billboard is aligned

UpdateWorldData

protected void UpdateWorldData(double dAppTime)

geometric updates

Overrides:

UpdateWorldData in class Node

Parameters:

dAppTime - animation time for updating any controllers associated with this object

GetObjectByName

public GraphicsObject GetObjectByName(String rkName)

Returns the GraphicsObject with the name that matches the input parameter, rkName.

Specified by:

GetObjectByName in interface NameIdInterface

Overrides:

GetObjectByName in class Node

Parameters:

rkName - the name of the object to return.

Returns:

the GraphicsObject that matches the input name.

GetAllObjectsByName

public void GetAllObjectsByName(String rkName,
                       Vector<GraphicsObject> rkObjects)

Writes all GraphicsObjects with the name that matches the input parameter, rkName into the Vector parameter rkObjects.

Specified by:

GetAllObjectsByName in interface NameIdInterface

Overrides:

GetAllObjectsByName in class Node

Parameters:

rkName - the name of the objects to return.

rkObjects - a Vector of all objects with the matching name.

GetObjectByID

public GraphicsObject GetObjectByID(int uiID)

Returns the GraphicsObject with the ID that matches the input parameter, uiID.

Specified by:

GetObjectByID in interface NameIdInterface

Overrides:

GetObjectByID in class Node

Parameters:

uiID - the ID of the object to return.

Returns:

the GraphicsObject that matches the input name.

Load

public void Load(Stream rkStream,
        Stream.Link pkLink)

Loads this object from the input parameter rkStream, using the input Stream.Link to store the IDs of children objects of this object for linking after all objects are loaded from the Stream.

Specified by:

Load in interface StreamInterface

Overrides:

Load in class Node

Parameters:

rkStream - the Stream from which this object is being read.

pkLink - the Link class for storing the IDs of this object's children objects.

Link

public void Link(Stream rkStream,
        Stream.Link pkLink)

Copies this objects children objects from the input Stream's HashTable, based on the LinkID of the child stored in the pkLink parameter.

Specified by:

Link in interface StreamInterface

Overrides:

Link in class Node

Parameters:

rkStream - the Stream where the child objects are stored.

pkLink - the Link class from which the child object IDs are read.

Register

public boolean Register(Stream rkStream)

Registers this object with the input Stream parameter. All objects streamed to disk are registered with the Stream so that a unique list of objects is maintained.

Specified by:

Register in interface StreamInterface

Overrides:

Register in class Node

Parameters:

rkStream - the Stream where the child objects are stored.

Returns:

true if this object is registered, false if the object has already been registered.

Save

public void Save(Stream rkStream)

Write this object and all it's children to the Stream.

Specified by:

Save in interface StreamInterface

Overrides:

Save in class Node

Parameters:

rkStream - the Stream where the child objects are stored.

GetDiskUsed

public int GetDiskUsed(StreamVersion rkVersion)

Returns the size of this object and it's children on disk for the current StreamVersion parameter.

Specified by:

GetDiskUsed in interface StreamInterface

Overrides:

GetDiskUsed in class Node

Parameters:

rkVersion - the current version of the Stream file being created.

Returns:

the size of this object on disk.

SaveStrings

public StringTree SaveStrings(String acTitle)

Write this object into a StringTree for the scene-graph visualization.

Specified by:

SaveStrings in interface StreamInterface

Overrides:

SaveStrings in class Node

Parameters:

acTitle - the header for this object in the StringTree.

Returns:

StringTree containing a String-based representation of this object and it's children.

SetLocalRotate

public void SetLocalRotate(Matrix3f kRotate)