MDN self-hosted library · e01.org

DOMMatrix: fromFloat64Array() static method

Geometry Interfaces

Geometry Interfaces

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 Float64Array with 6 or 16 elements in column-major order.

Return value

A DOMMatrix object.

Exceptions

  • TypeError
  • : Thrown if the length of the array parameter 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

Browser compatibility

See also

  • DOMMatrix()
  • DOMMatrixReadOnly.toFloat32Array()
  • DOMMatrixReadOnly.toFloat64Array()
  • DOMMatrix.fromFloat32Array()
  • DOMMatrix.fromMatrix()