DOMMatrix: rotateAxisAngleSelf() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年1月.

メモ: この機能はウェブワーカー内で利用可能です。

rotateAxisAngleSelf() は DOMMatrix インターフェイスのメソッドで、指定されたベクトルと角度でソース行列を回転させる座標変換メソッドであり、変更後の行列を返します。

行列を変更せずに回転させるには、DOMMatrixReadOnly.rotateAxisAngle() を参照してください。これは元の行列を変更せずに、新しい回転後の行列を生成します。

構文

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 省略可: 数値です。ベクトル軸の周囲を開店する角度の度数です。

rotY と rotZ の両方が省略されている場合、rotZ は rotX の値に設定され、rotX と rotY の両方が 0 となります。

返値

DOMMatrix です。

例

const matrix = new DOMMatrix(); // 行列を作成
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)" */