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 durch Anwendung eines angegebenen Skalierungsfaktors auf alle drei Achsen modifiziert. Die Skalierung erfolgt zentriert auf dem angegebenen Ursprung, wobei der Standardursprung auf (0, 0, 0) gesetzt ist. Es wird die 3D-geskalierte Matrix zurückgegeben.

Um eine Matrix 3D zu skalieren, ohne sie zu verändern, siehe DOMMatrixReadOnly.scale3d(), welche eine neue skalierte Matrix erstellt, während das Original unverändert bleibt.

Syntax

js
scale3dSelf()
scale3dSelf(scale)
scale3dSelf(scale, originX)
scale3dSelf(scale, originX, originY)
scale3dSelf(scale, originX, originY, originZ)

Parameter

scale

Ein Multiplikator; der Skalierungswert. Wenn kein Skalierungswert angegeben wird, ist der Standardwert 1. Ist der Skalierungswert ungleich 1, wird die is2D-Eigenschaft der aktuellen Matrix auf false gesetzt.

originX Optional

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

originY Optional

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

originZ Optional

Eine z-Koordinate für den Ursprung der Transformation. Wird kein Ursprung angegeben, 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

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
scale3dSelf()

Legend

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

Full support
Full support
See implementation notes.

Siehe auch