picktool.html

JAVA多媒体开发类库说明

                                   int&nbsp;level)</PRE>
<DL>
<DD>Sets the capabilities on the Node and it's components to allow
 picking at the specified detail level.  
 <p> 
 Note that by default all com.sun.j3d.utils.geometry.Primitive
 objects with the same parameters share their geometry (e.g.,
 you can have 50 spheres in your scene, but the geometry is
 stored only once).  Therefore the capabilities of the geometry
 are also shared, and once a shared node is live, the
 capabilities cannot be changed.  To assign capabilities to
 Primitives with the same parameters, either set the
 capabilities before the primitive is set live, or specify the
 Primitive.GEOMETRY_NOT_SHARED constructor parameter when
 creating the primitive.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>node</CODE> - The node to modify<DD><CODE>level</CODE> - The capability level, must be one of INTERSECT_TEST,
  INTERSECT_COORD or INTERSECT_FULL
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if Node is not a Shape3D or Morph or
        if the flag value is not valid.
<DD><CODE><A HREF="../../../../../javax/media/j3d/RestrictedAccessException.html" title="class in javax.media.j3d">RestrictedAccessException</A></CODE> - if the node is part 
  of a live or compiled scene graph.</DL>
</DD>
</DL>
<HR>

<A NAME="setShape(javax.media.j3d.PickShape, javax.vecmath.Point3d)"><!-- --></A><H3>
setShape</H3>
<PRE>
public void <B>setShape</B>(<A HREF="../../../../../javax/media/j3d/PickShape.html" title="class in javax.media.j3d">PickShape</A>&nbsp;ps,
                     <A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;startPt)</PRE>
<DL>
<DD>Sets the pick shape to a user-provided PickShape object
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ps</CODE> - The pick shape to pick against.<DD><CODE>startPt</CODE> - The start point to use for distance calculations</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeBounds(javax.media.j3d.Bounds, javax.vecmath.Point3d)"><!-- --></A><H3>
setShapeBounds</H3>
<PRE>
public void <B>setShapeBounds</B>(<A HREF="../../../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A>&nbsp;bounds,
                           <A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;startPt)</PRE>
<DL>
<DD>Sets the pick shape to use a user-provided Bounds object
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bounds</CODE> - The bounds to pick against.<DD><CODE>startPt</CODE> - The start point to use for distance calculations</DL>
</DD>
</DL>
<HR>

<A NAME="setMode(int)"><!-- --></A><H3>
setMode</H3>
<PRE>
public void <B>setMode</B>(int&nbsp;mode)</PRE>
<DL>
<DD>Sets the picking detail mode.  The default is BOUNDS.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mode</CODE> - One of BOUNDS, GEOMETRY, GEOMETRY_INTERSECT_INFO, or
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if mode is not a legal value</DL>
</DD>
</DL>
<HR>

<A NAME="getMode()"><!-- --></A><H3>
getMode</H3>
<PRE>
public int <B>getMode</B>()</PRE>
<DL>
<DD>Gets the picking detail mode.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeRay(javax.vecmath.Point3d, javax.vecmath.Vector3d)"><!-- --></A><H3>
setShapeRay</H3>
<PRE>
public void <B>setShapeRay</B>(<A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;start,
                        <A HREF="../../../../../javax/vecmath/Vector3d.html" title="class in javax.vecmath">Vector3d</A>&nbsp;dir)</PRE>
<DL>
<DD>Sets the pick shape to a PickRay.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start</CODE> - The start of the ray<DD><CODE>dir</CODE> - The direction of the ray</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeSegment(javax.vecmath.Point3d, javax.vecmath.Point3d)"><!-- --></A><H3>
setShapeSegment</H3>
<PRE>
public void <B>setShapeSegment</B>(<A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;start,
                            <A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;end)</PRE>
<DL>
<DD>Sets the pick shape to a PickSegment.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start</CODE> - The start of the segment
p        @param end The end of the segment</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeCylinderSegment(javax.vecmath.Point3d, javax.vecmath.Point3d, double)"><!-- --></A><H3>
setShapeCylinderSegment</H3>
<PRE>
public void <B>setShapeCylinderSegment</B>(<A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;start,
                                    <A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;end,
                                    double&nbsp;radius)</PRE>
<DL>
<DD>Sets the pick shape to a capped PickCylinder
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start</CODE> - The start of axis of the cylinder<DD><CODE>end</CODE> - The end of the axis of the cylinder<DD><CODE>radius</CODE> - The radius of the cylinder</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeCylinderRay(javax.vecmath.Point3d, javax.vecmath.Vector3d, double)"><!-- --></A><H3>
setShapeCylinderRay</H3>
<PRE>
public void <B>setShapeCylinderRay</B>(<A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;start,
                                <A HREF="../../../../../javax/vecmath/Vector3d.html" title="class in javax.vecmath">Vector3d</A>&nbsp;dir,
                                double&nbsp;radius)</PRE>
