Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die statische Methode fromFloat32Array() der DOMMatrix-Schnittstelle erstellt ein neues DOMMatrix-Objekt, gegeben ein Array mit Einzelpräzisions-(32-Bit)-Gleitkommawerten.

Wenn das Array 6 Werte hat, ist das Ergebnis eine 2D-Matrix; wenn das Array 16 Werte hat, ist das Ergebnis eine 3D-Matrix. Andernfalls wird eine TypeError-Ausnahme ausgelöst.

Syntax

DOMMatrix.fromFloat32Array(array)

Parameter

array

Ein Float32Array mit 6 oder 16 Elementen in Spalten-Major-Ordnung.

Rückgabewert

Ein DOMMatrix-Objekt.

Ausnahmen

TypeError

Wird ausgelöst, wenn die Länge des array-Parameters nicht 6 oder 16 ist.

Beispiele

Erstellen einer 2D-Matrix aus einem Float32Array

Dieses Beispiel erstellt eine 2D-Matrix aus einem 6-Elemente 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

Erstellen einer 3D-Matrix aus einem Float32Array

Dieses Beispiel erstellt eine 3D-Matrix aus einem 16-Elemente 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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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