DOMMatrixReadOnly: rotateAxisAngle() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
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
| Specification |
|---|
| 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