gmatrix.html

JAVA多媒体开发类库说明

 zero, nRow and nCol will be one larger than the maximum
 possible matrix index values.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>nRow</CODE> - number of rows in this matrix.<DD><CODE>nCol</CODE> - number of columns in this matrix.<DD><CODE>matrix</CODE> - a 1D array that specifies a matrix in row major fashion</DL>
</DL>
<HR>

<A NAME="GMatrix(javax.vecmath.GMatrix)"><!-- --></A><H3>
GMatrix</H3>
<PRE>
public <B>GMatrix</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;matrix)</PRE>
<DL>
<DD>Constructs a new GMatrix and copies the initial values
 from the parameter matrix.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>matrix</CODE> - the source of the initial values of the new GMatrix</DL>
</DL>

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

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

<A NAME="mul(javax.vecmath.GMatrix)"><!-- --></A><H3>
mul</H3>
<PRE>
public final void <B>mul</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1)</PRE>
<DL>
<DD>Sets the value of this matrix to the result of multiplying itself
 with matrix m1 (this = this * m1).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the other matrix</DL>
</DD>
</DL>
<HR>

<A NAME="mul(javax.vecmath.GMatrix, javax.vecmath.GMatrix)"><!-- --></A><H3>
mul</H3>
<PRE>
public final void <B>mul</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1,
                      <A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m2)</PRE>
<DL>
<DD>Sets the value of this matrix to the result of multiplying
 the two argument matrices together (this = m1 * m2).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the first matrix<DD><CODE>m2</CODE> - the second matrix</DL>
</DD>
</DL>
<HR>

<A NAME="mul(javax.vecmath.GVector, javax.vecmath.GVector)"><!-- --></A><H3>
mul</H3>
<PRE>
public final void <B>mul</B>(<A HREF="../../javax/vecmath/GVector.html" title="class in javax.vecmath">GVector</A>&nbsp;v1,
                      <A HREF="../../javax/vecmath/GVector.html" title="class in javax.vecmath">GVector</A>&nbsp;v2)</PRE>
<DL>
<DD>Computes the outer product of the two vectors; multiplies the
 the first vector by the transpose of the second vector and places
 the matrix result into this matrix.  This matrix must be
 be as big or bigger than getSize(v1)xgetSize(v2).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>v1</CODE> - the first vector, treated as a row vector<DD><CODE>v2</CODE> - the second vector, treated as a column vector</DL>
</DD>
</DL>
<HR>

<A NAME="add(javax.vecmath.GMatrix)"><!-- --></A><H3>
add</H3>
<PRE>
public final void <B>add</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1)</PRE>
<DL>
<DD>Sets the value of this matrix to sum of itself and matrix m1.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the other matrix</DL>
</DD>
</DL>
<HR>

<A NAME="add(javax.vecmath.GMatrix, javax.vecmath.GMatrix)"><!-- --></A><H3>
add</H3>
<PRE>
public final void <B>add</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1,
                      <A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m2)</PRE>
<DL>
<DD>Sets the value of this matrix to the matrix sum of matrices m1 and m2.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the first matrix<DD><CODE>m2</CODE> - the second matrix</DL>
</DD>
</DL>
<HR>

<A NAME="sub(javax.vecmath.GMatrix)"><!-- --></A><H3>
sub</H3>
<PRE>
public final void <B>sub</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1)</PRE>
<DL>
<DD>Sets the value of this matrix to the matrix difference of itself
 and matrix m1 (this = this - m1).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the other matrix</DL>
</DD>
</DL>
<HR>

<A NAME="sub(javax.vecmath.GMatrix, javax.vecmath.GMatrix)"><!-- --></A><H3>
sub</H3>
<PRE>
public final void <B>sub</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1,
                      <A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m2)</PRE>
<DL>
<DD>Sets the value of this matrix to the matrix difference
 of matrices m1 and m2 (this = m1 - m2).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the first matrix<DD><CODE>m2</CODE> - the second matrix</DL>
</DD>
</DL>
<HR>

<A NAME="negate()"><!-- --></A><H3>
negate</H3>
<PRE>
public final void <B>negate</B>()</PRE>
<DL>
<DD>Negates the value of this matrix: this = -this.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="negate(javax.vecmath.GMatrix)"><!-- --></A><H3>
negate</H3>
<PRE>
public final void <B>negate</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1)</PRE>
<DL>
<DD>Sets the value of this matrix equal to the negation of
  of the GMatrix parameter.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - The source matrix</DL>
