Matrix4 class

4D Matrix. Values are stored in column major order.

Constructors

Matrix4(double arg0, double arg1, double arg2, double arg3, double arg4, double arg5, double arg6, double arg7, double arg8, double arg9, double arg10, double arg11, double arg12, double arg13, double arg14, double arg15)

Constructs a new mat4.

factory

Matrix4.columns(Vector4 arg0, Vector4 arg1, Vector4 arg2, Vector4 arg3)

Constructs a new mat4 from columns.

factory

Matrix4.compose(Vector3 translation, Quaternion rotation, Vector3 scale)

Constructs Matrix4 from translation, rotation and scale.

factory

Matrix4.copy(Matrix4 other)

Copies values from other.

factory

Matrix4.diagonal3(Vector3 scale)

Scale matrix.

factory

Matrix4.diagonal3Values(double x, double y, double z)

Scale matrix.

factory

Matrix4.fromBuffer(ByteBuffer buffer, int offset)

Constructs Matrix4 with a storage that views given buffer starting at offset. offset has to be multiple of Float64List.bytesPerElement.

Matrix4.fromFloat64List(Float64List _m4storage)

Constructs Matrix4 with given Float64List as storage.

Matrix4.fromList(List<double> values)

New matrix from values.

factory

Matrix4.identity()

Identity matrix.

factory

Matrix4.inverted(Matrix4 other)

Constructs a matrix that is the inverse of other.

factory

Matrix4.outer(Vector4 u, Vector4 v)

Outer product of u and v.

factory

Matrix4.rotationX(double radians)

Rotation of radians around X.

factory

Matrix4.rotationY(double radians)

Rotation of radians around Y.

factory

Matrix4.rotationZ(double radians)

Rotation of radians around Z.

factory

Matrix4.skew(double alpha, double beta)

Skew matrix around X axis (alpha) and Y axis (beta).

factory

Matrix4.skewX(double alpha)

Skew matrix around X axis

factory

Matrix4.skewY(double beta)

Skew matrix around Y axis.

factory

Matrix4.translation(Vector3 translation)

Translation matrix.

factory

Matrix4.translationValues(double x, double y, double z)

Translation matrix.

factory

Matrix4.zero()

Zero matrix.

Properties

dimension → int

Dimension of the matrix.

no setter

forward → Vector3

no setter

hashCode → int

The hash code for this object.

no setter, override

right → Vector3

no setter

row0 ↔ Vector4

Returns row 0

getter/setter pair

row1 ↔ Vector4

Returns row 1

getter/setter pair

row2 ↔ Vector4

Returns row 2

getter/setter pair

row3 ↔ Vector4

Returns row 3

getter/setter pair

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

storage → Float64List

The components of the matrix.

no setter

up → Vector3

no setter

Methods

absolute() → Matrix4

Returns the component wise absolute value of this.

absoluteError(Matrix4 correct) → double

Returns absolute error between this and correct

absoluteRotate(Vector3 arg) → Vector3

Rotates arg by the absolute rotation of this Returns arg. Primarily used by AABB transformation code.

add(Matrix4 o) → void

Adds o to this.

applyToVector3Array(List<double> array, [int offset = 0]) → List<double>

Multiply this to each set of xyz values in array starting at offset.

clone() → Matrix4

Clone matrix.

copyFromArray(List<double> array, [int offset = 0]) → void

Copies elements from array into this starting at offset.

copyInto(Matrix4 arg) → Matrix4

Copy into arg.

copyIntoArray(List<num> array, [int offset = 0]) → void

Copies this into array starting at offset.

copyInverse(Matrix4 arg) → double

Set this matrix to be the inverse of arg

copyRotation(Matrix3 rotation) → void

Copies the rotation matrix from this homogeneous transformation matrix into rotation.

decompose(Vector3 translation, Quaternion rotation, Vector3 scale) → void

Decomposes this into translation, rotation and scale components.

determinant() → double

Returns the determinant of this matrix.

dotColumn(int j, Vector4 v) → double

Returns the dot product of column j and v.

dotRow(int i, Vector4 v) → double

Returns the dot product of row i and v.

entry(int row, int col) → double

Value at row, col.

getColumn(int column) → Vector4

Gets the column of the matrix

getMaxScaleOnAxis() → double

Returns the max scale value of the 3 axes.

getNormalMatrix() → Matrix3

Returns the normal matrix from this homogeneous transformation matrix. The normal matrix is the transpose of the inverse of the top-left 3x3 part of this 4x4 matrix.

getRotation() → Matrix3

Returns the rotation matrix from this homogeneous transformation matrix.

getRow(int row) → Vector4

Gets the row of the matrix

getTranslation() → Vector3

Returns the translation vector from this homogeneous transformation matrix.

index(int row, int col) → int

Return index in storage for row, col value.

infinityNorm() → double

Returns infinity norm of the matrix. Used for numerical analysis.

invert() → double

Invert this.

invertRotation() → double

isIdentity() → bool

Is this the identity matrix?

isZero() → bool

Is this the zero matrix?

leftTranslate(dynamic x, [double y = 0.0, double z = 0.0]) → void

Multiply this by a translation from the left. The translation can be specified with a Vector3, Vector4, or x, y, z.

multiplied(Matrix4 arg) → Matrix4

Multiply a copy of this with arg.

multiply(Matrix4 arg) → void

Multiply this by arg.

