group.html

J2ME Mobile3D API,高性能手机3D开发的api

     float ox,
     float oy,
     float oz,
     float dx,
     float dy,
     float dz,
     <A HREF="../../../javax/microedition/m3g/RayIntersection.html">RayIntersection</A>&nbsp;ri)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Picks the first Mesh in this Group that is intercepted by
 the given pick ray and is in the specified <a href=
 "Node.html#Scoping">scope</a>. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/Group.html#removeChild(javax.microedition.m3g.Node)">removeChild</A></B>(<A HREF="../../../javax/microedition/m3g/Node.html">Node</A>&nbsp;child)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes the given node from this Group, potentially changing the
 order and indices of the remaining children. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.microedition.m3g.Node"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class javax.microedition.m3g.<A HREF="../../../javax/microedition/m3g/Node.html">Node</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/microedition/m3g/Node.html#align(javax.microedition.m3g.Node)">align</A>, <A HREF="../../../javax/microedition/m3g/Node.html#getAlphaFactor()">getAlphaFactor</A>, <A HREF="../../../javax/microedition/m3g/Node.html#getParent()">getParent</A>, <A HREF="../../../javax/microedition/m3g/Node.html#getScope()">getScope</A>, <A HREF="../../../javax/microedition/m3g/Node.html#getTransformTo(javax.microedition.m3g.Node, javax.microedition.m3g.Transform)">getTransformTo</A>, <A HREF="../../../javax/microedition/m3g/Node.html#isPickingEnabled()">isPickingEnabled</A>, <A HREF="../../../javax/microedition/m3g/Node.html#isRenderingEnabled()">isRenderingEnabled</A>, <A HREF="../../../javax/microedition/m3g/Node.html#setAlignment(javax.microedition.m3g.Node, int, javax.microedition.m3g.Node, int)">setAlignment</A>, <A HREF="../../../javax/microedition/m3g/Node.html#setAlphaFactor(float)">setAlphaFactor</A>, <A HREF="../../../javax/microedition/m3g/Node.html#setPickingEnable(boolean)">setPickingEnable</A>, <A HREF="../../../javax/microedition/m3g/Node.html#setRenderingEnable(boolean)">setRenderingEnable</A>, <A HREF="../../../javax/microedition/m3g/Node.html#setScope(int)">setScope</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.microedition.m3g.Transformable"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class javax.microedition.m3g.<A HREF="../../../javax/microedition/m3g/Transformable.html">Transformable</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/microedition/m3g/Transformable.html#getCompositeTransform(javax.microedition.m3g.Transform)">getCompositeTransform</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#getOrientation(float[])">getOrientation</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#getScale(float[])">getScale</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#getTransform(javax.microedition.m3g.Transform)">getTransform</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#getTranslation(float[])">getTranslation</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#postRotate(float, float, float, float)">postRotate</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#preRotate(float, float, float, float)">preRotate</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#scale(float, float, float)">scale</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#setOrientation(float, float, float, float)">setOrientation</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#setScale(float, float, float)">setScale</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#setTransform(javax.microedition.m3g.Transform)">setTransform</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#setTranslation(float, float, float)">setTranslation</A>, <A HREF="../../../javax/microedition/m3g/Transformable.html#translate(float, float, float)">translate</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.microedition.m3g.Object3D"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class javax.microedition.m3g.<A HREF="../../../javax/microedition/m3g/Object3D.html">Object3D</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/microedition/m3g/Object3D.html#addAnimationTrack(javax.microedition.m3g.AnimationTrack)">addAnimationTrack</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#animate(int)">animate</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#duplicate()">duplicate</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#find(int)">find</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#getAnimationTrack(int)">getAnimationTrack</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#getAnimationTrackCount()">getAnimationTrackCount</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#getReferences(javax.microedition.m3g.Object3D[])">getReferences</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#getUserID()">getUserID</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#getUserObject()">getUserObject</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#removeAnimationTrack(javax.microedition.m3g.AnimationTrack)">removeAnimationTrack</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#setUserID(int)">setUserID</A>, <A HREF="../../../javax/microedition/m3g/Object3D.html#setUserObject(java.lang.Object)">setUserObject</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="Group()"><!-- --></A><H3>
