Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

DOMMatrix: rotateAxisAngleSelf() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die rotateAxisAngleSelf() Methode der DOMMatrix-Schnittstelle ist eine Transformationsmethode, die die Ausgangsmatrix um den angegebenen Vektor und Winkel dreht und die veränderte Matrix zurückgibt.

Um eine Matrix zu drehen, ohne sie zu verändern, siehe DOMMatrixReadOnly.rotateAxisAngle(), die eine neue gedrehte Matrix erstellt, während das Original unverändert bleibt.

Syntax

js
rotateAxisAngleSelf()
rotateAxisAngleSelf(rotX)
rotateAxisAngleSelf(rotX, rotY)
rotateAxisAngleSelf(rotX, rotY, rotZ)
rotateAxisAngleSelf(rotX, rotY, rotZ, angle)

Parameter

rotX

Eine Zahl; die x-Koordinate des Vektors, der die Rotationsachse angibt. Ist dieser Wert ungleich null, ist is2D falsch.

rotY Optional

Eine Zahl; die y-Koordinate des Vektors, der die Rotationsachse angibt. Wenn nicht definiert, wird der rotX-Wert verwendet. Ist dieser Wert ungleich null, ist is2D falsch.

rotZ Optional

Eine Zahl; die z-Koordinate des Vektors, der die Rotationsachse angibt. Wenn nicht definiert, wird der rotX-Wert verwendet.

angle Optional

Eine Zahl; der Winkel der Rotation um den Achsenvektor, in Grad.

Wenn rotY und rotZ fehlen, wird rotZ auf den Wert von rotX gesetzt und sowohl rotX als auch rotY sind 0.

Rückgabewert

Eine DOMMatrix.

Beispiele

js
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.rotateAxisAngleSelf(10, 20, 30, 45).toString());
/* "matrix3d(
    0.728, 0.609, -0.315, 0, 
    -0.525, 0.791, 0.315, 0, 
    0.441, -0.063, 0.895, 
    0, 0, 0, 0, 1)" */
console.log(matrix.toString());
/* "matrix3d(
    0.728, 0.609, -0.315, 0, 
    -0.525, 0.791, 0.315, 0, 
    0.441, -0.063, 0.895, 0, 
    0, 0, 0, 1)" */

Spezifikationen

Spezifikation
Geometry Interfaces Module Level 1
# dom-dommatrix-rotateaxisangleself

Browser-Kompatibilität

Siehe auch