animationtrack.html

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

<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.MORPH_WEIGHTS">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="NEAR_DISTANCE"><!-- --></A><H3>
NEAR_DISTANCE</H3>
<PRE>
public static final int <B>NEAR_DISTANCE</B></PRE>
<DL>
<DD><p>Specifies the near distance of a Camera or Fog as an
 animation target. In case of a Camera target in perspective
 mode, negative values and zero are clamped to the smallest
 representable positive number. In case of a Fog target, or a
 camera target in parallel mode, the value is not clamped.</p>

 <p>Animating any of the camera parameters (near, far, field of
 view) only has an effect if the camera is in perspective or
 parallel mode.</p>

 <p>Number of components required: 1</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.NEAR_DISTANCE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ORIENTATION"><!-- --></A><H3>
ORIENTATION</H3>
<PRE>
public static final int <B>ORIENTATION</B></PRE>
<DL>
<DD><p>Specifies the orientation component of the transformation of
 a Transformable object as an animation target.</p>

 <p>The orientation is specified as a 4-element vector defining
 a quaternion. Quaternion keyframes are automatically normalized
 before interpolation; they need not be unit length on input. The
 quaternion components in the keyframes are ordered as follows:</p>
 
 <ul>
 <li>v[0] coefficient of i (related to the x component of the
     rotation axis)</li>
 <li>v[1] coefficient of j (related to the y component of the
     rotation axis)</li>
 <li>v[2] coefficient of k (related to the z component of the
     rotation axis)</li>
 <li>v[3] the scalar component (related to the rotation angle)</li>
 </ul>

 <p>Number of components required: 4</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.ORIENTATION">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PICKABILITY"><!-- --></A><H3>
PICKABILITY</H3>
<PRE>
public static final int <B>PICKABILITY</B></PRE>
<DL>
<DD><p>Specifies the picking enable flag of a Node as an animation
 target.</p>

 <p>Number of components required: 1</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.PICKABILITY">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="SCALE"><!-- --></A><H3>
SCALE</H3>
<PRE>
public static final int <B>SCALE</B></PRE>
<DL>
<DD><p>Specifies the scaling component of the transformation of a
 Transformable object as an animation target. The number of
 keyframe components in the associated KeyframeSequence can be
 either one or three, for uniform or non-uniform scaling,
 respectively.</p>

 <p>Number of components required: 1 or 3 (XYZ)</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.SCALE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="SHININESS"><!-- --></A><H3>
SHININESS</H3>
<PRE>
public static final int <B>SHININESS</B></PRE>
<DL>
<DD><p>Specifies the shininess of a Material as an animation target.
 The interpolated value is clamped to the range [0, 128].</p>

 <p>Number of components required: 1</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.SHININESS">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="SPECULAR_COLOR"><!-- --></A><H3>
SPECULAR_COLOR</H3>
<PRE>
public static final int <B>SPECULAR_COLOR</B></PRE>
<DL>
<DD><p>Specifies the specular color of a Material as an animation target.
 The interpolated value of each color component is clamped to the
 range [0, 1].</p>

 <p>Number of components required: 3 (RGB)</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.SPECULAR_COLOR">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="SPOT_ANGLE"><!-- --></A><H3>
SPOT_ANGLE</H3>
<PRE>
public static final int <B>SPOT_ANGLE</B></PRE>
<DL>
<DD><p>Specifies the spot angle of a Light as an animation target. The
 interpolated value is clamped to the range [0, 90].</p>

 <p>Number of components required: 1</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.SPOT_ANGLE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="SPOT_EXPONENT"><!-- --></A><H3>
SPOT_EXPONENT</H3>
<PRE>
public static final int <B>SPOT_EXPONENT</B></PRE>
<DL>
<DD><p>Specifies the spot exponent of a Light as an animation target.
 The interpolated value is clamped to the range [0, 128].</p>

 <p>Number of components required: 1</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.SPOT_EXPONENT">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="TRANSLATION"><!-- --></A><H3>
