DOMMatrixReadOnly

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

Doppelpräzisions-Gleitkommazahlen, die jede Komponente einer 4×4-Matrix darstellen, wobei m11 bis m14 die erste Spalte, m21 bis m24 die zweite Spalte usw. sind.

a, b, c, d, e, f

Doppelpräzisions-Gleitkommazahlen, die die Komponenten einer 4×4-Matrix repräsentieren, die erforderlich sind, um 2D-Drehungen und -Translationen durchzuführen. 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 Invertieren der Quellmatrix erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.multiply()

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

DOMMatrixReadOnly.rotateAxisAngle()

Gibt eine neue DOMMatrix zurück, die durch das 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 das Drehen der Quellmatrix um jede ihrer Achsen um die angegebene Gradzahl erstellt wurde. Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.rotateFromVector()

Gibt eine neue DOMMatrix zurück, die durch Drehung 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 Skalierung der Quellmatrix um den für jede Achse angegebenen Betrag, zentriert auf den angegebenen Ursprung, erstellt wurde. Standardmäßig werden die X- und Z-Achse um 1 skaliert, und die Y-Achse hat keinen Standard-Skalierungswert. Der Standardursprung ist (0, 0, 0). Die ursprüngliche Matrix wird nicht verändert.

DOMMatrixReadOnly.scale3d()

Gibt eine neue DOMMatrix zurück, die durch Skalierung der Quell-3D-Matrix um den angegebenen Faktor entlang aller ihrer Achsen, zentriert auf den spezifizierten Ursprungspunkt, erstellt wurde. 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 an den X-, Y- und Z-Achsen, zentriert am angegebenen Ursprung, erstellt wurde. Standardmäßig betragen die Skalierungsfaktoren der Y- und Z-Achsen beide 1, aber der Skalierungsfaktor für X 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 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 ein neues Float32Array von Einzelpräzisions-Gleitkommazahlen zurück, das alle 16 Elemente enthält, aus denen die Matrix besteht.

DOMMatrixReadOnly.toFloat64Array()

Gibt ein neues Float64Array von Doppelpräzisions-Gleitkommazahlen zurück, das 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 in der CSS-Matrix-Syntax zurück, unter Verwendung der entsprechenden CSS-Matrix-Notation.

DOMMatrixReadOnly.transformPoint()

Transformiert den angegebenen Punkt mit 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 das Ü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 DOMMatrixReadOnly Objekt, das ein Float32Array von 6 oder 16 Einzelpräzisions-(32-Bit)-Gleitkommazahlen darstellt.

fromFloat64Array()

Erstellt ein neues DOMMatrixReadOnly Objekt, das ein Float64Array von 6 oder 16 Doppelpräzisions-(64-Bit)-Gleitkommazahlen darstellt.

fromMatrix()

Erstellt ein neues DOMMatrixReadOnly Objekt, indem eine vorhandene Matrix oder ein Objekt, das die Werte für seine Eigenschaften bereitstellt, verwendet wird.

Spezifikationen

Browser-Kompatibilität

Siehe auch

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