<DL>
<DD>Sets the pick shape to an infinite PickCylinder.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start</CODE> - The start of axis of the cylinder<DD><CODE>dir</CODE> - The direction of the axis of the cylinder<DD><CODE>radius</CODE> - The radius of the cylinder</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeConeSegment(javax.vecmath.Point3d, javax.vecmath.Point3d, double)"><!-- --></A><H3>
setShapeConeSegment</H3>
<PRE>
public void <B>setShapeConeSegment</B>(<A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;start,
                                <A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;end,
                                double&nbsp;angle)</PRE>
<DL>
<DD>Sets the pick shape to a capped PickCone
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start</CODE> - The start of axis of the cone<DD><CODE>end</CODE> - The end of the axis of the cone<DD><CODE>angle</CODE> - The angle of the cone</DL>
</DD>
</DL>
<HR>

<A NAME="setShapeConeRay(javax.vecmath.Point3d, javax.vecmath.Vector3d, double)"><!-- --></A><H3>
setShapeConeRay</H3>
<PRE>
public void <B>setShapeConeRay</B>(<A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;start,
                            <A HREF="../../../../../javax/vecmath/Vector3d.html" title="class in javax.vecmath">Vector3d</A>&nbsp;dir,
                            double&nbsp;angle)</PRE>
<DL>
<DD>Sets the pick shape to an infinite PickCone.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>start</CODE> - The start of axis of the cone<DD><CODE>dir</CODE> - The direction of the axis of the cone<DD><CODE>angle</CODE> - The angle of the cone</DL>
</DD>
</DL>
<HR>

<A NAME="getPickShape()"><!-- --></A><H3>
getPickShape</H3>
<PRE>
public <A HREF="../../../../../javax/media/j3d/PickShape.html" title="class in javax.media.j3d">PickShape</A> <B>getPickShape</B>()</PRE>
<DL>
<DD>Returns the PickShape for this object.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getStartPosition()"><!-- --></A><H3>
getStartPosition</H3>
<PRE>
public <A HREF="../../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A> <B>getStartPosition</B>()</PRE>
<DL>
<DD>Returns the start postion used for distance measurement.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="pickAll()"><!-- --></A><H3>
pickAll</H3>
<PRE>
public <A HREF="../../../../../com/sun/j3d/utils/picking/PickResult.html" title="class in com.sun.j3d.utils.picking">PickResult</A>[] <B>pickAll</B>()</PRE>
<DL>
<DD>Selects all the nodes that intersect the PickShape.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>An array of <code>PickResult</code> objects which will contain 
       information about the picked instances. <code>null</code> if nothing was 
       picked.</DL>
</DD>
</DL>
<HR>

<A NAME="pickAny()"><!-- --></A><H3>
pickAny</H3>
<PRE>
public <A HREF="../../../../../com/sun/j3d/utils/picking/PickResult.html" title="class in com.sun.j3d.utils.picking">PickResult</A> <B>pickAny</B>()</PRE>
<DL>
<DD>Select one of the nodes that intersect the PickShape
<P>
<DD><DL>

<DT><B>Returns:</B><DD>A <code>PickResult</code> object which will contain 
         information about the picked instance. <code>null</code> if nothing 
         was picked.</DL>
</DD>
</DL>
<HR>

<A NAME="pickAllSorted()"><!-- --></A><H3>
pickAllSorted</H3>
<PRE>
public <A HREF="../../../../../com/sun/j3d/utils/picking/PickResult.html" title="class in com.sun.j3d.utils.picking">PickResult</A>[] <B>pickAllSorted</B>()</PRE>
<DL>
<DD>Select all the nodes that intersect the 
        PickShape, returned sorted. The "closest" object will be returned first.
        See note above to see how "closest" is determined.    
        <p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>An array of <code>PickResult</code> objects which will contain 
        information 
        about the picked instances. <code>null</code> if nothing was picked.</DL>
</DD>
</DL>
<HR>

<A NAME="pickClosest()"><!-- --></A><H3>
pickClosest</H3>
<PRE>
public <A HREF="../../../../../com/sun/j3d/utils/picking/PickResult.html" title="class in com.sun.j3d.utils.picking">PickResult</A> <B>pickClosest</B>()</PRE>
<DL>
<DD>Select the closest node that 
        intersects the PickShape. See note above to see how "closest" is 
        determined.
        <p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>A <code>PickResult</code> object which will contain 
        information about the picked instance. <code>null</code> if nothing 
        was picked.</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="../../../../../com/sun/j3d/utils/picking/PickResult.html" title="class in com.sun.j3d.utils.picking"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../../index.html?com/sun/j3d/utils/picking/PickTool.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="PickTool.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>