DOMMatrix: scale3dSelf() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die scale3dSelf()-Methode des DOMMatrix-Interfaces ist eine veränderliche Transformationsmethode, die eine Matrix modifiziert, indem ein bestimmter Skalierungsfaktor auf alle drei Achsen angewendet wird, zentriert auf dem angegebenen Ursprung, mit dem Standardursprung (0, 0, 0), und die 3D-skalierte Matrix zurückgibt.
Um eine Matrix in 3D zu skalieren, ohne sie zu verändern, siehe DOMMatrixReadOnly.scale3d(), das eine neue skalierte Matrix erstellt, während die ursprüngliche unverändert bleibt.
Syntax
scale3dSelf()
scale3dSelf(scale)
scale3dSelf(scale, originX)
scale3dSelf(scale, originX, originY)
scale3dSelf(scale, originX, originY, originZ)
Parameter
scale-
Ein Multiplikator; der Skalierungswert. Wenn keine Skalierung angegeben wird, ist der Standardwert
1. Wenn die Skalierung nicht 1 ist, wird dieis2D-Eigenschaft der aktuellen Matrix auffalsegesetzt. originXOptional-
Eine x-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, ist der Standardwert
0. originYOptional-
Eine y-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, ist der Standardwert
0. originZOptional-
Eine z-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, ist der Standardwert
0.
Rückgabewert
Gibt sich selbst zurück; eine DOMMatrix.
Beispiele
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) */
Spezifikationen
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrix-scale3dself |
Browser-Kompatibilität
Siehe auch
DOMMatrixReadOnly.scale3d()DOMMatrix.scaleSelf()- CSS
transform-Eigenschaft und diescale3d()- undmatrix3d()-Funktionen - CSS-Transforms-Modul
- SVG
transform-Attribut CanvasRenderingContext2D-Interfacetransform()-Methode