DOMMatrix: fromFloat64Array() static method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.
Note: This feature is available in Web Workers.
The fromFloat64Array() static method of the DOMMatrix interface creates a new DOMMatrix object given an array of double-precision (64-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.fromFloat64Array(array) Parameters
array-
A
Float64Arraywith 6 or 16 elements in column-major order.
Return value
A DOMMatrix object.
Exceptions
TypeError-
Thrown if the length of the
arrayparameter is not 6 or 16.
Examples
Creating a 2D matrix from a Float64Array
This example creates a 2D matrix from a 6-element Float64Array.
const float64Array = new Float64Array([1, 0, 0, 1, 10, 20]); const matrix2D = DOMMatrix.fromFloat64Array(float64Array); console.log(matrix2D.toString()); // Output: matrix(1, 0, 0, 1, 10, 20) console.log(matrix2D.is2D); // Output: true console.log(matrix2D.e, matrix2D.f); // Output: 10 20 Creating a 3D matrix from a Float64Array
This example creates a 3D matrix from a 16-element Float64Array.
const float64Array = new Float64Array([ 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 10, 20, 30, 1, ]); const matrix3D = DOMMatrix.fromFloat64Array(float64Array); console.log(matrix3D.is2D); // Output: false console.log(matrix3D.m41, matrix3D.m42, matrix3D.m43); // Output: 10 20 30 Specifications
| Specification |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrix-fromfloat64array |