DOMMatrixReadOnly: DOMMatrixReadOnly() Konstruktor
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Der DOMMatrixReadOnly() Konstruktor erstellt ein neues DOMMatrixReadOnly Objekt, das eine 4x4-Matrix repräsentiert und für 2D- und 3D-Operationen geeignet ist.
Syntax
new DOMMatrixReadOnly()
new DOMMatrixReadOnly(initString)
new DOMMatrixReadOnly(initArray)
Parameter
initStringOptional-
Ein String, der eine 2D- oder 3D-Matrix im CSS
matrix()odermatrix3d()Format darstellt. initArrayOptional-
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
Float32ArrayoderFloat64Arraybereitgestellt wird, sollten Sie stattdessen die performanteren statischen MethodenDOMMatrixReadOnly.fromFloat32Array()oderDOMMatrixReadOnly.fromFloat64Array()verwenden. - Ein Array mit 6 Elementen wird als die Matrixkomponenten
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()odermatrix3d()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
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-dommatrixreadonly |