transformable.html

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

public void <B>scale</B>(float&nbsp;sx,
                  float&nbsp;sy,
                  float&nbsp;sz)</PRE>
<DL>
<DD><p>Multiplies the current scale component by the given scale
 factors. Denoting the current scale by (sx sy sz) and the given
 scale by (sx' sy' sz'), the new scale factors are computed as
 follows:</p>

 <blockquote>
 sx'' = sx * sx'<br>
 sy'' = sy * sy'<br>
 sz'' = sz * sz'<br>
 </blockquote

 <p>Since this is an operation on scalar values, the order of
 multiplication makes no difference. Unlike with the rotation
 component, separate methods for left and right multiplication
 are therefore not needed.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sx</CODE> - scale along the X axis<DD><CODE>sy</CODE> - scale along the Y axis<DD><CODE>sz</CODE> - scale along the Z axis<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#setScale(float, float, float)"><CODE>setScale</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getScale(float[])"><!-- --></A><H3>
getScale</H3>
<PRE>
public void <B>getScale</B>(float[]&nbsp;xyz)</PRE>
<DL>
<DD><p>Retrieves the scale component of this Transformable.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xyz</CODE> - a float array to fill in with <code>(sx sy sz)</code>
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>xyz</code> is null
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>xyz.length &lt; 3</code><DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#setScale(float, float, float)"><CODE>setScale</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setTranslation(float, float, float)"><!-- --></A><H3>
setTranslation</H3>
<PRE>
public void <B>setTranslation</B>(float&nbsp;tx,
                           float&nbsp;ty,
                           float&nbsp;tz)</PRE>
<DL>
<DD><p>Sets the translation component of this Transformable.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>tx</CODE> - translation along the X axis<DD><CODE>ty</CODE> - translation along the Y axis<DD><CODE>tz</CODE> - translation along the Z axis<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#getTranslation(float[])"><CODE>getTranslation</CODE></A>, 
<A HREF="../../../javax/microedition/m3g/Transformable.html#translate(float, float, float)"><CODE>translate</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="translate(float, float, float)"><!-- --></A><H3>
translate</H3>
<PRE>
public void <B>translate</B>(float&nbsp;tx,
                      float&nbsp;ty,
                      float&nbsp;tz)</PRE>
<DL>
<DD><p>Adds the given offset to the current translation component.
 Denoting the current translation component by (tx ty tz) and the
 given offset by (tx' ty' tz'), the new translation component is
 computed as follows:</p>

 <blockquote>
 tx'' = tx + tx'<br>
 ty'' = ty + ty'<br>
 tz'' = tz + tz'<br>
 </blockquote>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>tx</CODE> - translation along the X axis<DD><CODE>ty</CODE> - translation along the Y axis<DD><CODE>tz</CODE> - translation along the Z axis<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#setTranslation(float, float, float)"><CODE>setTranslation</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getTranslation(float[])"><!-- --></A><H3>
getTranslation</H3>
<PRE>
public void <B>getTranslation</B>(float[]&nbsp;xyz)</PRE>
<DL>
<DD><p>Retrieves the translation component of this Transformable.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xyz</CODE> - a float array to fill in with <code>(tx ty tz)</code>
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>xyz</code> is null
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>xyz.length &lt; 3</code><DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#setTranslation(float, float, float)"><CODE>setTranslation</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setTransform(javax.microedition.m3g.Transform)"><!-- --></A><H3>
setTransform</H3>
<PRE>
public void <B>setTransform</B>(<A HREF="../../../javax/microedition/m3g/Transform.html">Transform</A>&nbsp;transform)</PRE>
<DL>
<DD><p>Sets the matrix component of this Transformable by copying in
 the given Transform. This does not affect the separate translation,
 orientation and scale components.</p>

 <p>A generic matrix component is required for transformations that
 can not be expressed in the component form efficiently, or at all.
 These include, for example, pivot transforms and non-axis-aligned
 scales.</p>

 <p>If this Transformable is a Node object, the bottom row of the
 given matrix must be (0 0 0 1). Projective transformations are
 not supported in the scene graph so as to reduce run-time memory
 consumption and to accelerate rendering. Note, however, that
 arbitrary 4x4 modelview matrices are supported in the immediate
 mode.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>transform</CODE> - the Transform object to copy in, or null to indicate
        the identity matrix
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if this Transformable is a Node and
         the bottom row of <code>transform</code> is not (0 0 0 1)<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#getTransform(javax.microedition.m3g.Transform)"><CODE>getTransform</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getTransform(javax.microedition.m3g.Transform)"><!-- --></A><H3>
getTransform</H3>
<PRE>
public void <B>getTransform</B>(<A HREF="../../../javax/microedition/m3g/Transform.html">Transform</A>&nbsp;transform)</PRE>
<DL>
<DD><p>Retrieves the matrix component of this Transformable. This does
 not include the separate translation, orientation and scale components.
 The transformation is copied into the given Transform object.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>transform</CODE> - the Transform object to receive the
        transformation matrix
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>transform</code> is null<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/m3g/Transformable.html#setTransform(javax.microedition.m3g.Transform)"><CODE>setTransform</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getCompositeTransform(javax.microedition.m3g.Transform)"><!-- --></A><H3>
getCompositeTransform</H3>
<PRE>
public void <B>getCompositeTransform</B>(<A HREF="../../../javax/microedition/m3g/Transform.html">Transform</A>&nbsp;transform)</PRE>
<DL>
<DD><p>Retrieves the composite transformation matrix of this
 Transformable. The composite transformation matrix is the
 concatenation of the translation, rotation, scale and generic
 matrix components. Formally, <b>C</b> = <b>T</b> <b>R</b>
 <b>S</b> <b>M</b>. The composite transformation is copied
 into the given Transform object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>transform</CODE> - the Transform object to receive the composite
        transformation matrix
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>transform</code> is null</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/Transformable.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/Transform.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/microedition/m3g/TriangleStripArray.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="Transformable.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;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&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>