pickobject.html

JAVA多媒体开发类库说明

 the scene in the direction of (xpos, ypos) specified in window space.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.
<DT><B>Returns:</B><DD>A PickShape object that is the constructed PickRay.</DL>
</DD>
</DL>
<HR>

<A NAME="pickAll(int, int)"><!-- --></A><H3>
pickAll</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>[] <B>pickAll</B>(int&nbsp;xpos,
                                int&nbsp;ypos)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns an array referencing all the items that are pickable below the
 <code>BranchGroup</code> (specified in the PickObject constructor) that
 intersect with a ray that starts at the 
 viewer position and points into the scene in the direction of (xpos, ypos)
 specified in window space. The resultant array is unordered.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.
<DT><B>Returns:</B><DD>The array of SceneGraphPath objects that contain Objects that
  were picked
 If no pickable object is found <code>null</code> is returned..<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAllSorted(int, int)"><!-- --></A><H3>
pickAllSorted</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>[] <B>pickAllSorted</B>(int&nbsp;xpos,
                                      int&nbsp;ypos)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a sorted array of references to all the Pickable items below the
 <code>BranchGroup</code> (specified in the PickObject constructor) that
 intersect with the ray that starts at the viewer 
 position and points into the scene in the direction of (xpos, ypos) 
 in the window space. 
 Element [0] references the item closest to viewer.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.
<DT><B>Returns:</B><DD>A sorted arrayof SceneGraphPath objects that contain Objects that
 were picked.  The array is sorted from closest to farthest from the
 viewer
 If no pickable object is found <code>null</code> is returned..<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAny(int, int)"><!-- --></A><H3>
pickAny</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A> <B>pickAny</B>(int&nbsp;xpos,
                              int&nbsp;ypos)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a reference to any item that is Pickable below the specified
 <code>BranchGroup</code> (specified in the PickObject constructor) which
  intersects with the ray that starts at the viewer 
 position and points into the scene in the direction of (xpos, ypos) in 
 window space.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.
<DT><B>Returns:</B><DD>A SceneGraphPath of an object that was picked.  This is not
 guarenteed to return the same result for multiple picks
 If no pickable object is found <code>null</code> is returned..<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickClosest(int, int)"><!-- --></A><H3>
pickClosest</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A> <B>pickClosest</B>(int&nbsp;xpos,
                                  int&nbsp;ypos)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a reference to the item that is closest to the viewer and is
 Pickable below the <code>BranchGroup</code> (specified in the PickObject
 constructor) which intersects with the ray that starts at 
 the viewer position and points into the scene in the direction of
 (xpos, ypos) in the window space.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.
<DT><B>Returns:</B><DD>A SceneGraphPath which contains the closest pickable object.
 If no pickable object is found, <code>null</code> is returned.<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAll(int, int, int)"><!-- --></A><H3>
pickAll</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>[] <B>pickAll</B>(int&nbsp;xpos,
                                int&nbsp;ypos,
                                int&nbsp;flag)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns an array referencing all the items that are pickable below the
 <code>BranchGroup</code> (specified in the PickObject constructor) that
 intersect with a ray that starts at the 
 viewer position and points into the scene in the direction of (xpos, ypos)
 specified in window space. The resultant array is unordered.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.<DD><CODE>flag</CODE> - Specifys picking by Geometry or Bounds.
<DT><B>Returns:</B><DD>The array of SceneGraphPath objects that contain Objects that
  were picked
 If no pickable object is found <code>null</code> is returned..<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAllSorted(int, int, int)"><!-- --></A><H3>
pickAllSorted</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>[] <B>pickAllSorted</B>(int&nbsp;xpos,
                                      int&nbsp;ypos,
                                      int&nbsp;flag)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a sorted array of references to all the Pickable items below the
 <code>BranchGroup</code> (specified in the PickObject constructor) that
 intersect with the ray that starts at the viewer 
 position and points into the scene in the direction of (xpos, ypos) 
 in the window space. 
 Element [0] references the item closest to viewer.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.<DD><CODE>flag</CODE> - Specifys picking by Geometry or Bounds.
