branchgroup.html

JAVA多媒体开发类库说明

 <code>PickInfo.CLOSEST_INTERSECTION_POINT</code> - request for closest intersection point.<br>
 <code>PickInfo.CLOSEST_DISTANCE</code> - request for the distance of closest intersection.<br>
 <code>PickInfo.CLOSEST_GEOM_INFO</code> - request for only the closest intersection geometry information.<br>
 <code>PickInfo.ALL_GEOM_INFO</code> - request for all intersection geometry information.<br>
 </ul><DD><CODE>pickShape</CODE> - the description of this picking volume or area.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if flags contains both CLOSEST_GEOM_INFO and 
 ALL_GEOM_INFO.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pickShape is a PickPoint and pick mode
 is set to PICK_GEOMETRY.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pick mode is neither PICK_BOUNDS 
 nor PICK_GEOMETRY.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pick mode is PICK_BOUNDS 
 and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
 CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pickShape is PickBounds 
 and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
 CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
<DD><CODE>java.lang.IllegalStateException</CODE> - if BranchGroup is not live.
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if the mode is
 PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
 is not set in any Geometry objects referred to by any shape
 node whose bounds intersects the PickShape.
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if flags contains any of
 CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
 or ALL_GEOM_INFO, and the capability bits that control reading of
 coordinate data are not set in any GeometryArray object referred
 to by any shape node that intersects the PickShape.
 The capability bits that must be set to avoid this exception are as follows :
 <ul> 
 <li>By-copy geometry : GeometryArray.ALLOW_COORDINATE_READ</li>
 <li>By-reference geometry : GeometryArray.ALLOW_REF_DATA_READ</li>
 <li>Indexed geometry : IndexedGeometryArray.ALLOW_COORDINATE_INDEX_READ
 (in addition to one of the above)</li>
 </ul><DT><B>Since:</B></DT>
  <DD>Java 3D 1.4</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Locale.html#pickClosest(int, int, javax.media.j3d.PickShape)"><CODE>Locale.pickClosest(int,int,javax.media.j3d.PickShape)</CODE></A>, 
<A HREF="../../../javax/media/j3d/PickInfo.html" title="class in javax.media.j3d"><CODE>PickInfo</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAny(javax.media.j3d.PickShape)"><!-- --></A><H3>
pickAny</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A> <B>pickAny</B>(<A HREF="../../../javax/media/j3d/PickShape.html" title="class in javax.media.j3d">PickShape</A>&nbsp;pickShape)</PRE>
<DL>
<DD>Returns a reference to any item that is Pickable below this BranchGroup that
 intersects with <code>pickShape</code>.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pickShape</CODE> - the PickShape object
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalStateException</CODE> - if BranchGroup is not live.<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A>, 
<A HREF="../../../javax/media/j3d/Locale.html#pickAny(javax.media.j3d.PickShape)"><CODE>Locale.pickAny(javax.media.j3d.PickShape)</CODE></A>, 
<A HREF="../../../javax/media/j3d/PickShape.html" title="class in javax.media.j3d"><CODE>PickShape</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAny(int, int, javax.media.j3d.PickShape)"><!-- --></A><H3>
pickAny</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/PickInfo.html" title="class in javax.media.j3d">PickInfo</A> <B>pickAny</B>(int&nbsp;mode,
                        int&nbsp;flags,
                        <A HREF="../../../javax/media/j3d/PickShape.html" title="class in javax.media.j3d">PickShape</A>&nbsp;pickShape)</PRE>
