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 January 2020.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die scale3d()
Methode der DOMMatrixReadOnly
-Schnittstelle erzeugt eine neue Matrix, die das Ergebnis einer 3D-Skalentransformation ist, die auf die Matrix angewendet wird. Sie gibt eine neue DOMMatrix
zurück, die durch Skalierung der Ausgangs-3d-Matrix mit dem angegebenen Skalierungsfaktor erstellt wurde, zentriert auf den Ursprungspunkt, der durch die Ursprungsparameter angegeben wird, mit einem Standardursprung von (0, 0, 0)
. Die ursprüngliche Matrix wird nicht verändert.
Um die Matrix zu ändern, während Sie sie 3D-skalieren, 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 Skala angegeben ist, beträgt der Standardwert
1
. originX
Optional-
Eine x-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben ist, beträgt der Standardwert
0
. originY
Optional-
Eine y-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben ist, beträgt der Standardwert
0
. originZ
Optional-
Eine z-Koordinate für den Ursprung der Transformation. Wenn dieser Wert
0
ist, das Standardwert wenn weggelassen, 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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
scale3d() |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.
Siehe auch
DOMMatrix.scale3dSelf()
DOMMatrixReadOnly.scale()
- CSS-Eigenschaft
transform
undscale3d()
undmatrix3d()
Funktionen - Das Modul CSS transforms
- SVG
transform
Attribut - Die
CanvasRenderingContext2D
-Schnittstelle und derenCanvasRenderingContext2D.transform()
-Methode