| java.lang.Object javax.media.j3d.SceneGraphObject javax.media.j3d.NodeComponent
All known Subclasses: javax.media.j3d.MediaContainer, javax.media.j3d.AuralAttributes, javax.media.j3d.ImageComponent, javax.media.j3d.Font3D, javax.media.j3d.RenderingAttributes, javax.media.j3d.Texture, javax.media.j3d.TextureUnitState, javax.media.j3d.PointAttributes, javax.media.j3d.ShaderProgram, javax.media.j3d.Alpha, javax.media.j3d.Appearance, javax.media.j3d.TextureAttributes, javax.media.j3d.TexCoordGeneration, javax.media.j3d.ShaderAttributeSet, javax.media.j3d.Shader, javax.media.j3d.TransparencyAttributes, javax.media.j3d.ShaderAttribute, javax.media.j3d.DepthComponent, javax.media.j3d.Material, javax.media.j3d.ColoringAttributes, javax.media.j3d.PolygonAttributes, javax.media.j3d.Geometry, javax.media.j3d.LineAttributes,
NodeComponent | abstract public class NodeComponent extends SceneGraphObject (Code) | | NodeComponent is a common superclass for all scene graph node
component objects such as: Geometry, Appearance, Material, Texture, etc.
For more information, see the
Introduction to the Java 3D API.
|
Constructor Summary | |
public | NodeComponent() Constructs a NodeComponent object with default parameters. |
forceDuplicate | boolean forceDuplicate(Code) | | |
NodeComponent | public NodeComponent()(Code) | | Constructs a NodeComponent object with default parameters.
The default values are as follows:
duplicate on clone tree : false
|
checkDuplicateNodeComponent | final void checkDuplicateNodeComponent(NodeComponent originalNodeComponent)(Code) | | Copies all node information from originalNodeComponent into
the current node component. This method is called from subclass of
duplicateNodeComponent method which is, in turn, called by the
cloneNodeComponent 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: originalNodeComponent - the original node component to duplicate. |
cloneNodeComponent | public NodeComponent cloneNodeComponent(boolean forceDuplicate)(Code) | | Used to create a new instance of a NodeComponent object. This
routine is called by cloneNode to duplicate the
current node.
cloneNodeComponent should be overridden by any user
subclassed NodeComponent objects. All subclasses must have their
cloneNodeComponent
method consist of the following lines:
public NodeComponent cloneNodeComponent(boolean forceDuplicate) {
UserNodeComponent unc = new UserNodeComponent();
unc.duplicateNodeComponent(this, forceDuplicate);
return unc;
}
Parameters: forceDuplicate - when set to true , causes theduplicateOnCloneTree flag to be ignored. Whenfalse , the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied. exception: RestrictedAccessException - if forceDuplicate is set andthis object is part of a compiled scenegraph See Also: NodeComponent.duplicateNodeComponent See Also: Node.cloneNode See Also: Node.cloneTree since: Java 3D 1.2 |
createRetained | void createRetained()(Code) | | Creates the retained mode NodeComponentRetained object that this
NodeComponent object will point to.
|
duplicateAttributes | void duplicateAttributes(NodeComponent originalNode, boolean forceDuplicate)(Code) | | Copies all NodeComponent information from
originalNode into
the current node. This method is called from the
cloneNode method which is, in turn, called by the
cloneTree method.
Parameters: originalNode - the original node to duplicate. Parameters: forceDuplicate - when set to true , causes theduplicateOnCloneTree flag to be ignored. Whenfalse , the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied. See Also: Group.cloneNode See Also: Node.duplicateNode See Also: Node.cloneTree See Also: NodeComponent.setDuplicateOnCloneTree |
duplicateChild | boolean duplicateChild()(Code) | | This function is called from getNodeComponent() to see if any of
the sub-NodeComponents duplicateOnCloneTree flag is true.
If it is the case, current NodeComponent needs to
duplicate also even though current duplicateOnCloneTree flag is false.
This should be overwrite by NodeComponent which contains sub-NodeComponent.
|
duplicateNodeComponent | public void duplicateNodeComponent(NodeComponent originalNodeComponent)(Code) | | NOTE: Applications should not call this method directly.
It should only be called by the cloneNode method.
|
duplicateNodeComponent | public void duplicateNodeComponent(NodeComponent originalNodeComponent, boolean forceDuplicate)(Code) | | Copies all node information from originalNodeComponent
into the current node. This method is called from the
cloneNodeComponent method which is, in turn, called
by the cloneNode method.
NOTE: Applications should not call this method directly.
It should only be called by the cloneNode method.
Parameters: originalNodeComponent - the node to duplicate. Parameters: forceDuplicate - when set to true , causes theduplicateOnCloneTree flag to be ignored. Whenfalse , the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied. exception: RestrictedAccessException - if forceDuplicate is set andthis object is part of a compiled scenegraph See Also: NodeComponent.cloneNodeComponent See Also: Node.cloneNode See Also: Node.cloneTree since: Java 3D 1.2 |
getDuplicateOnCloneTree | public boolean getDuplicateOnCloneTree()(Code) | | Returns this node's duplicateOnCloneTree value. The
duplicateOnCloneTree value is used to determine if NodeComponent
objects are to be duplicated or referenced during a
cloneTree operation. A value of true means
that this NodeComponent object should be duplicated, while a value
of false indicates that this NodeComponent object's
reference will be copied into the newly cloned object. This value
can be overriden via the forceDuplicate parameter of
the cloneTree method.
the value of this node's duplicateOnCloneTree See Also: Node.cloneTree |
setDuplicateOnCloneTree | public void setDuplicateOnCloneTree(boolean duplicate)(Code) | | Sets this node's duplicateOnCloneTree value. The
duplicateOnCloneTree value is used to determine if NodeComponent
objects are to be duplicated or referenced during a
cloneTree operation. A value of true means
that this NodeComponent object should be duplicated, while a value
of false indicates that this NodeComponent object's
reference will be copied into the newly cloned object. This value
can be overriden via the forceDuplicate parameter of
the cloneTree method.
Parameters: duplicate - the value to set. See Also: Node.cloneTree |
|
|