</DD>
</DL>
<HR>

<A NAME="setIdentity()"><!-- --></A><H3>
setIdentity</H3>
<PRE>
public final void <B>setIdentity</B>()</PRE>
<DL>
<DD>Sets this GMatrix to the identity matrix.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setZero()"><!-- --></A><H3>
setZero</H3>
<PRE>
public final void <B>setZero</B>()</PRE>
<DL>
<DD>Sets all the values in this matrix to zero.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="identityMinus()"><!-- --></A><H3>
identityMinus</H3>
<PRE>
public final void <B>identityMinus</B>()</PRE>
<DL>
<DD>Subtracts this matrix from the identity matrix and puts the values
 back into this (this = I - this).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="invert()"><!-- --></A><H3>
invert</H3>
<PRE>
public final void <B>invert</B>()</PRE>
<DL>
<DD>Inverts this matrix in place.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="invert(javax.vecmath.GMatrix)"><!-- --></A><H3>
invert</H3>
<PRE>
public final void <B>invert</B>(<A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;m1)</PRE>
<DL>
<DD>Inverts matrix m1 and places the new values into this matrix.  Matrix
 m1 is not modified.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the matrix to be inverted</DL>
</DD>
</DL>
<HR>

<A NAME="copySubMatrix(int, int, int, int, int, int, javax.vecmath.GMatrix)"><!-- --></A><H3>
copySubMatrix</H3>
<PRE>
public final void <B>copySubMatrix</B>(int&nbsp;rowSource,
                                int&nbsp;colSource,
                                int&nbsp;numRow,
                                int&nbsp;numCol,
                                int&nbsp;rowDest,
                                int&nbsp;colDest,
                                <A HREF="../../javax/vecmath/GMatrix.html" title="class in javax.vecmath">GMatrix</A>&nbsp;target)</PRE>
<DL>
<DD>Copies a sub-matrix derived from this matrix into the target matrix.
 The upper left of the sub-matrix is located at (rowSource, colSource);
 the lower right of the sub-matrix is located at 
 (lastRowSource,lastColSource).  The sub-matrix is copied into the
 the target matrix starting at (rowDest, colDest).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>rowSource</CODE> - the top-most row of the sub-matrix<DD><CODE>colSource</CODE> - the left-most column of the sub-matrix<DD><CODE>numRow</CODE> - the number of rows in the sub-matrix<DD><CODE>numCol</CODE> - the number of columns in the sub-matrix<DD><CODE>rowDest</CODE> - the top-most row of the position of the copied
                 sub-matrix within the target matrix<DD><CODE>colDest</CODE> - the left-most column of the position of the copied
                 sub-matrix within the target matrix<DD><CODE>target</CODE> - the matrix into which the sub-matrix will be copied</DL>
</DD>
</DL>
<HR>

<A NAME="setSize(int, int)"><!-- --></A><H3>
setSize</H3>
<PRE>
public final void <B>setSize</B>(int&nbsp;nRow,
                          int&nbsp;nCol)</PRE>
<DL>
<DD>Changes the size of this matrix dynamically.  If the size is increased
 no data values will be lost.  If the size is decreased, only those data
 values whose matrix positions were eliminated will be lost.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nRow</CODE> - number of desired rows in this matrix<DD><CODE>nCol</CODE> - number of desired columns in this matrix</DL>
</DD>
</DL>
<HR>

<A NAME="set(double[])"><!-- --></A><H3>
set</H3>
<PRE>
public final void <B>set</B>(double[]&nbsp;matrix)</PRE>
<DL>
<DD>Sets the value of this matrix to the values found in the array parameter.
 The values are copied in one row at a time, in row major 
 fashion.  The array should be at least equal in length to
 the number of matrix rows times the number of matrix columns
 in this matrix.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>matrix</CODE> - the row major source array</DL>
</DD>
</DL>
<HR>

<A NAME="set(javax.vecmath.Matrix3f)"><!-- --></A><H3>
set</H3>
<PRE>
public final void <B>set</B>(<A HREF="../../javax/vecmath/Matrix3f.html" title="class in javax.vecmath">Matrix3f</A>&nbsp;m1)</PRE>
<DL>
<DD>Sets the value of this matrix to that of the Matrix3f provided.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>m1</CODE> - the matrix</DL>
</DD>
</DL>
<HR>

<A NAME="set(javax.vecmath.Matrix3d)"><!-- --></A><H3>
set</H3>