This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CanvasRenderingContext2D
.currentTransform
property of the Canvas 2D API returns or sets a DOMMatrix
(current specification) or SVGMatrix
(old specification) object for the current transformation matrix.
Syntax
ctx.currentTransform [= value];
Examples
Manually changing the matrix
This example uses the currentTransform
property to set a transformation matrix. A rectangle is then drawn using that transformation.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById('canvas'); const ctx = canvas.getContext('2d'); let matrix = ctx.currentTransform; matrix.a = 1; matrix.b = 1; matrix.c = 0; matrix.d = 1; matrix.e = 0; matrix.f = 0; ctx.currentTransform = matrix; ctx.fillRect(0, 0, 100, 100);
Result
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
currentTransform | Chrome
Full support
Yes
| Edge Full support ≤18 | Firefox
No support
No
| IE No support No | Opera No support No | Safari
No support
No
| WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
Returns a DOMMatrix | Chrome
No support
No
| Edge
No support
No
| Firefox No support No | IE No support No | Opera No support No | Safari
No support
No
| WebView Android
No support
No
| Chrome Android
No support
No
| Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android
No support
No
|
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.
See also
- The interface defining this property:
CanvasPattern
SVGMatrix
DOMMatrix