Java Doc for AlternateAppearance.java in  » 6.0-JDK-Modules » java-3d » javax » media » j3d » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » 6.0 JDK Modules » java 3d » javax.media.j3d 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   javax.media.j3d.SceneGraphObject
      javax.media.j3d.Node
         javax.media.j3d.Leaf
            javax.media.j3d.AlternateAppearance

AlternateAppearance
public class AlternateAppearance extends Leaf (Code)
The AlternateAppearance leaf node is used for overriding the Appearance component of selected nodes. It defines an Appearance component object and a region of influence in which this AlternateAppearance node is active. An AlternateAppearance node also contains a list of Group nodes that specifies the hierarchical scope of this AlternateAppearance. If the scope list is empty, then the AlternateAppearance node has universe scope: all nodes within the region of influence are affected by this AlternateAppearance node. If the scope list is non-empty, then only those Leaf nodes under the Group nodes in the scope list are affected by this AlternateAppearance node (subject to the influencing bounds).

An AlternateAppearance node affects Shape3D and Morph nodes by overriding their appearance component with the appearance component in this AlternateAppearance node. Only those Shape3D and Morph nodes that explicitly allow their appearance to be overridden are affected. The AlternateAppearance node has no effect on Shape3D and Morph nodes that do not allow their appearance to be overridden.

If the regions of influence of multiple AlternateAppearance nodes overlap, the Java 3D system will choose a single alternate appearance for those objects that lie in the intersection. This is done in an implementation-dependent manner, but in general, the AlternateAppearance node that is "closest" to the object is chosen.
since:
   Java 3D 1.2



Field Summary
final public static  intALLOW_APPEARANCE_READ
     Specifies that this AlternateAppearance node allows read access to its appearance information.
final public static  intALLOW_APPEARANCE_WRITE
     Specifies that this AlternateAppearance node allows write access to its appearance information.
final public static  intALLOW_INFLUENCING_BOUNDS_READ
     Specifies that this AlternateAppearance node allows read access to its influencing bounds and bounds leaf information.
final public static  intALLOW_INFLUENCING_BOUNDS_WRITE
     Specifies that this AlternateAppearance node allows write access to its influencing bounds and bounds leaf information.
final public static  intALLOW_SCOPE_READ
     Specifies that this AlternateAppearance node allows read access to its scope information at runtime.
final public static  intALLOW_SCOPE_WRITE
     Specifies that this AlternateAppearance node allows write access to its scope information at runtime.

Constructor Summary
public  AlternateAppearance()
     Constructs an AlternateAppearance node with default parameters.
public  AlternateAppearance(Appearance appearance)
     Constructs an AlternateAppearance node with the specified appearance.

Method Summary
public  voidaddScope(Group scope)
     Appends the specified Group node to this AlternateAppearance node's list of scopes. By default, AlternateAppearance nodes are scoped only by their influencing bounds.
public  NodecloneNode(boolean forceDuplicate)
     Used to create a new instance of the node.
 voidcreateRetained()
     Creates the retained mode AlternateAppearanceRetained object that this Alternate Appearance component object will point to.
 voidduplicateAttributes(Node originalNode, boolean forceDuplicate)
     Copies all AlternateAppearance information from originalNode into the current node.
public  EnumerationgetAllScopes()
     Returns an enumeration of this AlternateAppearance node's list of scopes.
public  AppearancegetAppearance()
     Retrieves the appearance from this AlternateAppearance node.
public  BoundingLeafgetInfluencingBoundingLeaf()
     Retrieves the AlternateAppearance node's influencing bounding leaf.
public  BoundsgetInfluencingBounds()
     Retrieves the AlternateAppearance node's influencing bounds.
public  GroupgetScope(int index)
     Retrieves the Group node at the specified index from this AlternateAppearance node's list of scopes.
Parameters:
  index - the index of the Group node to be returned.
public  intindexOfScope(Group scope)
     Retrieves the index of the specified Group node in this AlternateAppearance node's list of scopes.
Parameters:
  scope - the Group node to be looked up.
public  voidinsertScope(Group scope, int index)
     Inserts the specified Group node into this AlternateAppearance node's list of scopes at the specified index. By default, AlternateAppearance nodes are scoped only by their influencing bounds.
public  intnumScopes()
     Returns the number of nodes in this AlternateAppearance node's list of scopes.
public  voidremoveAllScopes()
     Removes all Group nodes from this AlternateAppearance node's list of scopes.
public  voidremoveScope(int index)
     Removes the node at the specified index from this AlternateAppearance node's list of scopes.
public  voidremoveScope(Group scope)
     Removes the specified Group node from this AlternateAppearance node's list of scopes.
public  voidsetAppearance(Appearance appearance)
     Sets the appearance of this AlternateAppearance node.
