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. Wennfalse
, 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
bism14
die erste Spalte sind,m21
bism24
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 mitDOMMatrix(-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 mitDOMMatrix(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 mit1
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 beide1
, 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 eineTypeError
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 eineTypeError
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 auf0
gesetzt wird, mit Ausnahme von der rechten unteren Ecke und dem Element direkt darüber und links daneben:m33
undm34
. Diese haben den Standardwert1
.
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()
undmatrix3d()
Funktionsnotation, die aus diesem Interface generiert werden kann, um sie in einem CSStransform
zu verwenden.