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 January 2020.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die scale3dSelf()-Methode der DOMMatrix-Schnittstelle ist eine veränderbare Transformationsmethode, die eine Matrix modifiziert, indem sie einen angegebenen Skalierungsfaktor auf alle drei Achsen anwendet, zentriert auf den angegebenen Ursprung, mit einem Standardursprung von (0, 0, 0), und die 3D-scalierte Matrix zurückgibt.

Um eine Matrix in 3D zu skalieren, ohne sie zu verändern, siehe DOMMatrixReadOnly.scale3d(), die eine neue skalierte Matrix erstellt, während die ursprüngliche unverändert bleibt.

Syntax

Die scale3dSelf()-Methode kann mit null bis vier Werten angegeben werden.

js
DOMMatrix.scale3dSelf();
DOMMatrix.scale3dSelf(scale);
DOMMatrix.scale3dSelf(scale, originX);
DOMMatrix.scale3dSelf(scale, originX, originY);
DOMMatrix.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 die is2D Eigenschaft der aktuellen Matrix auf false gesetzt.

originX Optional

Eine x-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, ist der Standardwert 0.

originY Optional

Eine y-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, ist der Standardwert 0.

originZ Optional

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

js
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

BCD tables only load in the browser

Siehe auch