DOMMatrix: rotateAxisAngleSelf() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

注意:此功能在 Web Workers 中可用。

DOMMatrix 介面的 rotateAxisAngleSelf() 方法是一個變換方法,它透過給定的向量和角度來旋轉源矩陣,並返回修改後的矩陣。

要旋轉矩陣而不對其進行變異,請參閱 DOMMatrixReadOnly.rotateAxisAngle(),它會建立一個新的旋轉矩陣,同時保持原始矩陣不變。

語法

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

引數

rotX

一個數字;表示旋轉軸的向量的 x 座標。如果非零,則 is2D 為 false。

rotY 可選

一個數字;表示旋轉軸的向量的 y 座標。如果未定義,則使用 rotX 的值。如果非零,則 is2D 為 false。

rotZ 可選

一個數字;表示旋轉軸的向量的 z 座標。如果未定義,則使用 rotX 的值。

angle 可選

一個數字;繞軸向量旋轉的角度(以度為單位)。

如果同時缺少 rotYrotZ,則將 rotZ 設定為 rotX 的值,並且 rotXrotY 都為 0

返回值

一個 DOMMatrix

示例

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)" */

規範

規範
Geometry Interfaces Module Level 1
# dom-dommatrix-rotateaxisangleself

瀏覽器相容性

另見