DOMMatrixReadOnly: scale3d() 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 scale3d() của giao diện DOMMatrixReadOnly tạo một ma trận mới là kết quả của phép biến đổi thu phóng 3D được áp dụng lên ma trận. Nó trả về một DOMMatrix mới được tạo bằng cách thu phóng ma trận 3D nguồn theo hệ số tỷ lệ cho trước lấy tâm tại điểm gốc tọa độ được chỉ định bởi các tham số gốc, với gốc tọa độ mặc định là (0, 0, 0). Ma trận gốc không bị thay đổi.
Để thay đổi ma trận khi thu phóng 3D, hãy xem DOMMatrix.scale3dSelf()
Cú pháp
scale3d()
scale3d(scale)
scale3d(scale, originX)
scale3d(scale, originX, originY)
scale3d(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. originXOptional-
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. originYOptional-
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. originZOptional-
Tọa độ z của gốc biến đổi. Nếu giá trị này là
0, là mặc định nếu bị bỏ qua, ma trận kết quả có thể không phải 3D.
Giá trị trả về
Một DOMMatrix.
Ví dụ
const matrix = new DOMMatrix();
console.log(matrix.toString()); // không có phép biến đổi nào được áp dụng
// matrix(1, 0, 0, 1, 0, 0)
console.log(matrix.scale3d(2).toString());
/* matrix3d(
2, 0, 0, 0,
0, 2, 0, 0,
0, 0, 2, 0,
0, 0, 0, 1) */
console.log(matrix.scale3d(0.5, 25, 25, 1.25).toString());
/* matrix3d(
0.5, 0, 0, 0,
0, 0.5, 0, 0,
0, 0, 0.5, 0, 1
2.5, 12.5, 0.625, 1) */
console.log(matrix.toString()); // ma trận gốc không thay đổi
// matrix(1, 0, 0, 1, 0, 0)
Thông số kỹ thuật
| Specification |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-scale3d |
Tương thích trình duyệt
Xem thêm
DOMMatrix.scale3dSelf()DOMMatrixReadOnly.scale()- CSS
transformproperty andscale3d()andmatrix3d()functions - CSS transforms module
- SVG
transformattribute CanvasRenderingContext2Dinterface'sCanvasRenderingContext2D.transform()method