DOMMatrix: scale3dSelf() 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 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
| Specification |
|---|
| 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