Class Mat4Tools

Auxiliary tool for math operations between 4D matrices.

Constructors

constructor

new Mat4Tools(): Mat4Tools
Returns Mat4Tools

Methods

`Static`add

add(theMatA: WasmMatrix4d, theMatB: WasmMatrix4d): WasmMatrix4d
Compute per-component addition between two matrices.
Parameters
- theMatA: WasmMatrix4d
- theMatB: WasmMatrix4d
Returns WasmMatrix4d

`Static`buildRotationMatrix

buildRotationMatrix(
    theLocation: WasmVector3d,
    theDirection: WasmVector3d,
    theAngle: number,
): WasmMatrix4d
Build rotation matrix
Parameters
- theLocation: WasmVector3d
- theDirection: WasmVector3d
- theAngle: number
Returns WasmMatrix4d

`Static`clone

clone(theMat: WasmMatrix4d): WasmMatrix4d
Clone matrix.
Parameters
- theMat: WasmMatrix4d
Returns WasmMatrix4d

`Static`copy

copy(theMatA: WasmMatrix4d, theMatB: WasmMatrix4d): void
Copy values from one matrix to another.
Parameters
- theMatA: WasmMatrix4d
- theMatB: WasmMatrix4d
Returns void

`Static`determinant

determinant(mat: WasmMatrix4d): number
Compute determinant
Parameters
- mat: WasmMatrix4d
Returns number

`Static`determinant3x3

determinant3x3(mat: number[][]): number
Compute determinant of 3x3 matrix
Parameters
- mat: number[][]
Returns number

`Static`divide

divide(theMat: WasmMatrix4d, theScalar: number): WasmMatrix4d
Compute per-component division between two matrices.
Parameters
- theMat: WasmMatrix4d
- theScalar: number
Returns WasmMatrix4d

`Static`eulerToMatrix

eulerToMatrix(theEuler: WasmVector3d, theOrder: EulerSequence): WasmMatrix4d
Get Matrix from euler angles
Parameters
- theEuler: WasmVector3d
- theOrder: EulerSequence
Returns WasmMatrix4d

`Static`eulerToQuaternion

eulerToQuaternion(theEuler: WasmVector3d, theOrder: EulerSequence): WasmVector4d
Get rotation quaternion from euler angles
Parameters
- theEuler: WasmVector3d
- theOrder: EulerSequence
Returns WasmVector4d

`Static`getCSRelativeTransformation

getCSRelativeTransformation(
theFrom: ObjectAxes,
theTo: ObjectAxes,
): WasmMatrix4d
Calculate relative coordinate system transformation
Parameters
- theFrom: ObjectAxes
- theTo: ObjectAxes
Returns WasmMatrix4d

`Static`getCSTransformation

getCSTransformation(theAxes: ObjectAxes): WasmMatrix4d
Calculate coordinate system transformation from axes. Transform a point from global CS to the given CS.
Parameters
- theAxes: ObjectAxes
Returns WasmMatrix4d

`Static`getEulerAngles

getEulerAngles(theMat: WasmMatrix4d, theOrder: EulerSequence): WasmVector3d
Get euler angles from matrix
Parameters
- theMat: WasmMatrix4d
- theOrder: EulerSequence
Returns WasmVector3d

`Static`getQuaternion

getQuaternion(theMat: WasmMatrix4d): WasmVector4d
Get quaternion from matrix
Parameters
- theMat: WasmMatrix4d
Returns WasmVector4d

`Static`getRotation

getRotation(theMat: WasmMatrix4d): WasmMatrix4d
rotation part of matrix
Parameters
- theMat: WasmMatrix4d
Returns WasmMatrix4d

`Static`getRotationScale

getRotationScale(theMat: WasmMatrix4d): WasmMatrix4d
Get rotation and scale part of matrix
Parameters
- theMat: WasmMatrix4d
Returns WasmMatrix4d

`Static`getScale

getScale(theMat: WasmMatrix4d): WasmMatrix4d
scale part of matrix
Parameters
- theMat: WasmMatrix4d
Returns WasmMatrix4d

`Static`getTransformationCS

getTransformationCS(theMatrix: WasmMatrix4d): ObjectAxes
Calculate coordinate system axes of the given transformation.
Parameters
- theMatrix: WasmMatrix4d
Returns ObjectAxes

`Static`getTranslation

getTranslation(theMat: WasmMatrix4d): WasmVector3d
Return translation part of matrix.
Parameters
- theMat: WasmMatrix4d
Returns WasmVector3d

`Static`identity

identity(): WasmMatrix4d
Return identity matrix.

Returns WasmMatrix4d

`Static`invert

invert(originalMatrix: WasmMatrix4d): WasmMatrix4d
Invert the matrix.
Parameters
- originalMatrix: WasmMatrix4d
Returns WasmMatrix4d

`Static`isEqual

isEqual(
    theMatA: WasmMatrix4d,
    theMatB: WasmMatrix4d,
    theTolerance?: number,
): boolean
Return TRUE if one matrix is equal to another.
Parameters
- theMatA: WasmMatrix4d
- theMatB: WasmMatrix4d
- theTolerance: number = 1e-6
Returns boolean

`Static`isValid

isValid(theMat: WasmMatrix4d): boolean
Return TRUE if matrix contains valid transformation.
Parameters
- theMat: WasmMatrix4d
Returns boolean