TRANSLATION</H3>
<PRE>
public static final int <B>TRANSLATION</B></PRE>
<DL>
<DD><p>Specifies the translation component of the transformation of
 a Transformable object as an animation target.</p>

 <p>Number of components required: 3 (XYZ)</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.TRANSLATION">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="VISIBILITY"><!-- --></A><H3>
VISIBILITY</H3>
<PRE>
public static final int <B>VISIBILITY</B></PRE>
<DL>
<DD><p>Specifies the rendering enable flag of a Node as an animation
 target.</p>

 <p>Number of components required: 1</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.m3g.AnimationTrack.VISIBILITY">Constant Field Values</A></DL>
</DL>

<!-- ========= 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="AnimationTrack(javax.microedition.m3g.KeyframeSequence, int)"><!-- --></A><H3>
AnimationTrack</H3>
<PRE>
public <B>AnimationTrack</B>(<A HREF="../../../javax/microedition/m3g/KeyframeSequence.html">KeyframeSequence</A>&nbsp;sequence,
                      int&nbsp;property)</PRE>
<DL>
<DD><p>Creates an animation track with the given keyframe sequence targeting
 the given property. The keyframe sequence must be compatible with the
 target property; for example, to animate the translation component of
 a transformation, the keyframes must be 3-element vectors.</p>

 <p>No controller is initially attached to the track.</p>
<P>
<DT><B>Parameters:</B><DD><CODE>sequence</CODE> - a KeyframeSequence containing the keyframe data for
 this animation track<DD><CODE>property</CODE> - one of <code>ALPHA, ..., VISIBILITY</code>
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>sequence</code> is null
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>property</code> is
 not one of the symbolic constants listed above
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>sequence</code> is not
 compatible with <code>property</code></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="setController(javax.microedition.m3g.AnimationController)"><!-- --></A><H3>
setController</H3>
<PRE>
public void <B>setController</B>(<A HREF="../../../javax/microedition/m3g/AnimationController.html">AnimationController</A>&nbsp;controller)</PRE>
<DL>
<DD><p>Specifies the animation controller to be used for controlling this
 animation track. The controller determines the mapping from world time
 to sequence time, the speed of animation, and the active interval for
 all tracks under its control.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>controller</CODE> - an AnimationController object which defines
 the active state and sequence time for this animation sequence;
 if this is null then the behaviour is equivalent to associating
 this object with an inactive animation controller<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/AnimationTrack.html#getController()"><CODE>getController</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getController()"><!-- --></A><H3>
getController</H3>
<PRE>
public <A HREF="../../../javax/microedition/m3g/AnimationController.html">AnimationController</A> <B>getController</B>()</PRE>
<DL>
<DD><p>Retrieves the animation controller used for controlling this
 animation track.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the AnimationController object which defines the active
 state and sequence time for this animation sequence, as set by
 <code>setController</code>. If no controller has yet been
 attached, this method returns null<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/AnimationTrack.html#setController(javax.microedition.m3g.AnimationController)"><CODE>setController</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getKeyframeSequence()"><!-- --></A><H3>
getKeyframeSequence</H3>
<PRE>
public <A HREF="../../../javax/microedition/m3g/KeyframeSequence.html">KeyframeSequence</A> <B>getKeyframeSequence</B>()</PRE>
<DL>
<DD><p>Returns the keyframe sequence object which defines the keyframe
 values for this animation track.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the KeyframeSequence object which defines the keyframe
 values</DL>
</DD>
</DL>
<HR>

<A NAME="getTargetProperty()"><!-- --></A><H3>
getTargetProperty</H3>
<PRE>
public int <B>getTargetProperty</B>()</PRE>
<DL>
<DD><p>Returns the property targeted by this AnimationTrack. The target
 property is one of the symbolic constants listed above.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the object property targeted by this track</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <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="class-use/AnimationTrack.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&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-files/index-1.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><B>Nov 19, 2003</B></EM></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/microedition/m3g/AnimationController.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/microedition/m3g/Appearance.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="AnimationTrack.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;
<SCRIPT>
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html" TARGET=""><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>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<EM>Copyright &copy 2003 Nokia Corporation. See the <a href="../../../overview-summary.html#Copyright">Copyright Notice</a> for details.</EM>
</BODY>
</HTML>