Matrix4

java.lang.Object
- com.aspose.threed.Matrix4

All Implemented Interfaces:: Struct<Matrix4>, java.io.Serializable, java.lang.Cloneable

public final class Matrix4
extends java.lang.Object
implements Struct<Matrix4>, java.io.Serializable

4x4 matrix implementation. Example:

      Matrix4 mat = Matrix4.rotateFromEuler(90, 0, 0);
      Matrix4 mat2 = Matrix4.translate(0, 10, -50);
      Matrix4 transform = Matrix4.mul(mat2, mat);
      Vector4 pos = new Vector4(10, 9, 0, 1);
      Vector4 transformed = Matrix4.mul(transform, pos);

See Also:: Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`double`	`m00` The m00.
`double`	`m01` The m01.
`double`	`m02` The m02.
`double`	`m03` The m03.
`double`	`m10` The m10.
`double`	`m11` The m11.
`double`	`m12` The m12.
`double`	`m13` The m13.
`double`	`m20` The m20.
`double`	`m21` The m21.
`double`	`m22` The m22.
`double`	`m23` The m23.
`double`	`m30` The m30.
`double`	`m31` The m31.
`double`	`m32` The m32.
`double`	`m33` The m33.

Constructor Summary

Constructors
Constructor and Description
`Matrix4()`
`Matrix4(double[] m)` Initializes a new instance of the `Matrix4` struct.
`Matrix4(double m00, double m01, double m02, double m03, double m10, double m11, double m12, double m13, double m20, double m21, double m22, double m23, double m30, double m31, double m32, double m33)` Initializes a new instance of the `Matrix4` struct.
`Matrix4(FMatrix4 m)` Construct `Matrix4` from an `FMatrix4` instance
`Matrix4(Vector4 r0, Vector4 r1, Vector4 r2, Vector4 r3)` Constructs matrix from 4 rows.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Matrix4`	`clone()` Clone current instance
`Matrix4`	`concatenate(Matrix4 m2)` Concatenates the two matrices
`void`	`copyFrom(Matrix4 src)` Copy internal state from argument t
`boolean`	`decompose(Vector3 translation, Vector3 scaling, Quaternion rotation)` Decompose the transformation matrix.
`boolean`	`equals(java.lang.Object obj)`
`double`	`getDeterminant()` Gets the determinant of the matrix.
`static Matrix4`	`getIdentity()` Gets the identity matrix.
`int`	`hashCode()`
`Matrix4`	`inverse()` Inverses this instance.
`static Matrix4`	`mul(Matrix4 lhs, double v)` Multiply the matrix and double value
`static Matrix4`	`mul(Matrix4 lhs, Matrix4 rhs)` Multiply the two matrices
`static Vector3`	`mul(Matrix4 lhs, Vector3 v)` Multiply the matrix and vector3
`static Vector4`	`mul(Matrix4 lhs, Vector4 v)` Multiply the matrix and vector4
`Matrix4`	`normalize()` Normalizes this instance.
`static Matrix4`	`rotate(double angle, Vector3 axis)` Create a rotation matrix by rotation angle and axis
`static Matrix4`	`rotate(Quaternion q)` Create a rotation matrix from a quaternion
`static Matrix4`	`rotateFromEuler(double rx, double ry, double rz)` Create a rotation matrix from Euler angle
`static Matrix4`	`rotateFromEuler(Vector3 eul)` Create a rotation matrix from Euler angle
`static Matrix4`	`scale(double s)` Creates a matrix that scales along the x-axis, the y-axis and the z-axis.
`static Matrix4`	`scale(double sx, double sy, double sz)` Creates a matrix that scales along the x-axis, the y-axis and the z-axis.
`static Matrix4`	`scale(Vector3 s)` Creates a matrix that scales along the x-axis, the y-axis and the z-axis.
`void`	`setTRS(Vector3 translation, Vector3 rotation, Vector3 scale)` Initializes the matrix with translation/rotation/scale
`double[]`	`toArray()` Converts matrix to array.
`java.lang.String`	`toString()` Returns a `String` that represents the current `Matrix4`.
`static Matrix4`	`translate(double tx, double ty, double tz)` Creates a matrix that translates along the x-axis, the y-axis and the z-axis
`static Matrix4`	`translate(Vector3 t)` Creates a matrix that translates along the x-axis, the y-axis and the z-axis
`Matrix4`	`transpose()` Transposes this instance.

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.aspose.threed.Struct
byVal

Field Detail

m00
```
public double m00
```
The m00.

m01
```
public double m01
```
The m01.

m02
```
public double m02
```
The m02.

m03
```
public double m03
```
The m03.

m10
```
public double m10
```
The m10.

m11
```
public double m11
```
The m11.

m12
```
public double m12
```
The m12.

m13
```
public double m13
```
The m13.

m20
```
public double m20
```
The m20.

m21
```
public double m21
```
The m21.

m22
```
public double m22
```
The m22.

m23
```
public double m23
```
The m23.

m30
```
public double m30
```
The m30.

m31
```
public double m31
```
The m31.

m32
```
public double m32
```
The m32.

m33
```
public double m33
```
The m33.

Constructor Detail

Matrix4

public Matrix4(Vector4 r0,
               Vector4 r1,
               Vector4 r2,
               Vector4 r3)

Constructs matrix from 4 rows.

Parameters:: r0 - R0.; r1 - R1.; r2 - R2.; r3 - R3.

Matrix4

public Matrix4(double m00,
               double m01,
               double m02,
               double m03,
               double m10,
               double m11,
               double m12,
               double m13,
               double m20,
               double m21,
               double m22,
               double m23,
               double m30,
               double m31,
               double m32,
               double m33)

Initializes a new instance of the Matrix4 struct.

Parameters:

m00 - M00.

m01 - M01.

m02 - M02.

m03 - M03.

m10 - M10.

m11 - M11.

m12 - M12.

m13 - M13.

m20 - M20.

m21 - M21.

m22 - M22.

m23 - M23.

m30 - M30.

m31 - M31.

m32 - M32.

m33 - M33. Example:

     var mat = new Matrix4(
         1, 0, 0, 0,
         0, 1, 0, 0,
         0, 0, 1, 0,
         10, 20, 0, 1);
     var pos = new Vector3(10, 0, -1);
     var transformed = Matrix4.mul(mat, pos);

Matrix4
```
public Matrix4(FMatrix4 m)
```
Construct Matrix4 from an FMatrix4 instance

Matrix4
```
public Matrix4(double[] m)
```
Initializes a new instance of the Matrix4 struct.

Parameters:

m - M.

Matrix4
```
public Matrix4()
```

Method Detail

getIdentity
```
public static Matrix4 getIdentity()
```
Gets the identity matrix.

Returns:

the identity matrix.

concatenate

public Matrix4 concatenate(Matrix4 m2)

Concatenates the two matrices

Parameters:

m2 - M2.

Returns:

New matrix4 Example:

     Matrix4 t = Matrix4.translate(0, 10, 9);
     Matrix4 s = Matrix4.scale(10, 10, 10);
     Matrix4 transform = t.concatenate(s);
     Vector3 pos = new Vector3(10, 0, -1);
     Vector3 transformed = Matrix4.mul(transform, pos);

transpose

public Matrix4 transpose()

Transposes this instance.

Returns:

The transposed matrix. Example: The following code shows how to transpose a matrix

     Matrix4 t = Matrix4.translate(0, 10, 9);
     Matrix4 mat = t.transpose();
     System.out.printf("Transposed Matrix: %s", mat);

normalize
```
public Matrix4 normalize()
```
Normalizes this instance.

Returns:

Normalize matrix4

inverse

public Matrix4 inverse()

Inverses this instance.

Returns:

Inverse matrix4 Example: The following code shows how to inverse a matrix

     Matrix4 t = Matrix4.translate(0, 10, 9);
     Matrix4 mat = t.inverse();
     System.out.printf("Inversed Matrix: %s", mat);

getDeterminant
```
public double getDeterminant()
```
Gets the determinant of the matrix.

Returns:

the determinant of the matrix.

mul

public static Matrix4 mul(Matrix4 lhs,
                          Matrix4 rhs)

Multiply the two matrices

Parameters:: lhs - Lhs.; rhs - Rhs.
Returns:: Result matrix

mul

public static Vector3 mul(Matrix4 lhs,
                          Vector3 v)

Multiply the matrix and vector3

Parameters:: lhs - Lhs.; v - V.
Returns:: Result matrix

setTRS
```
public void setTRS(Vector3 translation,
                   Vector3 rotation,
                   Vector3 scale)