<DL>
<DD>Returns a PickInfo which references the pickable item  below this
 BranchGroup that intersects with <code>pickShape</code>.
 The accuracy of the pick is set by the pick mode. The mode include : 
 PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned 
 is specified via a masked variable, flags, indicating which components are 
 present in each returned PickInfo object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mode</CODE> - picking mode, one of <code>PickInfo.PICK_BOUNDS</code> or <code>PickInfo.PICK_GEOMETRY</code>.<DD><CODE>flags</CODE> - a mask indicating which components are present in each PickInfo object.  
 This is specified as one or more individual bits that are bitwise "OR"ed together to 
 describe the PickInfo data. The flags include :
 <ul>
 <code>PickInfo.SCENEGRAPHPATH</code> - request for computed SceneGraphPath.<br>    
 <code>PickInfo.NODE</code> - request for computed intersected Node.<br>
 <code>PickInfo.LOCAL_TO_VWORLD</code> - request for computed local to virtual world transform.<br>
 <code>PickInfo.CLOSEST_INTERSECTION_POINT</code> - request for closest intersection point.<br>
 <code>PickInfo.CLOSEST_DISTANCE</code> - request for the distance of closest intersection.<br>
 <code>PickInfo.CLOSEST_GEOM_INFO</code> - request for only the closest intersection geometry information.<br>
 <code>PickInfo.ALL_GEOM_INFO</code> - request for all intersection geometry information.<br>
 </ul><DD><CODE>pickShape</CODE> - the description of this picking volume or area.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if flags contains both CLOSEST_GEOM_INFO and 
 ALL_GEOM_INFO.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pickShape is a PickPoint and pick mode
 is set to PICK_GEOMETRY.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pick mode is neither PICK_BOUNDS 
 nor PICK_GEOMETRY.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pick mode is PICK_BOUNDS 
 and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
 CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if pickShape is PickBounds 
 and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
 CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
<DD><CODE>java.lang.IllegalStateException</CODE> - if BranchGroup is not live.
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if the mode is
 PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
 is not set in any Geometry objects referred to by any shape
 node whose bounds intersects the PickShape.
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if flags contains any of
 CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
 or ALL_GEOM_INFO, and the capability bits that control reading of
 coordinate data are not set in any GeometryArray object referred
 to by any shape node that intersects the PickShape.
 The capability bits that must be set to avoid this exception are as follows :
 <ul> 
 <li>By-copy geometry : GeometryArray.ALLOW_COORDINATE_READ</li>
 <li>By-reference geometry : GeometryArray.ALLOW_REF_DATA_READ</li>
 <li>Indexed geometry : IndexedGeometryArray.ALLOW_COORDINATE_INDEX_READ
 (in addition to one of the above)</li>
 </ul><DT><B>Since:</B></DT>
  <DD>Java 3D 1.4</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Locale.html#pickAny(int, int, javax.media.j3d.PickShape)"><CODE>Locale.pickAny(int,int,javax.media.j3d.PickShape)</CODE></A>, 
<A HREF="../../../javax/media/j3d/PickInfo.html" title="class in javax.media.j3d"><CODE>PickInfo</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="cloneNode(boolean)"><!-- --></A><H3>
cloneNode</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Node.html" title="class in javax.media.j3d">Node</A> <B>cloneNode</B>(boolean&nbsp;forceDuplicate)</PRE>
<DL>
<DD>Creates a new instance of the node.  This routine is called
 by <code>cloneTree</code> to duplicate the current node.
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="../../../javax/media/j3d/Group.html#cloneNode(boolean)">cloneNode</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Group.html" title="class in javax.media.j3d">Group</A></CODE></DL>
</DD>
<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>See Also:</B><DD><A HREF="../../../javax/media/j3d/Node.html#cloneTree()"><CODE>Node.cloneTree()</CODE></A>, 
<A HREF="../../../javax/media/j3d/Node.html#cloneNode(boolean)"><CODE>Node.cloneNode(boolean)</CODE></A>, 
<A HREF="../../../javax/media/j3d/Node.html#duplicateNode(javax.media.j3d.Node, boolean)"><CODE>Node.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>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <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/Bounds.html" title="class in javax.media.j3d"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/media/j3d/Canvas3D.html" title="class in javax.media.j3d"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?javax/media/j3d/BranchGroup.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="BranchGroup.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><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>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1">Copyright (c) 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../LICENSE-SPEC.html">license terms</a>.
</BODY>
</HTML>