Package org.eclipse.mosaic.lib.spatial

Class TransformationMatrix

java.lang.Object

org.eclipse.mosaic.lib.math.Matrix4d

org.eclipse.mosaic.lib.spatial.TransformationMatrix

All Implemented Interfaces:

Serializable

public class TransformationMatrix
extends Matrix4d

An special version of the Matrix4d providing further methods to describe scaling, rotation, and translation in the 3-dimensional space.

See Also:

• Serialized Form

Field Summary

Fields inherited from class org.eclipse.mosaic.lib.math.Matrix4d

m

Constructor Summary

Constructors

Constructor	Description
TransformationMatrix()	Creates a new transformation matrix.
TransformationMatrix(TransformationMatrix copyFrom)	Creates a new transformation matrix with values from the given TransformationMatrix.

Method Summary

Modifier and Type	Method	Description
TransformationMatrix	add(Matrix4d mat)	Adds a matrix to this matrix.
TransformationMatrix	add(Matrix4d mat, TransformationMatrix result)
TransformationMatrix	copy()	Creates copy of this matrix.
RotationMatrix	getRotation()	Extracts a 3x3 sub-matrix containing rotation+scale from this transformation matrix.
RotationMatrix	getRotation(RotationMatrix result)	Extracts a 3x3 sub-matrix containing rotation+scale from this transformation matrix.
Vector3d	getTranslation()	Extracts a 3 dimensional vector containing translation part from this transformation matrix.
Vector3d	getTranslation(Vector3d result)	Extracts a 3 dimensional vector containing translation part from this transformation matrix.
static TransformationMatrix	identityMatrix()	Creates a new transformation matrix.
TransformationMatrix	multiply(Matrix4d mat, TransformationMatrix result)
TransformationMatrix	rotate(double angleDeg, double axX, double axY, double axZ)	Adds rotation to this transformation matrix.
TransformationMatrix	rotate(double angleDeg, Vector3d axis)	Adds rotation to this transformation matrix.
TransformationMatrix	scale(double sx, double sy, double sz)	Adds scaling to this transformation matrix.
TransformationMatrix	set(double[] values, MatrixElementOrder inputOrder)	Sets the values of the matrix by the given double array.
TransformationMatrix	set(float[] values, MatrixElementOrder inputOrder)	Sets the values of the matrix by the given float array.
TransformationMatrix	set(int row, int col, double value)	Sets a specific value in the matrix by row and column index
TransformationMatrix	set(Matrix4d mat)	Copies the values from the given matrix to this matrix.
TransformationMatrix	setIdentity()	Sets all values to match identity matrix.
TransformationMatrix	setRotation(RotationMatrix rotation)	Replaces the 3x3 sub-matrix containing the rotation+scale for this transformation matrix.
TransformationMatrix	setZero()	Sets all values to zero.
TransformationMatrix	subtract(Matrix4d mat)	Subtracts a matrix from this matrix.
TransformationMatrix	subtract(Matrix4d mat, TransformationMatrix result)
Vector3d	transform(Vector3d vec)	Applies this transformation matrix to the given vector.
Vector3d	transform(Vector3d vec3, double w)	Applies this transformation matrix to the given vector.
TransformationMatrix	translate(double x, double y, double z)	Adds translation to this transformation matrix.
TransformationMatrix	translate(Vector3d t)	Adds translation to this transformation matrix.
TransformationMatrix	transpose()	Transposes this matrix.
TransformationMatrix	transpose(TransformationMatrix result)

Methods inherited from class org.eclipse.mosaic.lib.math.Matrix4d

add, equals, get, getAsDoubleArray, getAsFloatArray, hashCode, inverse, invert, isFuzzyEqual, multiply, subtract, toString, transpose

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

TransformationMatrix

public TransformationMatrix()

Creates a new transformation matrix. The initial values match the identity matrix.

TransformationMatrix

public TransformationMatrix(TransformationMatrix copyFrom)

Creates a new transformation matrix with values from the given TransformationMatrix.

