CanvasRenderingContext2D: save() method
Canvas API
Canvas API
The
CanvasRenderingContext2D.save()
method of the Canvas 2D API saves the entire state of the canvas by pushing the current
state onto a stack.
Syntax
save()
Parameters
None.
Return value
None (undefined).
Description
The drawing state that gets saved onto a stack consists of:
- The current transformation matrix.
- The current clipping region.
- The current dash list.
- The current values of the following attributes:
- direction
- fillStyle
- filter
- font
- fontKerning
- fontStretch
- fontVariantCaps
- globalAlpha
- globalCompositeOperation
- imageSmoothingEnabled
- imageSmoothingQuality
- letterSpacing
- lineCap
- lineDashOffset
- lineJoin
- lineWidth
- miterLimit
- shadowBlur
- shadowColor
- shadowOffsetX
- shadowOffsetY
- strokeStyle
- textAlign
- textBaseline
- textRendering
- wordSpacing
Examples
Saving the drawing state
This example uses the save() method to save the current state and
restore() to restore it later, so that you are able to draw a rect with the
current state later.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
// Save the current state
ctx.save();
ctx.fillStyle = "green";
ctx.fillRect(10, 10, 100, 100);
// Restore to the state saved by the most recent call to save()
ctx.restore();
ctx.fillRect(150, 40, 100, 100);
Result
700
Specifications
Browser compatibility
See also
- The interface defining this method: CanvasRenderingContext2D
- CanvasRenderingContext2D.restore()