node.html

java 3d帮助文档

<DT><B>Parameters:</B><DD><CODE>forceDuplicate</CODE> - when set to <code>true</code>, causes the
  <code>duplicateOnCloneTree</code>
  flag to be ignored.  When <code>false</code>, the value of each node's
  <code>duplicateOnCloneTree</code> determines whether data is
  duplicated or copied.
<DT><B>Returns:</B><DD>a reference to the cloned scene graph.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/DanglingReferenceException.html">DanglingReferenceException</A></CODE> - When a dangling reference is
  discovered during the cloneTree operation and the 
  <code>allowDanglingReference</code> parameter is </code>false</code>.
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if this object is part of live
 or compiled scene graph
<DD><CODE><A HREF="../../../javax/media/j3d/SceneGraphCycleException.html">SceneGraphCycleException</A></CODE> - if there is a cycle in the
 scene graph<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/NodeComponent.html#setDuplicateOnCloneTree(boolean)"><CODE>NodeComponent.setDuplicateOnCloneTree(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="cloneTree(javax.media.j3d.NodeReferenceTable)"><!-- --></A><H3>
cloneTree</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Node.html">Node</A> <B>cloneTree</B>(<A HREF="../../../javax/media/j3d/NodeReferenceTable.html">NodeReferenceTable</A>&nbsp;referenceTable)</PRE>
<DL>
<DD>Duplicates all the nodes of the specified sub-graph.  For Group Nodes
 the group node is duplicated via a call to <code>cloneNode</code>
 and then <code>cloneTree</code>
 is called for each child node.  For Leaf Nodes, component
 data can either be duplicated or be made a reference to the original
 data.  Leaf Node cloneTree behavior is determined by the
 <code>duplicateOnCloneTree</code> flag found in every Leaf Node's
 component data class and by the <code>forceDuplicate</code> paramter.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>referenceTable</CODE> - table that stores the mapping between
	original and cloned nodes. All previous values in the
	referenceTable will be cleared before the clone is made.
<DT><B>Returns:</B><DD>a reference to the cloned sub-graph.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/DanglingReferenceException.html">DanglingReferenceException</A></CODE> - When a dangling reference is
  discovered during the cloneTree operation.
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if this object is part of live
 or compiled scene graph
<DD><CODE><A HREF="../../../javax/media/j3d/SceneGraphCycleException.html">SceneGraphCycleException</A></CODE> - if there is a cycle in the
 scene graph<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/NodeComponent.html#setDuplicateOnCloneTree(boolean)"><CODE>NodeComponent.setDuplicateOnCloneTree(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="cloneTree(javax.media.j3d.NodeReferenceTable, boolean)"><!-- --></A><H3>
cloneTree</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Node.html">Node</A> <B>cloneTree</B>(<A HREF="../../../javax/media/j3d/NodeReferenceTable.html">NodeReferenceTable</A>&nbsp;referenceTable,
                      boolean&nbsp;forceDuplicate)</PRE>
<DL>
<DD>Duplicates all the nodes of the specified sub-graph.  For Group Nodes
 the group node is duplicated via a call to <code>cloneNode</code>
 and then <code>cloneTree</code> is called for each child node.
 For Leaf Nodes, component
 data can either be duplicated or be made a reference to the original
 data.  Leaf Node cloneTree behavior is determined by the
 <code>duplicateOnCloneTree</code> flag found in every Leaf Node's
 component data class and by the <code>forceDuplicate</code> paramter.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>referenceTable</CODE> - table that stores the mapping between
	original and cloned nodes. All previous values in the
	referenceTable will be cleared before the clone is made.<DD><CODE>forceDuplicate</CODE> - when set to <code>true</code>, causes the
  <code>duplicateOnCloneTree</code> flag to be ignored.  When
  <code>false</code>, the value of each node's
  <code>duplicateOnCloneTree</code> determines whether data is
  duplicated or copied.
<DT><B>Returns:</B><DD>a reference to the cloned scene graph.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/DanglingReferenceException.html">DanglingReferenceException</A></CODE> - When a dangling reference is
  discovered during the cloneTree operation.
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if this object is part of live
 or compiled scene graph
<DD><CODE><A HREF="../../../javax/media/j3d/SceneGraphCycleException.html">SceneGraphCycleException</A></CODE> - if there is a cycle in the
 scene graph<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/NodeComponent.html#setDuplicateOnCloneTree(boolean)"><CODE>NodeComponent.setDuplicateOnCloneTree(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="cloneTree(javax.media.j3d.NodeReferenceTable, boolean, boolean)"><!-- --></A><H3>
cloneTree</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Node.html">Node</A> <B>cloneTree</B>(<A HREF="../../../javax/media/j3d/NodeReferenceTable.html">NodeReferenceTable</A>&nbsp;referenceTable,
                      boolean&nbsp;forceDuplicate,
                      boolean&nbsp;allowDanglingReferences)</PRE>
<DL>
<DD>Duplicates all the nodes of the specified sub-graph.  For Group Nodes
 the group node is duplicated via a call to <code>cloneNode</code>
 and then <code>cloneTree</code> is called for each child node.
 For Leaf Nodes, component
 data can either be duplicated or be made a reference to the original
 data.  Leaf Node cloneTree behavior is determined by the
 <code>duplicateOnCloneTree</code> flag found in every Leaf Node's
 component data class and by the <code>forceDuplicate</code> paramter.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>referenceTable</CODE> - table that stores the mapping between
	original and cloned nodes. All previous values in the
	referenceTable will be cleared before the clone is made.<DD><CODE>forceDuplicate</CODE> - when set to <code>true</code>, causes the
  <code>duplicateOnCloneTree</code> flag to be ignored.  When
  <code>false</code>, the value of each node's
  <code>duplicateOnCloneTree</code> determines whether data is
  duplicated or copied.<DD><CODE>allowDanglingReferences</CODE> - when set to <code>true</code> allows
  the <code>cloneTree</code>
  method to complete even whan a dangling reference is discovered. When
  this parameter is <code>false</code> a
  <code>DanglingReferenceException</code> is generated as
  soon as cloneTree detects this situation.
