DOMMatrixReadOnly: multiply() method

Note: This feature is available in Web Workers.

The multiply() method of the DOMMatrixReadOnly interface creates and returns a new matrix which is the dot product of the matrix and the otherMatrix parameter. If otherMatrix is omitted, the matrix is multiplied by a matrix in which every element is 0 except the bottom-right corner and the element immediately above and to its left: m33 and m34. These have the default value of 1. The original matrix is not modified.

To mutate the matrix as you multiply it, see DOMMatrix.multiplySelf().

Syntax

js
multiply()
multiply(otherMatrix)

Parameters

otherMatrix Optional

The DOMMatrix multiplier.

Return value

A DOMMatrix.

Examples

js
const matrix = new DOMMatrixReadOnly().translate(13, 21);
const multipliedMatrix = matrix.multiply(matrix);
console.log(matrix.toString()); // output: matrix(1, 0, 0, 1, 13, 21)
console.log(multipliedMatrix.toString()); // output: matrix(1, 0, 0, 1, 26, 42)

Specifications

See also