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 der DOMMatrix-Schnittstelle ist eine veränderbare Transformationsmethode, die eine Matrix durch Anwenden eines bestimmten Skalierungsfaktors auf alle drei Achsen verändert. Der Mittelpunkt befindet sich dabei am angegebenen Ursprung, wobei der Standardursprung (0, 0, 0) ist. Sie gibt die 3D-skalierten Matrix zurück.
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 kein Skalierungswert angegeben wird, ist der Standardwert
1. Falls der Skalierungswert nicht 1 ist, wird dieis2D-Eigenschaft der aktuellen Matrix auffalsegesetzt. originXOptional-
Eine x-Koordinate für den Ursprung der Transformation. Wird kein Ursprung angegeben, ist der Standardwert
0. originYOptional-
Eine y-Koordinate für den Ursprung der Transformation. Wird kein Ursprung angegeben, ist der Standardwert
0. originZOptional-
Eine z-Koordinate für den Ursprung der Transformation. Wird kein Ursprung angegeben, 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-Transformationen-Modul
- SVG
transform-Attribut CanvasRenderingContext2D-Schnittstelletransform()-Methode