DOMMatrixReadOnly: DOMMatrixReadOnly() Konstruktor

Syntax

new DOMMatrixReadOnly()
new DOMMatrixReadOnly(initString)
new DOMMatrixReadOnly(initArray)

Parameter

initString Optional

Ein String, der eine 2D- oder 3D-Matrix im CSS matrix() oder matrix3d() Format darstellt.

initArray Optional

Ein Array, das entweder 6 oder 16 Zahlen in spaltenorientierter Reihenfolge enthält. Andere Array-Längen werfen einen TypeError.

• Ein Array mit 6 Elementen wird als die Matrixkomponenten [m11, m12, m21, m22, m41, m42] interpretiert und erstellt eine 2D-Matrix.
• Ein Array mit 16 Elementen wird als die Matrixkomponenten [m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44] interpretiert und erstellt eine 3D-Matrix.

Wenn dieses Argument weggelassen wird, wird eine Einheitsmatrix erstellt, also äquivalent zu [1, 0, 0, 1, 0, 0].

Wenn dieses Argument als Float32Array oder Float64Array bereitgestellt wird, sollten Sie stattdessen die performanteren statischen Methoden DOMMatrixReadOnly.fromFloat32Array() oder DOMMatrixReadOnly.fromFloat64Array() verwenden.

Rückgabewert

Ein neues DOMMatrixReadOnly Objekt.

Ausnahmen

TypeError

Wird geworfen, wenn das Argument weder ein String noch ein Array mit einer Länge ungleich 6 oder 16 ist.

SyntaxError

Wird geworfen, wenn das String-Argument nicht im gültigen CSS matrix() oder matrix3d() Format vorliegt.

Beispiele

Erstellen einer DOMMatrixReadOnly aus einem String

const matrixFromString = new DOMMatrixReadOnly("matrix(1, 0, 0, 1, 10, 20)");
console.log(matrixFromString.toJSON());
// Output: {a: 1, b: 0, c: 0, d: 1, e: 10, f: 20}

Erstellen einer DOMMatrixReadOnly aus einem Array

const matrixFromArray = new DOMMatrixReadOnly([1, 0, 0, 1, 10, 20]);
console.log(matrixFromArray.toJSON());
// Output: {a: 1, b: 0, c: 0, d: 1, e: 10, f: 20}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DOMMatrixReadOnly.fromFloat32Array()
• DOMMatrixReadOnly.fromFloat64Array()
• DOMMatrixReadOnly.fromMatrix()