DOMMatrix: preMultiplySelf() 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 preMultiplySelf() Methode der DOMMatrix Schnittstelle modifiziert die Matrix, indem sie vor-multipliziert wird mit der angegebenen DOMMatrix. Dies entspricht dem Punktprodukt B⋅A, wobei die Matrix A die Quellmatrix ist und B die als Eingabe für die Methode angegebene Matrix ist. Wenn keine Matrix als Multiplikator angegeben wird, wird die Matrix mit einer Matrix multipliziert, bei der jedes Element 0 ist, außer der unteren rechten Ecke und dem Element direkt darüber und links daneben: m33 und m34. Diese haben den Standardwert 1.

Syntax

js
  DOMMatrix.preMultiplySelf()
  DOMMatrix.preMultiplySelf(otherMatrix)

Parameter

otherMatrix Optional

Der DOMMatrix Multiplikator.

Rückgabewert

Gibt sich selbst zurück; eine DOMMatrix, die auf die Ergebnisse der angewandten Multiplikationen aktualisiert wurde.

Beispiele

js
const matrix = new DOMMatrix().translate(3, 22);
const otherMatrix = new DOMMatrix().translateSelf(15, 45);

console.log(matrix.toString()); // output: matrix(1, 0, 0, 1, 3, 22)
console.log(otherMatrix.toString()); // output: matrix(1, 0, 0, 1, 15, 45)

matrix.preMultiplySelf(otherMatrix);

console.log(matrix.toString()); // output: matrix(1, 0, 0, 1, 18, 67)
console.log(otherMatrix.toString()); // output: matrix(1, 0, 0, 1, 15, 45)

Spezifikationen

Specification
Geometry Interfaces Module Level 1
# dom-dommatrix-premultiplyself

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch