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

js
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

js
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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
scale3d()

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Siehe auch