DOMMatrix: scale3dSelf() 方法

Baseline 已廣泛支援

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

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

scale3dSelf() 方法是 DOMMatrix 介面的一個可變轉換方法,它透過在給定原點上將指定的縮放因子應用於所有三個軸來修改矩陣,預設原點為 (0, 0, 0),並返回 3D 縮放後的矩陣。

要 3D 縮放矩陣而不改變它,請參閱 DOMMatrixReadOnly.scale3d(),它會建立一個新的縮放矩陣,同時保持原始矩陣不變。

語法

js
scale3dSelf()
scale3dSelf(scale)
scale3dSelf(scale, originX)
scale3dSelf(scale, originX, originY)
scale3dSelf(scale, originX, originY, originZ)

引數

scale

乘數;縮放值。如果未提供縮放值,則預設為 1。如果縮放值不是 1,則當前矩陣的 is2D 屬性將設定為 false

originX 可選

轉換原點的 x 座標。如果未提供原點,則預設為 0

originY 可選

轉換原點的 y 座標。如果未提供原點,則預設為 0

originZ 可選

轉換原點的 z 座標。如果未提供原點,則預設為 0

返回值

返回自身;一個 DOMMatrix 物件。

示例

js
const matrix = new DOMMatrix();
console.log(matrix.scale3dSelf(2).toString());
/* matrix3d(
    2, 0, 0, 0, 
    0, 2, 0, 0, 
    0, 0, 2, 0, 
    0, 0, 0, 1) */
console.log(matrix.scale3dSelf(3.1, 25, 25, 1.25).toString());
/* matrix3d(
    6.2, 0, 0, 0,
    0, 6.2, 0, 0, 
    0, 0, 6.2, 0, 
    -105, -105, -5.25, 1) */
console.log(matrix.toString());
/* matrix3d(
    6.2, 0, 0, 0, 
    0, 6.2, 0, 0, 
    0, 0, 6.2, 0, 
    -105, -105, -5.25, 1) (same as above) */

規範

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

瀏覽器相容性

另見