`Static`multiply

multiply(theMatA: WasmMatrix4d, theMatB: number | WasmMatrix4d): WasmMatrix4d
Compute per-component multiplication between two matrices.
Parameters
- theMatA: WasmMatrix4d
- theMatB: number | WasmMatrix4d
Returns WasmMatrix4d

`Static`multiplyMatrixArray

multiplyMatrixArray(theMatA: WasmMatrix4d, theVecB: WasmArray4d): WasmArray4d
Compute matrix-array multiplication.
Parameters
- theMatA: WasmMatrix4d
- theVecB: WasmArray4d
Returns WasmArray4d

`Static`multiplyMatrixDirection

multiplyMatrixDirection(
theMatA: WasmMatrix4d,
theDir: WasmVector3d | WasmArray3d,
): WasmVector3d
Compute matrix-direction multiplication.
Parameters
- theMatA: WasmMatrix4d
- theDir: WasmVector3d | WasmArray3d
Returns WasmVector3d

`Static`multiplyMatrixPoint

multiplyMatrixPoint(
theMatA: WasmMatrix4d,
thePoint: WasmVector3d | WasmArray3d,
): WasmVector3d
Compute matrix-point multiplication.
Parameters
- theMatA: WasmMatrix4d
- thePoint: WasmVector3d | WasmArray3d
Returns WasmVector3d

`Static`multiplyQuartenions

multiplyQuartenions(
theQuat1: WasmVector4d,
theQuat2: WasmVector4d,
): WasmVector4d
Multiplies quaternions
Parameters
- theQuat1: WasmVector4d
- theQuat2: WasmVector4d
Returns WasmVector4d

`Static`quaternionToMatrix

quaternionToMatrix(theQuat: WasmVector4d): WasmMatrix4d
Get rotation quaternion from euler angles
Parameters
- theQuat: WasmVector4d
Returns WasmMatrix4d

`Static`relativeTransform

relativeTransform(theFrom: WasmMatrix4d, theTo: WasmMatrix4d): WasmMatrix4d
Get relative transform
Parameters
- theFrom: WasmMatrix4d
- theTo: WasmMatrix4d
Returns WasmMatrix4d

`Static`rotateAroundAxis

rotateAroundAxis(
    theTransform: WasmMatrix4d,
    theLocation: WasmVector3d,
    theAxis: WasmVector3d,
    theAngle: number,
): WasmMatrix4d
Rotate around axis
Parameters
- theTransform: WasmMatrix4d
  the transformation matrix
- theLocation: WasmVector3d
  the location
- theAxis: WasmVector3d
  the axis
- theAngle: number
  the angle
Returns WasmMatrix4d
the rotated matrix

`Static`rotateAroundCenter

rotateAroundCenter(
    theTransform: WasmMatrix4d,
    theRotationMatrix: WasmMatrix4d,
    theCenter: WasmVector3d,
): WasmMatrix4d
Apply rotation matrix around rotation center
Parameters
- theTransform: WasmMatrix4d
  the transformation matrix of the object
- theRotationMatrix: WasmMatrix4d
  the rotation matrix to apply
- theCenter: WasmVector3d
  the center of rotation
Returns WasmMatrix4d

`Static`scale

scale(theVector: number | WasmVector3d): WasmMatrix4d
Return scale matrix.
Parameters
- theVector: number | WasmVector3d
Returns WasmMatrix4d

`Static`scaleUnits

scaleUnits(theMat: WasmMatrix4d, theScale: number): WasmMatrix4d
Return scale matrix.
Parameters
- theMat: WasmMatrix4d
- theScale: number
Returns WasmMatrix4d

`Static`setTranslation

setTranslation(theMat: WasmMatrix4d, theVector: WasmVector3d): void
change translation part of matrix
Parameters
- theMat: WasmMatrix4d
- theVector: WasmVector3d
Returns void

`Static`setViewer

setViewer(theViewer: OccViewer): void
Set Viewer
Parameters
- theViewer: OccViewer
Returns void

`Static`subtract

subtract(theMatA: WasmMatrix4d, theMatB: WasmMatrix4d): WasmMatrix4d
Compute per-component subtraction between two matrices.
Parameters
- theMatA: WasmMatrix4d
- theMatB: WasmMatrix4d
Returns WasmMatrix4d

`Static`transformCS

transformCS(theAxes: ObjectAxes, theMat: WasmMatrix4d): ObjectAxes
Transform coordinate system
Parameters
- theAxes: ObjectAxes
- theMat: WasmMatrix4d
Returns ObjectAxes

`Static`translate

translate(theMat: WasmMatrix4d, theVector: WasmVector3d): WasmMatrix4d
translate matrix
Parameters
- theMat: WasmMatrix4d
- theVector: WasmVector3d
Returns WasmMatrix4d

`Static`translation

translation(theVector: WasmVector3d): WasmMatrix4d
Return translation matrix.
Parameters
- theVector: WasmVector3d
Returns WasmMatrix4d

`Static`transpose

transpose(theMat: WasmMatrix4d): WasmMatrix4d
Return transposed matrix.
Parameters
- theMat: WasmMatrix4d
Returns WasmMatrix4d

`Static`unscale

unscale(theMat: WasmMatrix4d): WasmMatrix4d
Unscale
Parameters
- theMat: WasmMatrix4d
Returns WasmMatrix4d