org.j3d.aviatrix3d
Class TransformGroup

java.lang.Object
  org.j3d.aviatrix3d.SceneGraphObject
      org.j3d.aviatrix3d.Node
          org.j3d.aviatrix3d.Group
              org.j3d.aviatrix3d.TransformGroup

All Implemented Interfaces:

GroupPickTarget, PickableObject, PickTarget, TransformPickTarget, Cullable, GroupCullable, TransformCullable, TransformHierarchy

public class TransformGroup
extends Group
implements TransformPickTarget, TransformCullable

A grouping node that contains a transform. The node contains a single transformation that can position, scale and rotate all its children. The specified transformation must be Affine and have uniform scaling components(SRT-transform). This class will not check this constraint, so expect odd results if you break this rule, up to and including a possible core reactor meltdown in a foreign country.

Version:

$Revision: 1.32 $

Author:

Alan Hudson

Field Summary

Fields inherited from class org.j3d.aviatrix3d.Group

childList, cullList, dirtyBoundsCount, lastChild, pickableList, pickFlags, wkVec1, wkVec2

Fields inherited from class org.j3d.aviatrix3d.Node

bounds, implicitBounds, INVALID_BOUNDS, parent

Fields inherited from class org.j3d.aviatrix3d.SceneGraphObject

alive, LISTENER_SET_TIMING_ERR_PROP, updateHandler

Fields inherited from interface org.j3d.aviatrix3d.picking.PickTarget

CUSTOM_PICK_TYPE, GROUP_PICK_TYPE, LEAF_PICK_TYPE, SINGLE_PICK_TYPE

Fields inherited from interface org.j3d.aviatrix3d.picking.PickableObject

COLLIDABLE_OBJECT, GENERAL_OBJECT, PROXIMITY_OBJECT, VISIBLE_OBJECT

Constructor Summary

TransformGroup()
The default constructor

TransformGroup(javax.vecmath.Matrix4f trans)
Construct a TransformGroup given a matrix.

Method Summary

void	getInverseTransform(javax.vecmath.Matrix4f mat) Get the inverse version of the local transform.
void	getTransform(javax.vecmath.Matrix4d mat) Get the current local transformation value.
void	getTransform(javax.vecmath.Matrix4f mat) Get the current local transformation value.
protected void	recomputeBounds() Internal method to recalculate the implicit bounds of this Node.
void	setTransform(javax.vecmath.Matrix4f trans) Set the transform matrix for this class.

Methods inherited from class org.j3d.aviatrix3d.Group

addChild, checkForCyclicChild, checkPickMask, getAllChildren, getChild, getCullableChildren, getCullableParent, getPickableBounds, getPickableChild, getPickableChildren, getPickMask, getPickTargetType, hasMultipleParents, indexOfChild, markBoundsDirty, numChildren, numCullableChildren, numPickableChildren, pickBatch, pickSingle, removeAllChildren, removeChild, removeChild, requestBoundsUpdate, setBounds, setChild, setLive, setPickMask, setUpdateHandler, updateBounds

Methods inherited from class org.j3d.aviatrix3d.Node

boundsChanged, checkForCyclicParent, getBounds, getParent, removeParent, setParent, updateParentBounds

Methods inherited from class org.j3d.aviatrix3d.SceneGraphObject

dataChanged, getAppUpdateWriteTimingMessage, getBoundsWriteTimingMessage, getDataWriteTimingMessage, getUserData, isLive, setUserData

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.j3d.aviatrix3d.picking.PickTarget

checkPickMask, getPickableBounds, getPickTargetType

Methods inherited from interface org.j3d.aviatrix3d.rendering.GroupCullable

getBounds

Constructor Detail

TransformGroup

public TransformGroup()

The default constructor

TransformGroup

public TransformGroup(javax.vecmath.Matrix4f trans)

Construct a TransformGroup given a matrix.

Parameters:

trans - The matrix to use for transformation

Method Detail

getTransform

public void getTransform(javax.vecmath.Matrix4f mat)

Get the current local transformation value.

Specified by:

getTransform in interface TransformPickTarget

Specified by:

getTransform in interface TransformCullable

Parameters:

mat - The matrix to copy the transform data to

recomputeBounds

protected void recomputeBounds()

Internal method to recalculate the implicit bounds of this Node. Overrides the group version to take into account the transform stack applied to each child.

Overrides:

recomputeBounds in class Group

getInverseTransform

public void getInverseTransform(javax.vecmath.Matrix4f mat)

Get the inverse version of the local transform. The default implementation does nothing.

Specified by:

getInverseTransform in interface TransformPickTarget

Parameters:

mat - The matrix to copy the transform data to

setTransform

public void setTransform(javax.vecmath.Matrix4f trans)
                  throws InvalidWriteTimingException

Set the transform matrix for this class.

Parameters:

trans - The matrix. Copy by value semantics.

Throws:

InvalidWriteTimingException - An attempt was made to write outside of the NodeUpdateListener data changed callback method

getTransform

public void getTransform(javax.vecmath.Matrix4d mat)

Get the current local transformation value.

Parameters:

mat - The matrix to copy the transform data to