DOMMatrixReadOnly: scale3d() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

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

Die scale3d() Methode des DOMMatrixReadOnly Interfaces erstellt eine neue Matrix, die das Ergebnis einer 3D-Skalierungstransformation ist, die auf die Matrix angewendet wird. Sie gibt eine neue DOMMatrix zurück, die durch Skalierung der Quell-3D-Matrix mit dem angegebenen Skalierungsfaktor erzeugt wird. Die Skalierung erfolgt zentriert um den Ursprungspunkt, der durch die Ursprungsparameter angegeben wird, wobei der Standardursprung (0, 0, 0) ist. Die ursprüngliche Matrix wird nicht verändert.

Um die Matrix während der 3D-Skalierung zu ändern, siehe DOMMatrix.scale3dSelf().

In diesem Artikel

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 Skalierung 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, was der Standardwert bei Weglassen ist, 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)

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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

Geometry interfaces
DOMMatrixReadOnly
Konstruktor
1. DOMMatrixReadOnly()
Instanzeigenschaften
1. is2D
2. isIdentity
Statische Methoden
Instanzmethoden
Verwandte Seiten für Geometry Interfaces