<DT><B>Returns:</B><DD>A sorted arrayof SceneGraphPath objects that contain Objects that
 were picked.  The array is sorted from closest to farthest from the
 viewer
 If no pickable object is found <code>null</code> is returned..<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickAny(int, int, int)"><!-- --></A><H3>
pickAny</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A> <B>pickAny</B>(int&nbsp;xpos,
                              int&nbsp;ypos,
                              int&nbsp;flag)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a reference to any item that is Pickable below the specified
 <code>BranchGroup</code> (specified in the PickObject constructor) which
  intersects with the ray that starts at the viewer 
 position and points into the scene in the direction of (xpos, ypos) in 
 window space.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.<DD><CODE>flag</CODE> - Specifys picking by Geometry or Bounds.
<DT><B>Returns:</B><DD>A SceneGraphPath of an object that was picked.  This is not
 guarenteed to return the same result for multiple picks
 If no pickable object is found <code>null</code> is returned..<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickClosest(int, int, int)"><!-- --></A><H3>
pickClosest</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A> <B>pickClosest</B>(int&nbsp;xpos,
                                  int&nbsp;ypos,
                                  int&nbsp;flag)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a reference to the item that is closest to the viewer and is
 Pickable below the <code>BranchGroup</code> (specified in the PickObject
 constructor) which intersects with the ray that starts at 
 the viewer position and points into the scene in the direction of
 (xpos, ypos) in the window space.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xpos</CODE> - The value along the x-axis.<DD><CODE>ypos</CODE> - The value along the y-axis.<DD><CODE>flag</CODE> - Specifys picking by Geometry or Bounds.
<DT><B>Returns:</B><DD>A SceneGraphPath which contains the closest pickable object.
 If no pickable object is found, <code>null</code> is returned.<DT><B>See Also:</B><DD><A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d"><CODE>SceneGraphPath</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="pickNode(javax.media.j3d.SceneGraphPath, int)"><!-- --></A><H3>
pickNode</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/Node.html" title="class in javax.media.j3d">Node</A> <B>pickNode</B>(<A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>&nbsp;sgPath,
                     int&nbsp;flags)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a reference to a Pickable Node that
 is of the specified type
 that is contained in the specified SceneGraphPath.
 If more than one node of the same type is encountered, the node
 closest to the terminal node of SceneGraphPath will be returned.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sgPath</CODE> - the SceneGraphPath to be traversed.<DD><CODE>flags</CODE> - the Node types interested in picking.
<DT><B>Returns:</B><DD>the first occurrence of the specified Node type
 starting from the terminal node of SceneGraphPath. 
 If no pickable object is found of the  specifed types, 
 <code>null</code> is returned.</DL>
</DD>
</DL>
<HR>

<A NAME="pickNode(javax.media.j3d.SceneGraphPath, int, int)"><!-- --></A><H3>
pickNode</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/Node.html" title="class in javax.media.j3d">Node</A> <B>pickNode</B>(<A HREF="../../../../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>&nbsp;sgPath,
                     int&nbsp;flags,
                     int&nbsp;occurrence)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns a reference to a Pickable Node that
 is of the specified type
 that is contained in the specified SceneGraphPath.
 The Node returned is the nth <code>occurrence</code>
 of a Node that is of the specified type.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sgPath</CODE> - the SceneGraphPath to be traversed.<DD><CODE>flags</CODE> - the Node types interested.<DD><CODE>occurrence</CODE> - the occurrence of a Node that
 matches the specified type to return.  An <code>occurrence</code> of
 1 means to return the first occurrence of that object type (the object
 closest to the Locale).
<DT><B>Returns:</B><DD>the nth <code>occurrence</code> of a Node
 of type <code>flags</code>, starting from the Locale. If no pickable object is 
 found, <code>null</code> is returned.</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/behaviors/picking/PickMouseBehavior.html" title="class in com.sun.j3d.utils.behaviors.picking"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../../../com/sun/j3d/utils/behaviors/picking/PickRotateBehavior.html" title="class in com.sun.j3d.utils.behaviors.picking"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../../../index.html?com/sun/j3d/utils/behaviors/picking/PickObject.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="PickObject.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>