DOMMatrixReadOnly

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

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

Das DOMMatrixReadOnly Interface repräsentiert eine unveränderbare 4×4-Matrix, geeignet für 2D- und 3D-Operationen. Das DOMMatrix-Interface — welches auf DOMMatrixReadOnly basiert — fügt Mutierbarkeit hinzu, wodurch Sie die Matrix nach ihrer Erstellung ändern können.

Dieses Interface sollte innerhalb von Web-Workern verfügbar sein, obwohl einige Implementierungen dies noch nicht erlauben.

Konstruktor

DOMMatrixReadOnly()

Erstellt ein neues DOMMatrixReadOnly Objekt.

Instanz-Eigenschaften

Dieses Interface erbt keine Eigenschaften.

DOMMatrixReadOnly.is2D Schreibgeschützt

Ein Boolean-Flag, dessen Wert true ist, wenn die Matrix als 2D-Matrix initialisiert wurde. Wenn false, ist die Matrix 3D.

DOMMatrixReadOnly.isIdentity Schreibgeschützt

Ein Boolean, dessen Wert true ist, wenn die Matrix eine Einheitsmatrix ist.

m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44

Gleitkommazahlen mit doppelter Genauigkeit, die jede Komponente einer 4×4-Matrix darstellen, wobei m11 bis m14 die erste Spalte sind, m21 bis m24 die zweite Spalte und so weiter.

a, b, c, d, e, f

Gleitkommazahlen mit doppelter Genauigkeit, die die Komponenten einer 4×4-Matrix darstellen, die für 2D-Rotationen und Übersetzungen erforderlich sind. Diese sind Aliase für spezifische Komponenten einer 4×4-Matrix, wie unten gezeigt.

2D 3D Äquivalent
a m11
b m12
c m21
d m22
e m41
f m42

Instanz-Methoden

Dieses Interface erbt keine Methoden. Keine der folgenden Methoden verändert die ursprüngliche Matrix.

DOMMatrixReadOnly.flipX()