```
Initializes the matrix with translation/rotation/scale

Parameters:

translation - Translation.

rotation - Euler angles for rotation, fields are in degree.

scale - Scale.

mul

public static Vector4 mul(Matrix4 lhs,
                          Vector4 v)

Multiply the matrix and vector4

Parameters:: lhs - Lhs.; v - V.
Returns:: Result matrix

mul
```
public static Matrix4 mul(Matrix4 lhs,
                          double v)
```
Multiply the matrix and double value

Parameters:

lhs - Lhs.

v - V.

Returns:

Result matrix

toArray
```
public double[] toArray()
```
Converts matrix to array.

Returns:

The array.

decompose

public boolean decompose(Vector3 translation,
                         Vector3 scaling,
                         Quaternion rotation)

Decompose the transformation matrix.

Parameters:: translation - The translation.; scaling - The scaling.; rotation - The rotation.
Returns:: True if successed.

toString
```
public java.lang.String toString()
```
Returns a String that represents the current Matrix4.

Overrides:

toString in class java.lang.Object

Returns:

A String that represents the current Matrix4.

translate

public static Matrix4 translate(Vector3 t)

Creates a matrix that translates along the x-axis, the y-axis and the z-axis

Parameters:

t - Translate offset Example: The following code shows how to create a matrix for translate operation.

     Matrix4 t = Matrix4.translate(new Vector3(10, 0, 0));
     Vector3 pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));

translate

public static Matrix4 translate(double tx,
                                double ty,
                                double tz)

Creates a matrix that translates along the x-axis, the y-axis and the z-axis

Parameters:

tx - X-coordinate offset

ty - Y-coordinate offset

tz - Z-coordinate offset Example: The following code shows how to create a matrix for translate operation.

     var t = Matrix4.translate(10, 0, 0);
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));

scale
```
public static Matrix4 scale(Vector3 s)
```
Creates a matrix that scales along the x-axis, the y-axis and the z-axis.
Parameters:
s - Scaling factories applies to the x-axis, the y-axis and the z-axis Example: The following code shows how to create a matrix for scale operation.
```
     var t = Matrix4.scale(new Vector3(10, 10, 10));
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));
 
