Matrix3
public final class Matrix3
An immutable 3x3 matrix that represents rotation and scale. The matrix is column major and right handed. The indexes of dataToCopy represent the following matrix layout:
[0, 3, 6]
[1, 4, 7]
[2, 5, 8]
Summary
Public fields |
|
|---|---|
static final @NonNull Matrix3 |
Returns an identity matrix. |
static final @NonNull Matrix3 |
Returns a zero matrix. |
Public constructors |
|---|
|
Creates a new matrix with a deep copy of the data from the |
Public methods |
|
|---|---|
final @NonNull Matrix3 |
Returns a copy of the matrix. |
boolean |
Returns true if this matrix is equal to |
static final @NonNull Matrix3 |
fromQuaternion(@NonNull Quaternion quaternion)Returns a new 3x3 rotation matrix from the given |
static final @NonNull Matrix3 |
fromScale(float scale)Returns a new uniform scale matrix. |
static final @NonNull Matrix3 |
Returns a new scale matrix. |
final @NonNull float[] |
getData()Returns an array of the components of this matrix. |
final @NonNull Matrix3 |
Returns a matrix that performs the opposite transformation. |
final @NonNull Quaternion |
Returns the rotation component of this matrix. |
final @NonNull Vector3 |
getScale()Returns the scale component of this matrix. |
final @NonNull Matrix3 |
Returns a matrix that is the transpose of this matrix. |
int |
hashCode()Standard hash code calculation using constructor values. |
final boolean |
isTrs()Returns true if this matrix is a valid transformation matrix that can be decomposed into rotation and scale using determinant properties. |
final @NonNull Matrix3 |
Returns a new matrix with the matrix multiplication product of this matrix and the |
@NonNull String |
toString()Standard toString() implementation. |
Public fields
Public constructors
Matrix3
public Matrix3(@NonNull float[] dataToCopy)
| Parameters | |
|---|---|
@NonNull float[] dataToCopy |
the array with 9 elements that will be copied over. |
Matrix3
public Matrix3(@NonNull Matrix3 other)
Creates a new matrix with a deep copy of the data from the other.
Public methods
copy
public final @NonNull Matrix3 copy(@NonNull float[] data)
Returns a copy of the matrix.
fromQuaternion
public static final @NonNull Matrix3 fromQuaternion(@NonNull Quaternion quaternion)
Returns a new 3x3 rotation matrix from the given quaternion, which is first normalized. This function uses a standard formula for the conversion, though alternative algebraic expressions exist due to differing conventions. The resulting matrix typically transforms 3D column vectors by pre-multiplication (e.g.,
$v'_{new} = M \cdot v_{old}$
).fromScale
public static final @NonNull Matrix3 fromScale(float scale)
Returns a new uniform scale matrix.
fromScale
public static final @NonNull Matrix3 fromScale(@NonNull Vector3 scale)
Returns a new scale matrix.
getData
public final @NonNull float[] getData()
Returns an array of the components of this matrix.
getInverse
public final @NonNull Matrix3 getInverse()
Returns a matrix that performs the opposite transformation.
getRotation
public final @NonNull Quaternion getRotation()
Returns the rotation component of this matrix.
getScale
public final @NonNull Vector3 getScale()
Returns the scale component of this matrix.
getTranspose
public final @NonNull Matrix3 getTranspose()
Returns a matrix that is the transpose of this matrix.
isTrs
public final boolean isTrs()
Returns true if this matrix is a valid transformation matrix that can be decomposed into rotation and scale using determinant properties.