public  voidsetInfluencingBoundingLeaf(BoundingLeaf region)
     Sets the AlternateAppearance's influencing region to the specified bounding leaf.
public  voidsetInfluencingBounds(Bounds region)
     Sets the AlternateAppearance's influencing region to the specified bounds.
public  voidsetScope(Group scope, int index)
     Replaces the node at the specified index in this AlternateAppearance node's list of scopes with the specified Group node. By default, AlternateAppearance nodes are scoped only by their influencing bounds.
public  voidupdateNodeReferences(NodeReferenceTable referenceTable)
     Callback used to allow a node to check if any nodes referenced by that node have been duplicated via a call to cloneTree. This method is called by cloneTree after all nodes in the sub-graph have been duplicated.

Field Detail
ALLOW_APPEARANCE_READ
final public static int ALLOW_APPEARANCE_READ(Code)
Specifies that this AlternateAppearance node allows read access to its appearance information.



ALLOW_APPEARANCE_WRITE
final public static int ALLOW_APPEARANCE_WRITE(Code)
Specifies that this AlternateAppearance node allows write access to its appearance information. information.



ALLOW_INFLUENCING_BOUNDS_READ
final public static int ALLOW_INFLUENCING_BOUNDS_READ(Code)
Specifies that this AlternateAppearance node allows read access to its influencing bounds and bounds leaf information.



ALLOW_INFLUENCING_BOUNDS_WRITE
final public static int ALLOW_INFLUENCING_BOUNDS_WRITE(Code)
Specifies that this AlternateAppearance node allows write access to its influencing bounds and bounds leaf information.



ALLOW_SCOPE_READ
final public static int ALLOW_SCOPE_READ(Code)
Specifies that this AlternateAppearance node allows read access to its scope information at runtime.



ALLOW_SCOPE_WRITE
final public static int ALLOW_SCOPE_WRITE(Code)
Specifies that this AlternateAppearance node allows write access to its scope information at runtime.




Constructor Detail
AlternateAppearance
public AlternateAppearance()(Code)
Constructs an AlternateAppearance node with default parameters. The default values are as follows:
    appearance : null
    scope : empty (universe scope)
    influencing bounds : null
    influencing bounding leaf : null



AlternateAppearance
public AlternateAppearance(Appearance appearance)(Code)
Constructs an AlternateAppearance node with the specified appearance.
Parameters:
  appearance - the appearance that is used for those nodes affectedby this AlternateAppearance node.




Method Detail
addScope
public void addScope(Group scope)(Code)
Appends the specified Group node to this AlternateAppearance node's list of scopes. By default, AlternateAppearance nodes are scoped only by their influencing bounds. This allows them to be further scoped by a list of nodes in the hierarchy.
Parameters:
  scope - the Group node to be appended.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
  RestrictedAccessException - if the specified group nodeis part of a compiled scene graph



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



createRetained
void createRetained()(Code)
Creates the retained mode AlternateAppearanceRetained object that this Alternate Appearance component object will point to.



duplicateAttributes
void duplicateAttributes(Node originalNode, boolean forceDuplicate)(Code)
Copies all AlternateAppearance 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.
exception:
  RestrictedAccessException - if this object is part of a liveor compiled scenegraph.
See Also:   Node.duplicateNode
See Also:   Node.cloneTree
See Also:   NodeComponent.setDuplicateOnCloneTree




getAllScopes
public Enumeration getAllScopes()(Code)
Returns an enumeration of this AlternateAppearance node's list of scopes. an Enumeration object containing all nodes in thisAlternateAppearance node's list of scopes.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



getAppearance
public Appearance getAppearance()(Code)
Retrieves the appearance from this AlternateAppearance node. the current appearance.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



getInfluencingBoundingLeaf
public BoundingLeaf getInfluencingBoundingLeaf()(Code)
Retrieves the AlternateAppearance node's influencing bounding leaf. this AlternateAppearance's influencing bounding leaf information
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



getInfluencingBounds
public Bounds getInfluencingBounds()(Code)
Retrieves the AlternateAppearance node's influencing bounds. this AlternateAppearance's influencing bounds information
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



getScope
public Group getScope(int index)(Code)
Retrieves the Group node at the specified index from this AlternateAppearance node's list of scopes.
Parameters:
  index - the index of the Group node to be returned. the Group node at the specified index.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



indexOfScope
public int indexOfScope(Group scope)(Code)
Retrieves the index of the specified Group node in this AlternateAppearance node's list of scopes.
Parameters:
  scope - the Group node to be looked up. the index of the specified Group node;returns -1 if the object is not in the list.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
since:
   Java 3D 1.3



