DOMMatrixReadOnly: fromFloat64Array() static method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Geometry Interfaces")}}{{AvailableInWorkers}}
The **fromFloat64Array()** static method of the {{domxref("DOMMatrixReadOnly")}} interface creates a new {{domxref("DOMMatrixReadOnly")}} 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 {{jsxref("TypeError")}} exception is thrown.
Syntax
js-nolint
DOMMatrixReadOnly.fromFloat64Array(array)Parameters
array- : A {{jsxref("Float64Array")}} with 6 or 16 elements in column-major order.
Return value
A {{domxref("DOMMatrixReadOnly")}} object.
Exceptions
- {{jsxref("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.
js
const float64Array = new Float64Array([1, 0, 0, 1, 10, 20]);
const matrix2D = DOMMatrixReadOnly.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 20Creating a 3D matrix from a Float64Array
This example creates a 3D matrix from a 16-element Float64Array.
js
const float64Array = new Float64Array([
1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 10, 20, 30, 1,
]);
const matrix3D = DOMMatrixReadOnly.fromFloat64Array(float64Array);
console.log(matrix3D.is2D);
// Output: false
console.log(matrix3D.m41, matrix3D.m42, matrix3D.m43);
// Output: 10 20 30Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("DOMMatrixReadOnly/DOMMatrixReadOnly", "DOMMatrixReadOnly()")}}
- {{domxref("DOMMatrixReadOnly.toFloat32Array()")}}
- {{domxref("DOMMatrixReadOnly.toFloat64Array()")}}
- {{domxref("DOMMatrixReadOnly.fromFloat32Array_static", "DOMMatrixReadOnly.fromFloat32Array()")}}
- {{domxref("DOMMatrixReadOnly.fromMatrix_static", "DOMMatrixReadOnly.fromMatrix()")}}