Method Details

identityMatrix

public static TransformationMatrix identityMatrix()

Creates a new transformation matrix. The initial values match the identity matrix.

getRotation

public RotationMatrix getRotation()

Extracts a 3x3 sub-matrix containing rotation+scale from this transformation matrix.

getRotation

public RotationMatrix getRotation(RotationMatrix result)

Extracts a 3x3 sub-matrix containing rotation+scale from this transformation matrix. The result is written into the result matrix.

setRotation

public TransformationMatrix setRotation(RotationMatrix rotation)

Replaces the 3x3 sub-matrix containing the rotation+scale for this transformation matrix.

getTranslation

public Vector3d getTranslation()

Extracts a 3 dimensional vector containing translation part from this transformation matrix.

getTranslation

public Vector3d getTranslation(Vector3d result)

Extracts a 3 dimensional vector containing translation part from this transformation matrix. The result is written into the result vector.

transform

public Vector3d transform(Vector3d vec)

Applies this transformation matrix to the given vector.

transform

public Vector3d transform(Vector3d vec3,
 double w)

Applies this transformation matrix to the given vector.

translate

public TransformationMatrix translate(Vector3d t)

Adds translation to this transformation matrix.

translate

public TransformationMatrix translate(double x,
 double y,
 double z)

Adds translation to this transformation matrix.

scale

public TransformationMatrix scale(double sx,
 double sy,
 double sz)

Adds scaling to this transformation matrix.

rotate

public TransformationMatrix rotate(double angleDeg,
 Vector3d axis)

Adds rotation to this transformation matrix.

rotate

public TransformationMatrix rotate(double angleDeg,
 double axX,
 double axY,
 double axZ)

Adds rotation to this transformation matrix.

copy

public TransformationMatrix copy()

Description copied from class: Matrix4d

Creates copy of this matrix.

Overrides:

copy in class Matrix4d

set

public TransformationMatrix set(Matrix4d mat)

Description copied from class: Matrix4d

Copies the values from the given matrix to this matrix.

Overrides:

set in class Matrix4d

setIdentity

public TransformationMatrix setIdentity()

Description copied from class: Matrix4d

Sets all values to match identity matrix.

Overrides:

setIdentity in class Matrix4d

setZero

public TransformationMatrix setZero()

Description copied from class: Matrix4d

Sets all values to zero.

Overrides:

setZero in class Matrix4d

set

public TransformationMatrix set(float[] values,
 MatrixElementOrder inputOrder)

Description copied from class: Matrix4d

Sets the values of the matrix by the given float array. The order parameter defines how the values in the given array are arranged (either column or row-wise).

Overrides:

set in class Matrix4d

set

public TransformationMatrix set(double[] values,
 MatrixElementOrder inputOrder)

Description copied from class: Matrix4d

Sets the values of the matrix by the given double array. The order parameter defines how the values in the given array are arranged (either column or row-wise).

Overrides:

set in class Matrix4d

set

public TransformationMatrix set(int row,
 int col,
 double value)

Description copied from class: Matrix4d

Sets a specific value in the matrix by row and column index

Overrides:

set in class Matrix4d

transpose

public TransformationMatrix transpose()

Description copied from class: Matrix4d

Transposes this matrix.

Overrides:

transpose in class Matrix4d

transpose

public TransformationMatrix transpose(TransformationMatrix result)

add

public TransformationMatrix add(Matrix4d mat)

Description copied from class: Matrix4d

Adds a matrix to this matrix.

Overrides:

add in class Matrix4d

add

public TransformationMatrix add(Matrix4d mat,
 TransformationMatrix result)

subtract

public TransformationMatrix subtract(Matrix4d mat)

Description copied from class: Matrix4d

Subtracts a matrix from this matrix.

Overrides:

subtract in class Matrix4d

subtract

public TransformationMatrix subtract(Matrix4d mat,
 TransformationMatrix result)

multiply

public TransformationMatrix multiply(Matrix4d mat,
 TransformationMatrix result)