insertScope
public void insertScope(Group scope, int index)(Code)
Inserts the specified Group node into this AlternateAppearance node's list of scopes at the specified index. By default, AlternateAppearance nodes are scoped only by their influencing bounds. This allows them to be further scoped by a list of nodes in the hierarchy.
Parameters:
  scope - the Group node to be inserted at the specified index.
Parameters:
  index - the index at which the Group node is inserted.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
  RestrictedAccessException - if the specified group nodeis part of a compiled scene graph



numScopes
public int numScopes()(Code)
Returns the number of nodes in this AlternateAppearance node's list of scopes. If this number is 0, then the list of scopes is empty and this AlternateAppearance node has universe scope: all nodes within the region of influence are affected by this AlternateAppearance node. the number of nodes in this AlternateAppearance node's listof scopes.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



removeAllScopes
public void removeAllScopes()(Code)
Removes all Group nodes from this AlternateAppearance node's list of scopes. The AlternateAppearance node will then have universe scope: all nodes within the region of influence will be affected by this AlternateAppearance node.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
  RestrictedAccessException - if any group node in thisnode's list of scopes is part of a compiled scene graph
since:
   Java 3D 1.3



removeScope
public void removeScope(int index)(Code)
Removes the node at the specified index from this AlternateAppearance node's list of scopes. If this operation causes the list of scopes to become empty, then this AlternateAppearance will have universe scope: all nodes within the region of influence will be affected by this AlternateAppearance node.
Parameters:
  index - the index of the Group node to be removed.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
  RestrictedAccessException - if the group node at thespecified index is part of a compiled scene graph



removeScope
public void removeScope(Group scope)(Code)
Removes the specified Group node from this AlternateAppearance node's list of scopes. If the specified object is not in the list, the list is not modified. If this operation causes the list of scopes to become empty, then this AlternateAppearance will have universe scope: all nodes within the region of influence will be affected by this AlternateAppearance node.
Parameters:
  scope - the Group node to be removed.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
  RestrictedAccessException - if the specified group nodeis part of a compiled scene graph
since:
   Java 3D 1.3



setAppearance
public void setAppearance(Appearance appearance)(Code)
Sets the appearance of this AlternateAppearance node. This appearance overrides the appearance in those Shape3D and Morph nodes affected by this AlternateAppearance node.
Parameters:
  appearance - the new appearance.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



setInfluencingBoundingLeaf
public void setInfluencingBoundingLeaf(BoundingLeaf region)(Code)
Sets the AlternateAppearance's influencing region to the specified bounding leaf. When set to a value other than null, this overrides the influencing bounds object.
Parameters:
  region - the bounding leaf node used to specify theAlternateAppearance node's new influencing region.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



setInfluencingBounds
public void setInfluencingBounds(Bounds region)(Code)
Sets the AlternateAppearance's influencing region to the specified bounds. This is used when the influencing bounding leaf is set to null.
Parameters:
  region - the bounds that contains the AlternateAppearance'snew influencing region.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph



setScope
public void setScope(Group scope, int index)(Code)
Replaces the node at the specified index in this AlternateAppearance node's list of scopes with the specified Group node. By default, AlternateAppearance nodes are scoped only by their influencing bounds. This allows them to be further scoped by a list of nodes in the hierarchy.
Parameters:
  scope - the Group node to be stored at the specified index.
Parameters:
  index - the index of the Group node to be replaced.
exception:
  CapabilityNotSetException - if appropriate capability isnot set and this object is part of live or compiled scene graph
exception:
  RestrictedAccessException - if the specified group nodeis part of a compiled scene graph



updateNodeReferences
public void updateNodeReferences(NodeReferenceTable referenceTable)(Code)
Callback used to allow a node to check if any nodes referenced by that node have been duplicated via a call to cloneTree. This method is called by cloneTree after all nodes in the sub-graph have been duplicated. The cloned Leaf node's method will be called and the Leaf node can then look up any node references by using the getNewObjectReference method found in the NodeReferenceTable object. If a match is found, a reference to the corresponding Node in the newly cloned sub-graph is returned. If no corresponding reference is found, either a DanglingReferenceException is thrown or a reference to the original node is returned depending on the value of the allowDanglingReferences parameter passed in the cloneTree call.

NOTE: Applications should not call this method directly. It should only be called by the cloneTree method.
Parameters:
  referenceTable - a NodeReferenceTableObject that contains thegetNewObjectReference method needed to search fornew object instances.
See Also:   NodeReferenceTable
See Also:   Node.cloneTree
See Also:   DanglingReferenceException





