|
| |
|
| java.lang.Object
 javax.media.j3d.SceneGraphObject
javax.media.j3d.Node
javax.media.j3d.Group
javax.media.j3d.SharedGroup
| SharedGroup | | public class SharedGroup extends Group (Code) | | The SharedGroup provides the ability to manipulate an
instanced scene graph.
A SharedGroup node allows multiple Link leaf nodes to share its
subgraph according to the following semantics:
- A SharedGroup may be referenced by one or more Link leaf
nodes. Any runtime changes to a node or component object in this
shared subgraph affect all graphs that refer to this subgraph.
- A SharedGroup may be compiled by calling its compile method
prior to being referenced by any Link leaf nodes.
- Only Link leaf nodes may refer to SharedGroup nodes. A
SharedGroup node cannot have parents or be attached to a Locale.
A shared subgraph may contain any group node, except an embedded
SharedGroup node (SharedGroup nodes cannot have parents). However,
only the following leaf nodes may appear in a shared subgraph:
- Light
- Link
- Morph
- Shape
- Sound
An IllegalSharingException is thrown if any of the following leaf nodes
appear in a shared subgraph:
- AlternateAppearance
- Background
- Behavior
- BoundingLeaf
- Clip
- Fog
- ModelClip
- Soundscape
- ViewPlatform
See Also: IllegalSharingException |
| Field Summary | |
| final public static int | ALLOW_LINK_READ
Specifies that this SharedGroup node allows reading the
list of links that refer to this node. |
| Constructor Summary | |
| public | SharedGroup()
Constructs and initializes a new SharedGroup node object. |
| Method Summary | |
| public Node | cloneNode(boolean forceDuplicate)
Used to create a new instance of the node. | | public void | compile()
Compiles the source SharedGroup associated with this object and
creates and caches a compiled scene graph. | | void | createRetained()
Creates the retained mode SharedGroupRetained object that this
SharedGroup component object will point to. | | public Link[] | getLinks()
Returns the list of Link nodes that refer to this SharedGroup node.
An array of Link nodes that refer to this SharedGroup node. |
| ALLOW_LINK_READ | | final public static int ALLOW_LINK_READ(Code) | | Specifies that this SharedGroup node allows reading the
list of links that refer to this node.
since:
Java 3D 1.3 |
| SharedGroup | | public SharedGroup()(Code) | | Constructs and initializes a new SharedGroup node object.
|
| cloneNode | | public Node cloneNode(boolean forceDuplicate)(Code) | | Used to create a new instance of the node. This routine is called
by cloneTree to duplicate the current node.
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: Node.cloneTree
See Also: Node.cloneNode
See Also: Node.duplicateNode
See Also: NodeComponent.setDuplicateOnCloneTree |
| compile | | public void compile()(Code) | | Compiles the source SharedGroup associated with this object and
creates and caches a compiled scene graph.
exception:
SceneGraphCycleException - if there is a cycle in thescene graph
exception:
RestrictedAccessException - if the method is calledwhen this object is part of a live scene graph. |
| createRetained | | void createRetained()(Code) | | Creates the retained mode SharedGroupRetained object that this
SharedGroup component object will point to.
|
| getLinks | | public Link[] getLinks()(Code) | | Returns the list of Link nodes that refer to this SharedGroup node.
An array of Link nodes that refer to this SharedGroup node.
since:
Java 3D 1.3 |
|
|
|