DOMMatrix: scale3dSelf() 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 scale3dSelf() của giao diện DOMMatrix là phương thức biến đổi có thể thay đổi, sửa đổi một ma trận bằng cách áp dụng hệ số tỷ lệ được chỉ định cho cả ba trục, lấy tâm tại gốc tọa độ cho trước với gốc tọa độ mặc định là (0, 0, 0), trả về ma trận 3D đã được thu phóng.

Để thu phóng 3D một ma trận mà không làm thay đổi nó, hãy xem DOMMatrixReadOnly.scale3d(), phương thức này tạo một ma trận thu phóng mới trong khi giữ nguyên ma trận gốc.

Cú pháp

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

Tham số

scale

Hệ số nhân; giá trị tỷ lệ. Nếu không có tỷ lệ nào được cung cấp, mặc định là 1. Nếu tỷ lệ khác 1, thuộc tính is2D của ma trận hiện tại sẽ được đặt thành false.

originX Optional

Tọa độ x của gốc biến đổi. Nếu không có gốc tọa độ nào được cung cấp, mặc định là 0.

originY Optional

Tọa độ y của gốc biến đổi. Nếu không có gốc tọa độ nào được cung cấp, mặc định là 0.

originZ Optional

Tọa độ z của gốc biến đổi. Nếu không có gốc tọa độ nào được cung cấp, mặc định là 0.

Giá trị trả về

Trả về chính nó; một DOMMatrix.

Ví dụ

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) (giống như trên) */

Thông số kỹ thuật

Specification
Geometry Interfaces Module Level 1
# dom-dommatrix-scale3dself

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

Xem thêm