Fields inherited from javax.media.j3d.Node
final public static int ALLOW_AUTO_COMPUTE_BOUNDS_READ(Code)(Java Doc)
final public static int ALLOW_AUTO_COMPUTE_BOUNDS_WRITE(Code)(Java Doc)
final public static int ALLOW_BOUNDS_READ(Code)(Java Doc)
final public static int ALLOW_BOUNDS_WRITE(Code)(Java Doc)
final public static int ALLOW_COLLIDABLE_READ(Code)(Java Doc)
final public static int ALLOW_COLLIDABLE_WRITE(Code)(Java Doc)
final public static int ALLOW_LOCALE_READ(Code)(Java Doc)
final public static int ALLOW_LOCAL_TO_VWORLD_READ(Code)(Java Doc)
final public static int ALLOW_PARENT_READ(Code)(Java Doc)
final public static int ALLOW_PICKABLE_READ(Code)(Java Doc)
final public static int ALLOW_PICKABLE_WRITE(Code)(Java Doc)
final public static int ENABLE_COLLISION_REPORTING(Code)(Java Doc)
final public static int ENABLE_PICK_REPORTING(Code)(Java Doc)

Methods inherited from javax.media.j3d.Node
final void checkDuplicateNode(Node originalNode, boolean forceDuplicate)(Code)(Java Doc)
void checkForCycle()(Code)(Java Doc)
public Node cloneNode(boolean forceDuplicate)(Code)(Java Doc)
public Node cloneTree()(Code)(Java Doc)
public Node cloneTree(boolean forceDuplicate)(Code)(Java Doc)
public Node cloneTree(boolean forceDuplicate, boolean allowDanglingReferences)(Code)(Java Doc)
public Node cloneTree(NodeReferenceTable referenceTable)(Code)(Java Doc)
public Node cloneTree(NodeReferenceTable referenceTable, boolean forceDuplicate)(Code)(Java Doc)
public Node cloneTree(NodeReferenceTable referenceTable, boolean forceDuplicate, boolean allowDanglingReferences)(Code)(Java Doc)
Node cloneTree(boolean forceDuplicate, Hashtable nodeHashtable)(Code)(Java Doc)
void duplicateAttributes(Node originalNode, boolean forceDuplicate)(Code)(Java Doc)
public void duplicateNode(Node originalNode, boolean forceDuplicate)(Code)(Java Doc)
public Bounds getBounds()(Code)(Java Doc)
public boolean getBoundsAutoCompute()(Code)(Java Doc)
public boolean getCollidable()(Code)(Java Doc)
public void getLocalToVworld(Transform3D t)(Code)(Java Doc)
public void getLocalToVworld(SceneGraphPath path, Transform3D t)(Code)(Java Doc)
public Locale getLocale()(Code)(Java Doc)
public Node getParent()(Code)(Java Doc)
public boolean getPickable()(Code)(Java Doc)
public void setBounds(Bounds bounds)(Code)(Java Doc)
public void setBoundsAutoCompute(boolean autoCompute)(Code)(Java Doc)
public void setCollidable(boolean collidable)(Code)(Java Doc)
public void setPickable(boolean pickable)(Code)(Java Doc)

Fields inherited from javax.media.j3d.SceneGraphObject
Hashtable nodeHashtable(Code)(Java Doc)
SceneGraphObjectRetained retained(Code)(Java Doc)

Methods inherited from javax.media.j3d.SceneGraphObject
final boolean capabilityBitsEmpty()(Code)(Java Doc)
final void checkForLiveOrCompiled()(Code)(Java Doc)
final public void clearCapability(int bit)(Code)(Java Doc)
final public void clearCapabilityIsFrequent(int bit)(Code)(Java Doc)
final void clearLive()(Code)(Java Doc)
void createRetained()(Code)(Java Doc)
protected void duplicateSceneGraphObject(SceneGraphObject originalNode)(Code)(Java Doc)
final public boolean getCapability(int bit)(Code)(Java Doc)
final public boolean getCapabilityIsFrequent(int bit)(Code)(Java Doc)
public String getName()(Code)(Java Doc)
String getNamePrefix()(Code)(Java Doc)
NodeComponent getNodeComponent(NodeComponent originalNodeComponent, boolean forceDuplicate, Hashtable hashtable)(Code)(Java Doc)
public Object getUserData()(Code)(Java Doc)
final public boolean isCompiled()(Code)(Java Doc)
final public boolean isLive()(Code)(Java Doc)
final boolean isLiveOrCompiled()(Code)(Java Doc)
final public void setCapability(int bit)(Code)(Java Doc)
final public void setCapabilityIsFrequent(int bit)(Code)(Java Doc)
final void setCompiled()(Code)(Java Doc)
void setDefaultReadCapabilities(int[] bits)(Code)(Java Doc)
final void setLive()(Code)(Java Doc)
public void setName(String name)(Code)(Java Doc)
public void setUserData(Object userData)(Code)(Java Doc)
public String toString()(Code)(Java Doc)
public void updateNodeReferences(NodeReferenceTable referenceTable)(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.