DOMMatrixReadOnly: fromMatrix() statische Methode

Baseline Weitgehend verfügbar

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

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

Die fromMatrix() statische Methode des DOMMatrixReadOnly-Interfaces erstellt ein neues DOMMatrixReadOnly-Objekt basierend auf einer vorhandenen Matrix oder einem Objekt, das die Werte für seine Eigenschaften liefert.

In diesem Artikel

Syntax

js
DOMMatrixReadOnly.fromMatrix()
DOMMatrixReadOnly.fromMatrix(other)

Parameter

other Optional

Eine DOMMatrix, DOMMatrixReadOnly oder ein anderes Objekt mit den gleichen Eigenschaften. Alle Eigenschaften sind standardmäßig 0. Die Eigenschaften sind:

is2D

Ein boolescher Wert. true, wenn die Matrix als 2D-Matrix erstellt werden soll. Standardmäßig false, wenn mindestens eines der Elemente m13, m14, m23, m24, m31, m32, m34 oder m43 ungleich null ist oder mindestens eines der Elemente m33 oder m44 nicht gleich 1 ist; sonst standardmäßig true.

m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44

Zahlen, die jede Komponente einer 4×4-Matrix darstellen, wobei m11 bis m14 die erste Spalte sind, m21 bis m24 die zweite Spalte und so weiter. m11, m22, m33 und m44 sind standardmäßig 1, und alle anderen Komponenten sind standardmäßig 0.

Wenn is2D explizit auf true gesetzt ist, müssen m13, m14, m23, m24, m31, m32, m34 oder m43 entweder weggelassen oder auf 0 gesetzt werden, und m33 und m44 müssen entweder weggelassen oder auf 1 gesetzt werden.

a, b, c, d, e, f

Aliase für m11, m12, m21, m22, m41 und m42 für Bequemlichkeit beim Initialisieren von 2D-Matrizen. Wenn diese Aliase zusammen mit den m Gegenstücken bereitgestellt werden, müssen ihre Werte gleich sein.

js
const matrix = DOMMatrixReadOnly.fromMatrix({
  a: 1,
  b: 0,
  c: 0,
  d: 1,
  e: 50,
  f: 50,
  is2D: true,
});

console.log(matrix.toString());
// Output: matrix(1, 0, 0, 1, 50, 50)

console.log(matrix.is2D);
// Output: true

Erstellen einer Matrix aus einer bestehenden Matrix

Dieses Beispiel erstellt eine neue DOMMatrixReadOnly aus einer bestehenden DOMMatrixReadOnly.

js
const matrix1 = new DOMMatrixReadOnly([1, 0, 0, 1, 100, 100]);
const matrix2 = DOMMatrixReadOnly.fromMatrix(matrix1);

console.log(matrix2.toString());
// Output: matrix(1, 0, 0, 1, 100, 100)

Erstellen einer standardmäßigen Identitätsmatrix

Dieses Beispiel zeigt, wie fromMatrix() ohne Argumente eine Identitätsmatrix erstellt.

js
const identityMatrix = DOMMatrixReadOnly.fromMatrix();

console.log(identityMatrix.toString());
// Output: matrix(1, 0, 0, 1, 0, 0)

console.log(identityMatrix.isIdentity);
// Output: true

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

DOMMatrixReadOnly: fromMatrix() statische Methode

In diesem Artikel

Syntax

Parameter

Rückgabewert

Ausnahmen

Beispiele

Erstellen einer Matrix aus einem Objekt

Erstellen einer Matrix aus einer bestehenden Matrix

Erstellen einer standardmäßigen Identitätsmatrix

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN