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 Anwendung eines angegebenen Skalierungsfaktors auf alle drei Achsen verändert, zentriert auf den angegebenen Ursprung, mit einem Standardursprung von (0, 0, 0). Die Methode gibt die 3D-skalierte Matrix zurück.

Um eine Matrix in 3D zu skalieren, ohne sie zu verändern, siehe DOMMatrixReadOnly.scale3d(), die eine neue skalierte Matrix erstellt, während das Original 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 keine Skalierung angegeben wird, beträgt 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, beträgt der Standardwert 0.
originY Optional: Eine y-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, beträgt der Standardwert 0.
originZ Optional: Eine z-Koordinate für den Ursprung der Transformation. Wenn kein Ursprung angegeben wird, beträgt 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 die scale3d() und matrix3d() Funktionen
CSS-Transformationen Modul
SVG transform Attribut
CanvasRenderingContext2D Schnittstelle transform() Methode

Help improve MDN

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

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