Gibt eine neue DOMMatrix zurück, die durch Spiegeln der Quellmatrix um ihre X-Achse erstellt wurde. Dies entspricht der Multiplikation der Matrix mit DOMMatrix(-1, 0, 0, 1, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.flipY()

Gibt eine neue DOMMatrix zurück, die durch Spiegeln der Quellmatrix um ihre Y-Achse erstellt wurde. Dies entspricht der Multiplikation der Matrix mit DOMMatrix(1, 0, 0, -1, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.inverse()

Gibt eine neue DOMMatrix zurück, die durch Invertierung der Quellmatrix erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.multiply()

Gibt eine neue DOMMatrix zurück, die durch Berechnung des Punktprodukts der Quellmatrix und der angegebenen Matrix erstellt wurde. Die ursprüngliche Matrix wird nicht

DOMMatrixReadOnly.rotateAxisAngle()

Gibt eine neue DOMMatrix zurück, die durch Drehen der Quellmatrix um den angegebenen Winkel um den spezifizierten Vektor erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.rotate()

Gibt eine neue DOMMatrix zurück, die durch Drehen der Quellmatrix um jeden ihrer Achsen um die angegebene Anzahl von Grad erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.rotateFromVector()

Gibt eine neue DOMMatrix zurück, die durch Drehen der Quellmatrix um den Winkel zwischen dem angegebenen Vektor und (1, 0) erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.scale()

Gibt eine neue DOMMatrix zurück, die durch Skalieren der Quellmatrix um den für jede Achse angegebenen Betrag erstellt wurde, zentriert am angegebenen Ursprung. Standardmäßig werden die X- und Z-Achsen mit 1 skaliert und die Y-Achse hat keinen Standardskalierungswert. Der Standard-Ursprung ist (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.scale3d()

Gibt eine neue DOMMatrix zurück, die durch Skalieren der Quell-3D-Matrix mit dem angegebenen Faktor entlang aller ihrer Achsen erstellt wurde, zentriert am angegebenen Ursprungspunkt. Der Standard-Ursprung ist (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.scaleNonUniform() Veraltet

Gibt eine neue DOMMatrix zurück, die durch Anwenden der angegebenen Skalierung auf die X-, Y- und Z-Achsen, zentriert am angegebenen Ursprung, erstellt wurde. Standardmäßig sind die Skalierungsfaktoren der Y- und Z-Achsen beide 1, aber der Skalierungsfaktor für X muss angegeben werden. Der Standard-Ursprung ist (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.skewX()

Gibt eine neue DOMMatrix zurück, die durch Anwenden der angegebenen Schertransformation auf die Quellmatrix entlang ihrer X-Achse erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.skewY()

Gibt eine neue DOMMatrix zurück, die durch Anwenden der angegebenen Schertransformation auf die Quellmatrix entlang ihrer Y-Achse erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.toFloat32Array()

Gibt eine neue Float32Array von Gleitkommazahlen mit einfacher Genauigkeit zurück, die alle 16 Elemente enthält, aus denen die Matrix besteht.

DOMMatrixReadOnly.toFloat64Array()

Gibt eine neue Float64Array von Gleitkommazahlen mit doppelter Genauigkeit zurück, die alle 16 Elemente enthält, aus denen die Matrix besteht.

DOMMatrixReadOnly.toJSON()

Gibt eine JSON-Darstellung des DOMMatrixReadOnly Objekts zurück.

DOMMatrixReadOnly.toString()

Erstellt und gibt eine Zeichenfolgendarstellung der Matrix im CSS-Matrix-Syntax zurück, unter Verwendung der entsprechenden CSS-Matrix-Notation.

DOMMatrixReadOnly.transformPoint()

Transformiert den angegebenen Punkt unter Verwendung der Matrix und gibt ein neues DOMPoint Objekt zurück, das den transformierten Punkt enthält. Weder die Matrix noch der ursprüngliche Punkt werden verändert.

DOMMatrixReadOnly.translate()

Gibt eine neue DOMMatrix zurück, die eine Matrix enthält, die durch Übersetzen der Quellmatrix mit dem angegebenen Vektor berechnet wurde. Standardmäßig ist der Vektor (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

Statische Methoden

fromFloat32Array()

Erstellt ein neues veränderbares DOMMatrix Objekt aus einem Array von Gleitkommazahlen mit einfacher Genauigkeit (32-Bit). Hat das Array sechs Werte, ist das Ergebnis eine 2D-Matrix; hat es 16 Werte, ist das Ergebnis eine 3D-Matrix. Andernfalls wird eine TypeError Ausnahme ausgelöst.

fromFloat64Array()

Erstellt ein neues veränderbares DOMMatrix Objekt aus einem Array von Gleitkommazahlen mit doppelter Genauigkeit (64-Bit). Hat das Array sechs Werte, ist das Ergebnis eine 2D-Matrix; hat es 16 Werte, ist das Ergebnis eine 3D-Matrix. Andernfalls wird eine TypeError Ausnahme ausgelöst.

fromMatrix()

Erstellt ein neues veränderbares DOMMatrix Objekt aus einer vorhandenen Matrix oder einem Objekt, das die Werte für seine Eigenschaften bereitstellt. Wenn keine Matrix angegeben ist, wird die Matrix initialisiert, indem jedes Element auf 0 gesetzt wird, mit Ausnahme von der rechten unteren Ecke und dem Element direkt darüber und links daneben: m33 und m34. Diese haben den Standardwert 1.

Spezifikationen

Specification
Geometry Interfaces Module Level 1
# DOMMatrix

Browser-Kompatibilität

Siehe auch

  • Der veränderbare Matrixtyp, DOMMatrix, welcher auf diesem basiert.
  • Die CSS matrix() und matrix3d() Funktionsnotation, die aus diesem Interface generiert werden kann, um sie in einem CSS transform zu verwenden.