node.html

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

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the rendering enable flag of this Node. </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/Node.html#setScope(int)">setScope</A></B>(int&nbsp;scope)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the scope of this node. </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 =========== -->

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

<A NAME="NONE"><!-- --></A><H3>
NONE</H3>
<PRE>
public static final int <B>NONE</B></PRE>
<DL>
<DD><p>Specifies for the <code>setAlignment</code> method that no
 alignment should be done for the specified axis.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.Node.NONE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ORIGIN"><!-- --></A><H3>
ORIGIN</H3>
<PRE>
public static final int <B>ORIGIN</B></PRE>
<DL>
<DD><p>Specifies the origin of the reference node as an orientation 
 reference for the <code>setAlignment</code> method.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.Node.ORIGIN">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="X_AXIS"><!-- --></A><H3>
X_AXIS</H3>
<PRE>
public static final int <B>X_AXIS</B></PRE>
<DL>
<DD><p>Specifies the X axis of the reference node as an orientation
 reference for the <code>setAlignment</code> method.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.Node.X_AXIS">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="Y_AXIS"><!-- --></A><H3>
Y_AXIS</H3>
<PRE>
public static final int <B>Y_AXIS</B></PRE>
<DL>
<DD><p>Specifies the Y axis of the reference node as an orientation
 reference for the <code>setAlignment</code> method.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.Node.Y_AXIS">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="Z_AXIS"><!-- --></A><H3>
Z_AXIS</H3>
<PRE>
public static final int <B>Z_AXIS</B></PRE>
<DL>
<DD><p>Specifies the Z axis of the reference node as an orientation
 reference for the <code>setAlignment</code> method.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.Node.Z_AXIS">Constant Field Values</A></DL>
</DL>

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


<!-- ============ 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="setRenderingEnable(boolean)"><!-- --></A><H3>
setRenderingEnable</H3>
<PRE>
public void <B>setRenderingEnable</B>(boolean&nbsp;enable)</PRE>
<DL>
<DD><p>Sets the rendering enable flag of this Node. The effective
 rendering enable status for this node is the logical AND of the
 enable flags on this node and all its ancestors. Therefore, the
 node is disabled if any of its ancestors are. The node's own
 status has an effect only if all the ancestors are enabled.</p>

 <p>If the effective status is <i>true</i>, this node is enabled
 for rendering; otherwise, it is disabled. Sprite3D, Mesh and Light
 nodes are turned on and off with this setting, but on Camera
 nodes it is ignored.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>enable</CODE> - <i>true</i> to enable rendering; <i>false</i> to disable</DL>
</DD>
</DL>
<HR>

<A NAME="setPickingEnable(boolean)"><!-- --></A><H3>
setPickingEnable</H3>
<PRE>
public void <B>setPickingEnable</B>(boolean&nbsp;enable)</PRE>
<DL>
<DD><p>Sets the picking enable flag of this Node. The effective
 picking enable status for this node is the logical AND of the
 enable flags on this node and all its ancestors. Therefore, the
 node is disabled if any of its ancestors are. The node's own
 status has an effect only if all the ancestors are enabled.</p>

 <p>If the effective status is <i>true</i>, this node is enabled
 for picking; otherwise, it is disabled. This setting is ignored
 for Lights and Cameras, because they are unpickable in any case.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>enable</CODE> - <i>true</i> to enable picking; <i>false</i> to disable</DL>
</DD>
</DL>
<HR>

<A NAME="setScope(int)"><!-- --></A><H3>
setScope</H3>
<PRE>
public void <B>setScope</B>(int&nbsp;scope)</PRE>
<DL>
<DD><p>Sets the scope of this node. The scope is used to limit the
 set of nodes that are taken into account in rendering, lighting
 and picking. See the class description for more information.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>scope</CODE> - the new scope for this node<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Node.html#getScope()"><CODE>getScope</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setAlphaFactor(float)"><!-- --></A><H3>
setAlphaFactor</H3>
<PRE>
public void <B>setAlphaFactor</B>(float&nbsp;alphaFactor)</PRE>
<DL>
<DD><p>Sets the alpha factor for this Node. This can be used to
 fade groups of meshes in and out. The alpha factor has no
 effect on Sprite3D, Light and Camera nodes. See the class
 description for more information.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alphaFactor</CODE> - the new alpha factor for this node; must be [0, 1]
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>alphaFactor</code> is
         negative or greater than 1.0<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Node.html#getAlphaFactor()"><CODE>getAlphaFactor</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isRenderingEnabled()"><!-- --></A><H3>
isRenderingEnabled</H3>
<PRE>
public boolean <B>isRenderingEnabled</B>()</PRE>
<DL>
<DD><p>Retrieves the rendering enable flag of this Node. Note that
 this is not the effective rendering enable status, but only the
 local status of this Node.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the rendering enable flag of this Node<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Node.html#setRenderingEnable(boolean)"><CODE>setRenderingEnable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isPickingEnabled()"><!-- --></A><H3>
isPickingEnabled</H3>
<PRE>
public boolean <B>isPickingEnabled</B>()</PRE>
<DL>
<DD><p>Retrieves the picking enable flag of this Node. Note that
 this is not the effective picking enable status, but only the
 local status of this Node.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the picking enable flag of this Node<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Node.html#setPickingEnable(boolean)"><CODE>setPickingEnable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getScope()"><!-- --></A><H3>
getScope</H3>
<PRE>
public int <B>getScope</B>()</PRE>
<DL>