DOMMatrixReadOnly: rotateAxisAngle() method

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.

Note: This feature is available in Web Workers.

Phương thức rotateAxisAngle() của giao diện DOMMatrixReadOnly trả về một DOMMatrix mới được tạo bằng cách xoay ma trận nguồn theo vectơ và góc cho trước. Ma trận gốc không bị thay đổi.

Để thay đổi ma trận khi xoay, hãy xem DOMMatrix.rotateAxisAngleSelf().

Cú pháp

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

Tham số

rotX

Một số; tọa độ x của vectơ biểu thị trục xoay. Nếu khác không, is2D là false.

rotY Optional

Một số; tọa độ y của vectơ biểu thị trục xoay. Nếu không được xác định, giá trị rotX sẽ được sử dụng. Nếu khác không, is2D là false.

rotZ Optional

Một số; tọa độ z của vectơ biểu thị trục xoay. Nếu không được xác định, giá trị rotX sẽ được sử dụng.

angle Optional

Một số; góc xoay quanh vectơ trục, tính bằng độ.

Giá trị trả về

Một DOMMatrix.

Ví dụ

js
const matrix = new DOMMatrix(); // tạo một ma trận
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)" (không thay đổi)

Thông số kỹ thuật

Specification
Geometry Interfaces Module Level 1
# dom-dommatrixreadonly-rotateaxisangle

Tương thích trình duyệt

Xem thêm