```

scale
```
public static Matrix4 scale(double s)
```
Creates a matrix that scales along the x-axis, the y-axis and the z-axis.
Parameters:
s - Scaling factories applies to all axex Example: The following code shows how to create a matrix for scale operation.
```
     var t = Matrix4.scale(10);
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));
 
```

scale
```
public static Matrix4 scale(double sx,
                            double sy,
                            double sz)
```
Creates a matrix that scales along the x-axis, the y-axis and the z-axis.
Parameters:

sx - Scaling factories applies to the x-axis

sy - Scaling factories applies to the y-axis
sz - Scaling factories applies to the z-axis Example: The following code shows how to create a matrix for scale operation.
```
     var t = Matrix4.scale(10, 20, 10);
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));
 
```

rotateFromEuler

public static Matrix4 rotateFromEuler(Vector3 eul)

Create a rotation matrix from Euler angle

Parameters:

eul - Rotation in radian Example: The following code shows how to create a matrix for rotate operation.

     var t = Matrix4.rotateFromEuler(new Vector3(0, Math.PI, 0));
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));

rotateFromEuler

public static Matrix4 rotateFromEuler(double rx,
                                      double ry,
                                      double rz)

Create a rotation matrix from Euler angle

Parameters:

rx - Rotation in x axis in radian

ry - Rotation in y axis in radian

rz - Rotation in z axis in radian Example: The following code shows how to create a matrix for rotate operation.

     var t = Matrix4.rotateFromEuler(0, Math.PI, 0);
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));

rotate

public static Matrix4 rotate(double angle,
                             Vector3 axis)

Create a rotation matrix by rotation angle and axis

Parameters:

angle - Rotate angle in radian

axis - Rotation axis Example: The following code shows how to create a matrix for rotate operation.

     var t = Matrix4.rotate(Math.PI, new Vector3(0, 1, 0));
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));

rotate

public static Matrix4 rotate(Quaternion q)

Create a rotation matrix from a quaternion

Parameters:

q - Rotation quaternion Example: The following code shows how to create a matrix for rotate operation.

     var t = Matrix4.rotate(Quaternion.fromAngleAxis(Math.PI, Vector3.getUnitY()));
     var pos = new Vector3(1, 1, 10);
     System.out.printf("Transformed: %s", Matrix4.mul(t, pos));

clone
```
public Matrix4 clone()
```
Description copied from interface: Struct

Clone current instance

Specified by:

clone in interface Struct<Matrix4>

Overrides:

clone in class java.lang.Object

Returns:

cloned instance

copyFrom
```
public void copyFrom(Matrix4 src)
```
Description copied from interface: Struct

Copy internal state from argument t

Specified by:

copyFrom in interface Struct<Matrix4>

Parameters:

src - source instance to copy

hashCode
```
public int hashCode()
```
Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:: equals in class java.lang.Object

Class Matrix4

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.aspose.threed.Struct

Field Detail

m00

m01

m02

m03

m10

m11

m12

m13

m20

m21

m22

m23

m30

m31

m32

m33

Constructor Detail

Matrix4

Matrix4

Matrix4

Matrix4

Matrix4

Method Detail

getIdentity

concatenate

transpose

normalize

inverse

getDeterminant

mul

mul

setTRS

mul

mul

toArray

decompose

toString

translate

translate

scale

scale

scale

rotateFromEuler

rotateFromEuler

rotate

rotate

clone

copyFrom

hashCode

equals