DOMMatrix: preMultiplySelf() method

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.

See full compatibility

Note: This feature is available in Web Workers.

The preMultiplySelf() method of the DOMMatrix interface modifies the matrix by pre-multiplying it with the specified DOMMatrix. This is equivalent to the dot product B⋅A, where matrix A is the source matrix and B is the matrix given as an input to the method. If no matrix is specified as the multiplier, 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.

Syntax

preMultiplySelf()
preMultiplySelf(otherMatrix)

Parameters

otherMatrix Optional: The DOMMatrix multiplier.

Return value

Returns itself; a DOMMatrix updated to results of the applied multiplications.

Examples

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)

Specifications

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

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`preMultiplySelf`	Chrome – Full support Chrome 61 (Release date: 2017-09-05) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 33 (Release date: 2014-10-14) footnote Full support	Opera – Full support Opera 48 (Release date: 2017-09-27) footnote Full support	Safari – Full support Safari 11 (Release date: 2017-09-19) footnote Full support	Chrome Android – Full support Chrome Android 61 (Release date: 2017-09-05) footnote Full support	Firefox for Android – Full support Firefox for Android 33 (Release date: 2014-10-14) footnote Full support	Opera Android – Full support Opera Android 45 (Release date: 2018-02-15) footnote Full support	Safari on iOS – Full support Safari on iOS 11 (Release date: 2017-09-19) footnote Full support	Samsung Internet – Full support Samsung Internet 8 (Release date: 2018-07-18) footnote Full support	WebView Android – Full support WebView Android 61 (Release date: 2017-09-05) footnote Full support	WebView on iOS – Full support WebView on iOS 11 (Release date: 2017-09-19) footnote Full support

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

Full support: Full support