web api static method
DOMMatrix: fromFloat32Array() static method
Available in workers
The fromFloat32Array() static method of the DOMMatrix interface creates a new DOMMatrix object given an array of single-precision (32-bit) floating-point values.
If the array has 6 values, the result is a 2D matrix; if the array has 16 values, the result is a 3D matrix. Otherwise, a TypeError exception is thrown.
Syntax
DOMMatrix.fromFloat32Array(array)
Parameters
array- : A
Float32Arraywith 6 or 16 elements in column-major order.
- : A
Return value
A DOMMatrix object.
Exceptions
TypeError- : Thrown if the length of the
arrayparameter is not 6 or 16.
- : Thrown if the length of the
Examples
Creating a 2D matrix from a Float32Array
This example creates a 2D matrix from a 6-element Float32Array.
const float32Array = new Float32Array([1, 0, 0, 1, 10, 20]);
const matrix2D = DOMMatrix.fromFloat32Array(float32Array);
console.log(matrix2D.toString());
// Output: matrix(1, 0, 0, 1, 10, 20)
console.log(matrix2D.is2D);
// Output: true
Creating a 3D matrix from a Float32Array
This example creates a 3D matrix from a 16-element Float32Array.
const float32Array = new Float32Array([
1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 10, 20, 30, 1,
]);
const matrix3D = DOMMatrix.fromFloat32Array(float32Array);
console.log(matrix3D.is2D);
// Output: false
console.log(matrix3D.m41, matrix3D.m42, matrix3D.m43);
// Output: 10 20 30
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.