multiplyTranspose(Matrix4 arg) → void

Multiply this with a transposed arg.

negate() → void

Negate this.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

perspectiveTransform(Vector3 arg) → Vector3

Transform arg of type Vector3 using the perspective transformation defined by this.

relativeError(Matrix4 correct) → double

Returns relative error between this and correct

rotate(Vector3 axis, double angle) → void

Rotate this angle radians around axis

rotate3(Vector3 arg) → Vector3

Rotate arg of type Vector3 using the rotation defined by this.

rotated3(Vector3 arg, [Vector3? out]) → Vector3

Rotate a copy of arg of type Vector3 using the rotation defined by this. If a out parameter is supplied, the copy is stored in out.

rotateX(double angle) → void

Rotate this angle radians around X

rotateY(double angle) → void

Rotate this matrix angle radians around Y

rotateZ(double angle) → void

Rotate this matrix angle radians around Z

scale(dynamic x, [double? y, double? z]) → void

Scale this matrix by a Vector3, Vector4, or x,y,z

scaleAdjoint(double scale) → void

Converts into Adjugate matrix and scales by scale

scaled(dynamic x, [double? y, double? z]) → Matrix4

Create a copy of this scaled by a Vector3, Vector4 or x,y, and z.

setColumn(int column, Vector4 arg) → void

Assigns the column of the matrix arg

setColumns(Vector4 arg0, Vector4 arg1, Vector4 arg2, Vector4 arg3) → void

Sets the entire matrix to the column values.

setDiagonal(Vector4 arg) → void

Sets the diagonal of the matrix to be arg.

setEntry(int row, int col, double v) → void

Set value at row, col to be v.

setFrom(Matrix4 arg) → void

Sets the entire matrix to the matrix in arg.

setFromTranslationRotation(Vector3 arg0, Quaternion arg1) → void

Sets the matrix from translation arg0 and rotation arg1.

setFromTranslationRotationScale(Vector3 translation, Quaternion rotation, Vector3 scale) → void

Sets the matrix from translation, rotation and scale.

setIdentity() → void

Makes this into the identity matrix.

setOuter(Vector4 u, Vector4 v) → void

setRotation(Matrix3 r) → void

Sets the rotation matrix in this homogeneous transformation matrix.

setRotationX(double radians) → void

Sets the upper 3x3 to a rotation of radians around X

setRotationY(double radians) → void

Sets the upper 3x3 to a rotation of radians around Y

setRotationZ(double radians) → void

Sets the upper 3x3 to a rotation of radians around Z

setRow(int row, Vector4 arg) → void

Assigns the row of the matrix arg

setTranslation(Vector3 t) → void

Sets the translation vector in this homogeneous transformation matrix.

setTranslationRaw(double x, double y, double z) → void

Sets the translation vector in this homogeneous transformation matrix.

setUpper2x2(Matrix2 arg) → void

Sets the upper 2x2 of the matrix to be arg.

setValues(double arg0, double arg1, double arg2, double arg3, double arg4, double arg5, double arg6, double arg7, double arg8, double arg9, double arg10, double arg11, double arg12, double arg13, double arg14, double arg15) → void

Sets the matrix with specified values.

setZero() → void

Zeros this.

splatDiagonal(double arg) → void

Sets the diagonal to arg.

sub(Matrix4 o) → void

Subtracts o from this.

toString() → String

Returns a printable string

override

trace() → double

Returns the trace of the matrix. The trace of a matrix is the sum of the diagonal entries.

transform(Vector4 arg) → Vector4

Transform arg of type Vector4 using the transformation defined by this.

transform3(Vector3 arg) → Vector3

Transform arg of type Vector3 using the transformation defined by this.

transformed(Vector4 arg, [Vector4? out]) → Vector4

Transform a copy of arg of type Vector4 using the transformation defined by this. If a out parameter is supplied, the copy is stored in out.

transformed3(Vector3 arg, [Vector3? out]) → Vector3

Transform a copy of arg of type Vector3 using the transformation defined by this. If a out parameter is supplied, the copy is stored in out.

translate(dynamic x, [double y = 0.0, double z = 0.0]) → void

Translate this matrix by a Vector3, Vector4, or x,y,z

transpose() → void

transposed() → Matrix4

Returns the tranpose of this.

transposeMultiply(Matrix4 arg) → void

Multiply a transposed this with arg.

transposeRotation() → void

Transposes just the upper 3x3 rotation matrix.

Operators

operator *(dynamic arg) → dynamic

Returns a new vector or matrix by multiplying this with arg.

operator +(Matrix4 arg) → Matrix4

Returns new matrix after component wise this + arg

operator -(Matrix4 arg) → Matrix4

Returns new matrix after component wise this - arg

operator ==(Object other) → bool

Check if two matrices are the same.

override

operator [](int i) → double

Access the element of the matrix at the index i.

operator []=(int i, double v) → void

Set the element of the matrix at the index i.

operator unary-() → Matrix4

Returns new matrix -this

Static Methods

solve(Matrix4 A, Vector4 x, Vector4 b) → void

Solve A * x = b.

solve2(Matrix4 A, Vector2 x, Vector2 b) → void

Solve A * x = b.

solve3(Matrix4 A, Vector3 x, Vector3 b) → void

Solve A * x = b.

tryInvert(Matrix4 other) → Matrix4?

Returns a matrix that is the inverse of other if other is invertible, otherwise null.