DOMMatrixReadOnly

Konstruktor

DOMMatrixReadOnly()

Erstellt ein neues DOMMatrixReadOnly-Objekt.

Instanzeigenschaften

Dieses Interface 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 jeweils eine Komponente 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 benötigten 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

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 dessen Eigenschaften bereitstellt.

Instanzmethoden

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 Ausgangsmatrix an ihrer X-Achse entsteht. Dies entspricht einer 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 entsteht. Dies entspricht einer 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 entsteht. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.multiply()

Gibt eine neue DOMMatrix zurück, die durch Berechnung des Skalarprodukts der Ausgangsmatrix und der angegebenen Matrix entsteht. 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 entsteht. 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 entsteht. 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) entsteht. 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 entsteht, wobei der angegebene Ursprung als Mittelpunkt dient. Standardmäßig werden die X- und Z-Achse mit dem Faktor 1 skaliert; für die Y-Achse ist kein Skalierungswert voreingestellt. 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 mit dem angegebenen Faktor entlang aller ihrer Achsen entsteht, wobei der angegebene Ursprungspunkt als Mittelpunkt dient. 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 entlang der X-, Y- und Z-Achse entsteht, wobei der angegebene Ursprung als Mittelpunkt dient. 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 Schertransformation entlang der X-Achse auf die Ausgangsmatrix entsteht. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.skewY()

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

DOMMatrixReadOnly.toFloat32Array()

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

DOMMatrixReadOnly.toFloat64Array()

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

DOMMatrixReadOnly.toJSON()

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

DOMMatrixReadOnly.toString()

Erstellt eine Zeichenfolgendarstellung 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, deren Matrix durch Translation der Ausgangsmatrix mithilfe des angegebenen Vektors berechnet wurde. Standardmäßig ist der Vektor (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

Spezifikationen

Browser-Kompatibilität

Siehe auch

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