DOMMatrixReadOnly: scale3d() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die scale3d() Methode des DOMMatrixReadOnly Interfaces erstellt eine neue Matrix, die das Ergebnis einer 3D-Skalierungstransformation ist, die auf die Matrix angewendet wird. Sie gibt eine neue DOMMatrix zurück, die durch Skalierung der Quell-3D-Matrix mit dem angegebenen Skalierungsfaktor erzeugt wird. Die Skalierung erfolgt zentriert um den Ursprungspunkt, der durch die Ursprungsparameter angegeben wird, wobei der Standardursprung (0, 0, 0) ist. Die ursprüngliche Matrix wird nicht verändert.
Um die Matrix während der 3D-Skalierung zu ändern, siehe DOMMatrix.scale3dSelf().
Syntax
scale3d()
scale3d(scale)
scale3d(scale, originX)
scale3d(scale, originX, originY)
scale3d(scale, originX, originY, originZ)
Parameter
scale-
Ein Multiplikator; der Skalierungswert. Wenn keine Skalierung angegeben ist, beträgt der Standardwert
1. originXOptional-
Eine x-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben ist, beträgt der Standardwert
0. originYOptional-
Eine y-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben ist, beträgt der Standardwert
0. originZOptional-
Eine z-Koordinate für den Ursprung der Transformation. Wenn dieser Wert
0ist, was der Standardwert bei Weglassen ist, könnte die resultierende Matrix nicht 3D sein.
Rückgabewert
Eine DOMMatrix.
Beispiele
const matrix = new DOMMatrix();
console.log(matrix.toString()); // no transforms applied
// 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()); // original matrix is unchanged
// matrix(1, 0, 0, 1, 0, 0)
Spezifikationen
| Specification |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-scale3d |
Browser-Kompatibilität
Siehe auch
DOMMatrix.scale3dSelf()DOMMatrixReadOnly.scale()- Die CSS
transformEigenschaft und diescale3d()undmatrix3d()Funktionen - CSS-Transformationen Modul
- SVG
transformAttribut - Die
CanvasRenderingContext2DSchnittstelle und dieCanvasRenderingContext2D.transform()Methode