A two dimensional array of numbers. Row and column numbering begins with zero. The API for
this interface matches closely the API in various
implementations available in Java3D,
which should enable straightforward implementations. Java3D provides matrix for the general
case and optimized versions for 3×3 and 4×4 cases, which are quite common in a
transformation package.
invalid @linkplain
matrix
- Since:
- 1.0
- See Also:
-
-
invalid @see
javax.vecmath.Matrix3d -
invalid @see
javax.vecmath.Matrix4d -
invalid @see
javax.vecmath.GMatrix AffineTransform-
invalid @see
javax.media.jai.PerspectiveTransform -
invalid @see
javax.media.j3d.Transform3D - Jama matrix
-
-
Method Summary
Modifier and TypeMethodDescriptionclone()Returns a clone of this matrix.doublegetElement(int row, int column) Retrieves the value at the specified row and column of this matrix.intReturns the number of columns in this matrix.intReturns the number of rows in this matrix.booleanReturnstrueif this matrix is an identity matrix.voidsetElement(int row, int column, double value) Modifies the value at the specified row and column of this matrix.
-
Method Details
-
getNumRow
int getNumRow()Returns the number of rows in this matrix.- Returns:
- The number of rows in this matrix.
- Departure from OGC/ISO abstract specification:
Departure for closer integration with the Java environment
Needed for making the matrix usable. The method signature matches the one ofGMatrixin the vecmath package, for straightforward implementation.
-
getNumCol
int getNumCol()Returns the number of columns in this matrix.- Returns:
- The number of columns in this matrix.
- Departure from OGC/ISO abstract specification:
Departure for closer integration with the Java environment
Needed for making the matrix usable. The method signature matches the one ofGMatrixin the vecmath package, for straightforward implementation.
-
getElement
double getElement(int row, int column) Retrieves the value at the specified row and column of this matrix.- Parameters:
row- The row number to be retrieved (zero indexed).column- The column number to be retrieved (zero indexed).- Returns:
- The value at the indexed element.
- Departure from OGC/ISO abstract specification:
Departure for closer integration with the Java environment
Needed for making the matrix usable. The method signature matches the one ofGMatrixin the vecmath package, for straightforward implementation.
-
setElement
void setElement(int row, int column, double value) Modifies the value at the specified row and column of this matrix.- Parameters:
row- The row number to be retrieved (zero indexed).column- The column number to be retrieved (zero indexed).value- The new matrix element value.- Departure from OGC/ISO abstract specification:
Departure for closer integration with the Java environment
Needed for making the matrix usable. The method signature matches the one ofGMatrixin the vecmath package, for straightforward implementation.
-
isIdentity
boolean isIdentity()Returnstrueif this matrix is an identity matrix.- Returns:
trueif this matrix is an identity matrix.- Departure from OGC/ISO abstract specification:
Extension for convenience without introduction of new functionality
Added as a convenience for a frequently requested operation.
-
clone
Matrix clone()Returns a clone of this matrix.- Returns:
- A clone of this matrix.
-