<DT><B>Returns:</B><DD>a reference to the cloned scene graph.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/DanglingReferenceException.html">DanglingReferenceException</A></CODE> - When a dangling reference is
  discovered during the cloneTree operation.
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if this object is part of live
 or compiled scene graph
<DD><CODE><A HREF="../../../javax/media/j3d/SceneGraphCycleException.html">SceneGraphCycleException</A></CODE> - if there is a cycle in the
 scene graph<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/NodeComponent.html#setDuplicateOnCloneTree(boolean)"><CODE>NodeComponent.setDuplicateOnCloneTree(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="cloneNode(boolean)"><!-- --></A><H3>
cloneNode</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Node.html">Node</A> <B>cloneNode</B>(boolean&nbsp;forceDuplicate)</PRE>
<DL>
<DD>Used to create a new instance of the node.  This routine is called
 by <code>cloneTree</code> to duplicate the current node. 
 <code>cloneNode</code> should be overridden by any user subclassed
 objects.  All subclasses must have their <code>cloneNode</code>
 method consist of the following lines:
 <P><blockquote><pre>
     public Node cloneNode(boolean forceDuplicate) {
         UserSubClass usc = new UserSubClass();
         usc.duplicateNode(this, forceDuplicate);
         return usc;
     }
 </pre></blockquote>
 NOTE: Applications should <i>not</i> call this method directly.
 It should only be called by the cloneTree method.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>forceDuplicate</CODE> - when set to <code>true</code>, causes the
  <code>duplicateOnCloneTree</code> flag to be ignored.  When
  <code>false</code>, the value of each node's
  <code>duplicateOnCloneTree</code> variable determines whether
  NodeComponent data is duplicated or copied.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if this object is part of live
 or compiled scene graph<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Node.html#cloneTree()"><CODE>cloneTree()</CODE></A>, 
<A HREF="../../../javax/media/j3d/Node.html#duplicateNode(javax.media.j3d.Node, boolean)"><CODE>duplicateNode(javax.media.j3d.Node, boolean)</CODE></A>, 
<A HREF="../../../javax/media/j3d/NodeComponent.html#setDuplicateOnCloneTree(boolean)"><CODE>NodeComponent.setDuplicateOnCloneTree(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="duplicateNode(javax.media.j3d.Node, boolean)"><!-- --></A><H3>
duplicateNode</H3>
<PRE>
public void <B>duplicateNode</B>(<A HREF="../../../javax/media/j3d/Node.html">Node</A>&nbsp;originalNode,
                          boolean&nbsp;forceDuplicate)</PRE>
<DL>
<DD>Copies all node information from <code>originalNode</code> into
 the current node.  This method is called from the
 <code>cloneNode</code> method which is, in turn, called by the
 <code>cloneTree</code> method.
 <P>
 For any <code>NodeComponent</code> objects
 contained by the object being duplicated, each <code>NodeComponent</code>
 object's <code>duplicateOnCloneTree</code> value is used to determine
 whether the <code>NodeComponent</code> 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
 <code>forceDuplicate</code> parameter in the <code>cloneTree</code>
 method to <code>true</code>.

 <br>
 NOTE: Applications should <i>not</i> call this method directly.
 It should only be called by the cloneNode method.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>originalNode</CODE> - the original node to duplicate.<DD><CODE>forceDuplicate</CODE> - when set to <code>true</code>, causes the
  <code>duplicateOnCloneTree</code> flag to be ignored.  When
  <code>false</code>, the value of each node's
  <code>duplicateOnCloneTree</code> variable determines whether
  NodeComponent data is duplicated or copied.<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Group.html#cloneNode(boolean)"><CODE>Group.cloneNode(boolean)</CODE></A>, 
<A HREF="../../../javax/media/j3d/Node.html#duplicateNode(javax.media.j3d.Node, boolean)"><CODE>duplicateNode(javax.media.j3d.Node, boolean)</CODE></A>, 
<A HREF="../../../javax/media/j3d/Node.html#cloneTree()"><CODE>cloneTree()</CODE></A>, 
<A HREF="../../../javax/media/j3d/NodeComponent.html#setDuplicateOnCloneTree(boolean)"><CODE>NodeComponent.setDuplicateOnCloneTree(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPickable(boolean)"><!-- --></A><H3>
setPickable</H3>
<PRE>
public void <B>setPickable</B>(boolean&nbsp;pickable)</PRE>
<DL>
<DD>When set to <code>true</code> this <code>Node</code> can be Picked.
 Setting to false indicates that this node and it's children
 are ALL unpickable.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pickable</CODE> - Indicates if this node should be pickable or not</DL>
</DD>
</DL>
<HR>

<A NAME="getPickable()"><!-- --></A><H3>
getPickable</H3>
<PRE>
public boolean <B>getPickable</B>()</PRE>
<DL>
<DD>Returns true if this <code>Node</code> is pickable,
 false if it is not pickable.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/media/j3d/Morph.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/media/j3d/NodeComponent.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="Node.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;
<SCRIPT>
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>

</BODY>
</HTML>