DOMMatrix: rotateSelf() Methode

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.

Die rotateSelf()-Methode des DOMMatrix Interfaces ist eine veränderliche Transformationsmethode, die eine Matrix modifiziert. Sie dreht die Ausgangsmatrix um jede ihrer Achsen um die angegebene Gradzahl und gibt die gedrehte Matrix zurück.

Um eine Matrix zu drehen, ohne sie zu verändern, siehe DOMMatrixReadOnly.rotate().

Syntax

js
rotateSelf()
rotateSelf(rotX)
rotateSelf(rotX, rotY)
rotateSelf(rotX, rotY, rotZ)

Parameter

rotX

Eine Zahl; die x-Koordinate des Vektors, der die Drehachse angibt.

rotY Optional

Eine Zahl; die y-Koordinate des Vektors, der die Drehachse angibt.

rotZ Optional

Eine Zahl; die z-Koordinate des Vektors, der die Drehachse angibt.

Wird nur ein Parameter übergeben, ist rotZ der Wert von rotX, und sowohl rotX als auch rotY sind 0, und die Drehung ist eine 2D-Drehung. Wenn rotX und rotY ungleich null sind, ist is2D false.

Rückgabewert

Gibt sich selbst zurück; die DOMMatrix, die um die angegebenen Vektoren gedreht wurde.

Beispiele

js
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)"
matrix.rotateSelf(30); // mutate it
console.log(matrix); // output: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"

Spezifikationen

Specification
Geometry Interfaces Module Level 1
# dom-dommatrix-rotateself

Browser-Kompatibilität

Siehe auch