All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.media.j3d.Shape3D

java.lang.Object
   |
   +----java.media.j3d.SceneGraphObject
           |
           +----java.media.j3d.Node
                   |
                   +----java.media.j3d.Leaf
                           |
                           +----java.media.j3d.Shape3D

public class Shape3D

extends Leaf

ALLOW_APPEARANCE_READ

Specifies that the node allows read access to its appearance information.

ALLOW_APPEARANCE_WRITE

Specifies that the node allows write access to its appearance information.

ALLOW_COLLISION_BOUNDS_READ

Specifies that the node allows reading its collision Bounds

ALLOW_COLLISION_BOUNDS_WRITE

Specifies the node allows writing its collision Bounds

ALLOW_GEOMETRY_READ

Specifies that the node allows read access to its geometry information.

ALLOW_GEOMETRY_WRITE

Specifies that the node allows write access to its geometry information.

ALLOW_SQUASH_READ

Specifies that the node allows read access to its squash information.

ALLOW_SQUASH_WRITE

Specifies that the node allows write access to its squash information.

Shape3D()

Constructs and initializes a Shape3D object with null geometry and default appearance.

Shape3D(Geometry)

Constructs and initializes a Shape3D object with the default appearance.

Shape3D(Geometry, Appearance)

Constructs and initializes a Shape3D object.

cloneNode(boolean)

Used to create a new instance of the node.

duplicateNode(Node, boolean)

Copies all node information from originalNode into the current node.

getAppearance()

Retrieves the appearance component of this shape node.

getCollisionBounds()

Returns the collision bounding object of this node.

getGeometry()

Retrieves the geometry component of this Shape3D node.

getSquash()

Retrieves the squash component of this shape node.

setAppearance(Appearance)

Sets the appearance component of this Shape3D node.

setCollisionBounds(Bounds)

Sets the collision bounds of a node.

setGeometry(Geometry)

Sets the geometry component of the Shape3D node.

setSquash(Squash)

Sets the squash component of this Shape3D node.

 public static final int ALLOW_GEOMETRY_READ

Specifies that the node allows read access to its geometry information.

 public static final int ALLOW_GEOMETRY_WRITE

Specifies that the node allows write access to its geometry information.

 public static final int ALLOW_APPEARANCE_READ

Specifies that the node allows read access to its appearance information.

 public static final int ALLOW_APPEARANCE_WRITE

Specifies that the node allows write access to its appearance information.

 public static final int ALLOW_SQUASH_READ

Specifies that the node allows read access to its squash information.

 public static final int ALLOW_SQUASH_WRITE

Specifies that the node allows write access to its squash information.

 public static final int ALLOW_COLLISION_BOUNDS_READ

Specifies that the node allows reading its collision Bounds

 public static final int ALLOW_COLLISION_BOUNDS_WRITE

Specifies the node allows writing its collision Bounds

 public Shape3D()

Constructs and initializes a Shape3D object with null geometry and default appearance.

 public Shape3D(Geometry geometry)

Constructs and initializes a Shape3D object with the default appearance.

Parameters:

geometry - the geometry component of the shape

 public Shape3D(Geometry geometry,
                Appearance appearance)

Constructs and initializes a Shape3D object.

Parameters:

geometry - the geometry component of the shape

appearance - the appearance component of the shape

 public final void setCollisionBounds(Bounds bounds)

Sets the collision bounds of a node.

Parameters:

bounds - the collision bounding object for a node

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final Bounds getCollisionBounds()

Returns the collision bounding object of this node.

Returns:

the node's collision bounding object

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final void setGeometry(Geometry geometry)

Sets the geometry component of the Shape3D node.

Parameters:

geometry - the new geometry component for the shape node

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final Geometry getGeometry()

Retrieves the geometry component of this Shape3D node.

Returns:

the geometry component of this shape node

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final void setAppearance(Appearance appearance)

Sets the appearance component of this Shape3D node.

Parameters:

appearance - the new appearance component for this shape node

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final Appearance getAppearance()

Retrieves the appearance component of this shape node.

Returns:

the appearance component of this shape node

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final void setSquash(Squash squash)

Sets the squash component of this Shape3D node.

Parameters:

squash - the squash component applied to the geometry referenced by this shape node. This is used to stretch or squash an object (e.g., to turn a sphere into an ellipsoid. If squash is null then no scaling is applied to the geometry.

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public final Squash getSquash()

Retrieves the squash component of this shape node.

Returns:

the squash component of this shape node

Throws: CapabilityNotSetException

if appropriate capability is not set and this object is part of live or compiled scene graph

 public Node cloneNode(boolean forceDuplicate)

Used to create a new instance of the node. This routine is called by cloneTree to duplicate the current node. cloneNode should be overridden by any user subclassed objects. All subclasses must have their cloneNode method consist of the following lines:

     public Node cloneNode(boolean forceDuplicate) {
         UserSubClass usc = new UserSubClass();
         usc.duplicateNode(this, forceDuplicate);
         return usc;
     }
 

Parameters:

forceDuplicate - when set to true, causes the duplicateOnCloneTree flag to be ignored. When false, the value of each node's duplicateOnCloneTree variable determines whether NodeComponent data is duplicated or copied.

Overrides:

cloneNode in class Node

See Also:

cloneTree, duplicateNode, setDuplicateOnCloneTree

 public void duplicateNode(Node originalNode,
                           boolean forceDuplicate)

Copies all node information from originalNode into the current node. This method is called from the cloneNode method which is, in turn, called by the cloneTree method.

For any NodeComponent objects contained by the object being duplicated, each NodeComponent object's duplicateOnCloneTree value is used to determine whether the NodeComponent should be duplicated in the new node or if just a reference to the current node should be placed in the new node. This flag can be overridden by setting the forceDuplicate parameter in the cloneTree method to true.

Parameters:

originalNode - the original node to duplicate.

forceDuplicate - when set to true, causes the duplicateOnCloneTree flag to be ignored. When false, the value of each node's duplicateOnCloneTree variable determines whether NodeComponent data is duplicated or copied.

Overrides:

duplicateNode in class Node

See Also:

cloneTree, cloneNode, setDuplicateOnCloneTree

All Packages  Class Hierarchy  This Package  Previous  Next  Index