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.

In diesem Artikel

Syntax

js
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

js
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

js
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}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Geometry interfaces
DOMMatrixReadOnly
Konstruktor
1. DOMMatrixReadOnly()
Instanzeigenschaften
1. is2D
2. isIdentity
Statische Methoden
Instanzmethoden
Verwandte Seiten für Geometry Interfaces