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 ⁨Januar 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 darstellt, die auf die Matrix angewendet wird. Sie gibt eine neue DOMMatrix zurück, die durch Skalieren der Quell-3D-Matrix mit dem angegebenen Skalierungsfaktor erzeugt wurde. Dieser ist zentriert auf den Ursprungskoordinaten, die durch die Ursprungsparameter angegeben werden, mit einem Standardursprung (0, 0, 0). Die Originalmatrix wird nicht verändert.

Um die Matrix zu verändern, während Sie sie 3D-skalieren, siehe DOMMatrix.scale3dSelf().

Syntax

scale3d()
scale3d(scale)
scale3d(scale, originX)
scale3d(scale, originX, originY)
scale3d(scale, originX, originY, originZ)

Parameter

scale: Ein Multiplikator; der Skalenwert. Wenn keine Skala angegeben wird, ist der Standardwert 1.
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 dieser Wert 0 ist, was der Standardwert ist, wenn nichts angegeben ist, kann die resultierende Matrix möglicherweise nicht 3D sein.

Rückgabewert

Eine DOMMatrix.

Beispiele

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

Siehe auch

DOMMatrix.scale3dSelf()
DOMMatrixReadOnly.scale()
CSS transform Eigenschaft und scale3d() und matrix3d() Funktionen
CSS-Transformationen Modul
SVG transform Attribut
Methode CanvasRenderingContext2D.transform() der CanvasRenderingContext2D Schnittstelle

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden