Package javax.media.j3d
Class NodeComponent
java.lang.Object
javax.media.j3d.SceneGraphObject
javax.media.j3d.NodeComponent
- Direct Known Subclasses:
Alpha
,Appearance
,AuralAttributes
,ColoringAttributes
,DepthComponent
,Font3D
,Geometry
,ImageComponent
,LineAttributes
,Material
,MediaContainer
,PointAttributes
,PolygonAttributes
,RenderingAttributes
,Shader
,ShaderAttribute
,ShaderAttributeSet
,ShaderProgram
,TexCoordGeneration
,Texture
,TextureAttributes
,TextureUnitState
,TransparencyAttributes
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
Constructors -
Method Summary
Modifier and TypeMethodDescriptionDeprecated.cloneNodeComponent
(boolean forceDuplicate) Used to create a new instance of a NodeComponent object.void
duplicateNodeComponent
(NodeComponent originalNodeComponent) Deprecated.As of Java 3D version 1.2, replaced byduplicateNodeComponent(NodeComponent originalNodeComponent, boolean forceDuplicate)
void
duplicateNodeComponent
(NodeComponent originalNodeComponent, boolean forceDuplicate) Copies all node information fromoriginalNodeComponent
into the current node.boolean
Returns this node's duplicateOnCloneTree value.void
setDuplicateOnCloneTree
(boolean duplicate) Sets this node's duplicateOnCloneTree value.Methods inherited from class javax.media.j3d.SceneGraphObject
clearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferences
-
Constructor Details
-
NodeComponent
public NodeComponent()Constructs a NodeComponent object with default parameters. The default values are as follows:-
duplicate on clone tree : false
-
-
Method Details
-
setDuplicateOnCloneTree
public void setDuplicateOnCloneTree(boolean duplicate) Sets this node's duplicateOnCloneTree value. The duplicateOnCloneTree value is used to determine if NodeComponent objects are to be duplicated or referenced during acloneTree
operation. A value oftrue
means that this NodeComponent object should be duplicated, while a value offalse
indicates that this NodeComponent object's reference will be copied into the newly cloned object. This value can be overriden via theforceDuplicate
parameter of thecloneTree
method.- Parameters:
duplicate
- the value to set.- See Also:
-
getDuplicateOnCloneTree
public boolean getDuplicateOnCloneTree()Returns this node's duplicateOnCloneTree value. The duplicateOnCloneTree value is used to determine if NodeComponent objects are to be duplicated or referenced during acloneTree
operation. A value oftrue
means that this NodeComponent object should be duplicated, while a value offalse
indicates that this NodeComponent object's reference will be copied into the newly cloned object. This value can be overriden via theforceDuplicate
parameter of thecloneTree
method.- Returns:
- the value of this node's duplicateOnCloneTree
- See Also:
-
cloneNodeComponent
Deprecated.As of Java 3D version 1.2, replaced bycloneNodeComponent(boolean forceDuplicate)
-
duplicateNodeComponent
Deprecated.As of Java 3D version 1.2, replaced byduplicateNodeComponent(NodeComponent originalNodeComponent, boolean forceDuplicate)
NOTE: Applications should not call this method directly. It should only be called by the cloneNode method. -
duplicateNodeComponent
Copies all node information fromoriginalNodeComponent
into the current node. This method is called from thecloneNodeComponent
method which is, in turn, called by thecloneNode
method.
NOTE: Applications should not call this method directly. It should only be called by the cloneNode method.- Parameters:
originalNodeComponent
- the node to duplicate.forceDuplicate
- when set totrue
, causes theduplicateOnCloneTree
flag to be ignored. Whenfalse
, the value of each node'sduplicateOnCloneTree
variable determines whether NodeComponent data is duplicated or copied.- Throws:
RestrictedAccessException
- if forceDuplicate is set and this object is part of a compiled scenegraph- Since:
- Java 3D 1.2
- See Also:
-
cloneNodeComponent
Used to create a new instance of a NodeComponent object. This routine is called bycloneNode
to duplicate the current node.
cloneNodeComponent
should be overridden by any user subclassed NodeComponent objects. All subclasses must have theircloneNodeComponent
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 totrue
, causes theduplicateOnCloneTree
flag to be ignored. Whenfalse
, the value of each node'sduplicateOnCloneTree
variable determines whether NodeComponent data is duplicated or copied.- Throws:
RestrictedAccessException
- if forceDuplicate is set and this object is part of a compiled scenegraph- Since:
- Java 3D 1.2
- See Also:
-
cloneNodeComponent(boolean forceDuplicate)