kite3d/io.github.yuroyami.kite3d.math/Matrix3

Matrix3

Represents a 3x3 matrix.

Row-major and column-major ordering: set takes its arguments in row-major order, so a literal in source reads the way you would write the matrix on paper. The values are stored in elements in column-major order. There is no element constructor; use Matrix3().set(...).

Matrices are mutable and not thread-safe; confine an instance (and any object graph holding it) to a single thread, exactly as in three.js. Most methods mutate this and return it for chaining.

Constructors

Matrix3

constructor()

Properties

elements

val elements: DoubleArray

A column-major list of matrix values. Initialized to the 3x3 identity.

Functions

clone

fun clone(): Matrix3

Returns a new matrix with copied values from this instance.

copy

fun copy(m: Matrix3): Matrix3

Copies the values of the given matrix m to this instance.

determinant

fun determinant(): Double

Computes and returns the determinant of this matrix.

equals

open operator override fun equals(other: Any?): Boolean

Structural equality: true when other is a Matrix3 whose elements are element-wise equal (via DoubleArray.contentEquals, so NaN != NaN).

extractBasis

fun extractBasis(xAxis: Vector3, yAxis: Vector3, zAxis: Vector3): Matrix3

Extracts the basis of this matrix into the three axis vectors provided.

fromArray

fun fromArray(array: DoubleArray, offset: Int = 0): Matrix3

Sets the elements of the matrix from the given array (column-major order).

getNormalMatrix

fun getNormalMatrix(matrix4: Matrix4): Matrix3

Computes the normal matrix, which is the inverse transpose of the upper-left 3x3 portion of the given 4x4 matrix matrix4.

hashCode

open override fun hashCode(): Int

identity

fun identity(): Matrix3

Sets this matrix to the 3x3 identity matrix.

invert

fun invert(): Matrix3

Inverts this matrix, using the analytic method. You can not invert a matrix with a determinant of zero; if you attempt this, the method produces a zero matrix instead.

makeRotation