DOMMatrixReadOnly

Konstruktor

DOMMatrixReadOnly()

Erstellt ein neues DOMMatrixReadOnly-Objekt.

Instanzeigenschaften

Diese Schnittstelle erbt keine Eigenschaften.

DOMMatrixReadOnly.is2D Schreibgeschützt

Ein boolescher Wert, der true ist, wenn die Matrix als 2D-Matrix initialisiert wurde. Bei false ist die Matrix eine 3D-Matrix.

DOMMatrixReadOnly.isIdentity Schreibgeschützt

Ein boolescher Wert, der true ist, wenn die Matrix eine Einheitsmatrix ist.

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

Gleitkommawerte mit doppelter Genauigkeit, die die einzelnen Komponenten einer 4×4-Matrix darstellen. Dabei bilden m11 bis m14 die erste Spalte, m21 bis m24 die zweite Spalte und so weiter.

a, b, c, d, e, f Schreibgeschützt

Gleitkommawerte mit doppelter Genauigkeit, die die für 2D-Rotationen und -Translationen erforderlichen Komponenten einer 4×4-Matrix darstellen. Sie sind Aliase für bestimmte Komponenten einer 4×4-Matrix, wie unten dargestellt.

2D	3D-Entsprechung
a	m11
b	m12
c	m21
d	m22
e	m41
f	m42

Instanzmethoden

Diese Schnittstelle 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 Ausgangsmatrix an ihrer X-Achse erstellt wird. 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 Ausgangsmatrix an ihrer Y-Achse erstellt wird. 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 Invertieren der Ausgangsmatrix erstellt wird. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.multiply()

Gibt eine neue DOMMatrix zurück, die durch Berechnen des Skalarprodukts der Ausgangsmatrix und der angegebenen Matrix erstellt wird. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.rotateAxisAngle()

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

DOMMatrixReadOnly.rotate()

Gibt eine neue DOMMatrix zurück, die durch Drehen der Ausgangsmatrix um jede ihrer Achsen um die jeweils angegebene Gradzahl erstellt wird. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.rotateFromVector()

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

DOMMatrixReadOnly.scale()

Gibt eine neue DOMMatrix zurück, die durch Skalieren der Ausgangsmatrix um den für jede Achse angegebenen Betrag mit dem angegebenen Ursprung als Zentrum erstellt wird. Standardmäßig werden die X- und Z-Achse mit dem Faktor 1 skaliert; für die Y-Achse gibt es keinen Standardskalierungswert. Der Standardursprung ist (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.scale3d()

Gibt eine neue DOMMatrix zurück, die durch Skalieren der 3D-Ausgangsmatrix entlang aller Achsen um den angegebenen Faktor mit dem angegebenen Ursprungspunkt als Zentrum erstellt wird. Der Standardursprung ist (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.scaleNonUniform()

Gibt eine neue DOMMatrix zurück, die durch Anwenden der angegebenen Skalierung auf die X-, Y- und Z-Achse mit dem angegebenen Ursprung als Zentrum erstellt wird. Standardmäßig betragen die Skalierungsfaktoren für die Y- und Z-Achse jeweils 1; der Skalierungsfaktor für die X-Achse muss angegeben werden. Der Standardursprung 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 Scherung entlang der X-Achse auf die Ausgangsmatrix erstellt wird. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.skewY()

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

DOMMatrixReadOnly.toFloat32Array()

Gibt ein neues Float32Array mit Gleitkommawerten einfacher Genauigkeit zurück, das alle 16 Elemente der Matrix enthält.

DOMMatrixReadOnly.toFloat64Array()

Gibt ein neues Float64Array mit Gleitkommawerten doppelter Genauigkeit zurück, das alle 16 Elemente der Matrix enthält.

DOMMatrixReadOnly.toJSON()

Gibt ein als JSON serialisierbares einfaches Objekt zurück, das das DOMMatrixReadOnly-Objekt repräsentiert. Die Methode wird automatisch von JSON.stringify() aufgerufen.

DOMMatrixReadOnly.toString()

Erstellt eine Zeichenkettendarstellung der Matrix in CSS-Matrixsyntax mit der passenden CSS-Matrixnotation und gibt sie zurück.

DOMMatrixReadOnly.transformPoint()

Transformiert den angegebenen Punkt mithilfe 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 durch Translation der Ausgangsmatrix mit dem angegebenen Vektor berechnete Matrix enthält. Standardmäßig ist der Vektor (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

Statische Methoden

fromFloat32Array()

Erstellt ein neues DOMMatrixReadOnly-Objekt aus einem Float32Array mit 6 oder 16 Gleitkommawerten einfacher Genauigkeit (32 Bit).

fromFloat64Array()

Erstellt ein neues DOMMatrixReadOnly-Objekt aus einem Float64Array mit 6 oder 16 Gleitkommawerten doppelter Genauigkeit (64 Bit).

fromMatrix()

Erstellt ein neues DOMMatrixReadOnly-Objekt aus einer vorhandenen Matrix oder einem Objekt, das die Werte für deren Eigenschaften bereitstellt.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Der veränderbare Matrixtyp DOMMatrix, der auf dieser Schnittstelle basiert.
• Die funktionalen CSS-Notationen matrix() und matrix3d(), die aus dieser Schnittstelle erzeugt und in einer CSS-transform verwendet werden können.