Baseline Widely available
Note: This feature is available in Web Workers.
The rotate()
method of the DOMMatrixReadOnly
interface returns a new DOMMatrix
created by rotating the source matrix around each of its axes by the specified number of degrees. The original matrix is not altered.
To mutate the matrix as you rotate it, see DOMMatrix.rotateSelf()
.
rotate()
rotate(rotX)
rotate(rotX, rotY)
rotate(rotX, rotY, rotZ)
Parameters
rotX
A number; the x-coordinate of the vector denoting the axis of rotation. If non-zero, is2D
is false.
rotY
Optional
A number; the y-coordinate of the vector denoting the axis of rotation. If non-zero, is2D
is false.
rotZ
Optional
A number; the z-coordinate of the vector denoting the axis of rotation.
If only rotX
is passed, then rotX
is used as the value for the z-coordinate, and the x- and -y-coordinates are both set to zero.
A DOMMatrix
.
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString());
// output: "matrix(1, 0, 0, 1, 0, 0)"
const rotated = matrix.rotate(30); // rotation and assignment
console.log(matrix.toString()); // original matrix is unchanged
// output: "matrix(1, 0, 0, 1, 0, 0)"
console.log(rotated.toString());
// output: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4