Group</H3>
<PRE>
public <B>Group</B>()</PRE>
<DL>
<DD><p>Constructs a new Group node and initializes it with an empty
 list of children. Properties inherited from Object3D and Node
 will have the default values as specified in their respective
 class descriptions.</p>
<P>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="addChild(javax.microedition.m3g.Node)"><!-- --></A><H3>
addChild</H3>
<PRE>
public void <B>addChild</B>(<A HREF="../../../javax/microedition/m3g/Node.html">Node</A>&nbsp;child)</PRE>
<DL>
<DD><p>Adds the given node to this Group, potentially changing the order and
 indices of the previously added children. The position at which the node
 is inserted among the existing children is deliberately left undefined.
 This gives implementations the freedom to select a data structure that
 best fits their needs, instead of mandating a particular kind of data
 structure.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>child</CODE> - the node to add; must not form a loop in the scene graph
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>child</code> is null
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>child</code> is this Group
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>child</code> is a World node
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>child</code> already has a
         parent
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>child</code> is an ancestor
         of this Group</DL>
</DD>
</DL>
<HR>

<A NAME="removeChild(javax.microedition.m3g.Node)"><!-- --></A><H3>
removeChild</H3>
<PRE>
public void <B>removeChild</B>(<A HREF="../../../javax/microedition/m3g/Node.html">Node</A>&nbsp;child)</PRE>
<DL>
<DD><p>Removes the given node from this Group, potentially changing the
 order and indices of the remaining children. If the given node is
 not a child of this Group, or is null, the request to remove it is
 silently ignored.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>child</CODE> - the node to remove
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if removing <code>child</code>
 would break a connection between a SkinnedMesh node and one of
 its transform references</DL>
</DD>
</DL>
<HR>

<A NAME="getChildCount()"><!-- --></A><H3>
getChildCount</H3>
<PRE>
public int <B>getChildCount</B>()</PRE>
<DL>
<DD><p>Gets the number of children in this Group.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the number of children directly attached to this group</DL>
</DD>
</DL>
<HR>

<A NAME="getChild(int)"><!-- --></A><H3>
getChild</H3>
<PRE>
public <A HREF="../../../javax/microedition/m3g/Node.html">Node</A> <B>getChild</B>(int&nbsp;index)</PRE>
<DL>
<DD><p>Gets a child by index. Valid indices range from zero up to
 the number of children minus one. Note that the index of any
 child may change whenever a node is added to or removed from
 this Group. See <code>addChild</code> for more information.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - index of the child node to get
<DT><B>Returns:</B><DD>the child node at the given index; can not be null
<DT><B>Throws:</B>
<DD><CODE>java.lang.IndexOutOfBoundsException</CODE> - if <code>(index &lt; 0) ||
         (index &gt;= getChildCount)</code></DL>
</DD>
</DL>
<HR>

<A NAME="pick(int, float, float, float, float, float, float, javax.microedition.m3g.RayIntersection)"><!-- --></A><H3>
pick</H3>
<PRE>
public boolean <B>pick</B>(int&nbsp;scope,
                    float&nbsp;ox,
                    float&nbsp;oy,
                    float&nbsp;oz,
                    float&nbsp;dx,
                    float&nbsp;dy,
                    float&nbsp;dz,
                    <A HREF="../../../javax/microedition/m3g/RayIntersection.html">RayIntersection</A>&nbsp;ri)</PRE>
<DL>
<DD><p>Picks the first Mesh in this Group that is intercepted by
 the given pick ray and is in the specified <a href=
 "Node.html#Scoping">scope</a>. Meshes that are <A HREF="../../../javax/microedition/m3g/Node.html#setPickingEnable(boolean)">disabled</A> or out of scope are ignored.
 Any ancestors of this Group, including their picking enable
 flags, are ignored. Winding and culling flags for each Mesh are
 respected when determining a hit, such that triangles culled
 based on their facing with respect to the pick ray are
 ignored.</p>

 <p>The pick ray is cast in the given direction from the given
 location in the coordinate system of this Group. The direction
 vector of the ray does not need to be unit length; the distance
 to the picked object is computed relative to the length of the
 given ray.</p>

 <p>Information about the picked object, if any, is filled in to
 the given RayIntersection object. If no intersection occurs, the
 RayIntersection object is left unmodified.</p>

 <p>This method ignores all Sprite3D nodes. This is because the
 camera parameters (that is, the projection matrix) are required