DOMMatrixReadOnly: rotateAxisAngle() 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 rotateAxisAngle()-Methode des DOMMatrixReadOnly-Interfaces gibt eine neue DOMMatrix zurück, die durch Drehen der Ausgangsmatrix um den angegebenen Vektor und Winkel erstellt wird. Die ursprüngliche Matrix wird nicht verändert.
Um die Matrix während der Drehung zu verändern, siehe DOMMatrix.rotateAxisAngleSelf().
Syntax
rotateAxisAngle()
rotateAxisAngle(rotX)
rotateAxisAngle(rotX, rotY)
rotateAxisAngle(rotX, rotY, rotZ)
rotateAxisAngle(rotX, rotY, rotZ, angle)
Parameter
rotX-
Eine Zahl; die x-Koordinate des Vektors, der die Rotationsachse angibt. Wenn nicht null, ist
is2Dfalse. rotYOptional-
Eine Zahl; die y-Koordinate des Vektors, der die Rotationsachse angibt. Falls nicht definiert, wird der
rotX-Wert verwendet. Wenn nicht null, istis2Dfalse. rotZOptional-
Eine Zahl; die z-Koordinate des Vektors, der die Rotationsachse angibt. Falls nicht definiert, wird der
rotX-Wert verwendet. angleOptional-
Eine Zahl; der Winkel der Drehung um den Achsenvektor in Grad.
Rückgabewert
Eine DOMMatrix.
Beispiele
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.rotateAxisAngle().toString()); // matrix(1, 0, 0, 1, 0, 0)
console.log(matrix.rotateAxisAngle(10, 20, 30).toString()); // matrix(1, 0, 0, 1, 0, 0)
console.log(matrix.rotateAxisAngle(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.rotateAxisAngle(5, 5, 5, -45).toString());
/* matrix3d(
0.805, -0.311, 0.506, 0,
0.506, 0.805, -0.311, 0,
-0.311, 0.506, 0.805, 0,
0, 0, 0, 1) */
console.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)" (unchanged)
Spezifikationen
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-rotateaxisangle |
Browser-Kompatibilität
Siehe auch
DOMMatrix.rotateAxisAngleSelf()DOMMatrixReadOnly.rotate()DOMMatrixReadOnly.rotateFromVector()- CSS
transformEigenschaft undrotate3d()Funktion - CSS
rotateEigenschaft - CSS-Transformationen Modul
- SVG
transformAttribut CanvasRenderingContext2D-Interface undrotate()-Methode