CanvasRenderingContext2D.save()

La méthode CanvasRenderingContext2D.save() de l'API Canvas 2D API enregistre l'état complet du canvas en plaçant l'état courant dans une stack.

L'état du dessin qui est sauvegardé dans une stack se compose de :

• La matrice de transformation actuelle.
• La région de détourage actuelle.
• Le tableau pour les tracés en pointillés.
• Les valeurs des attributs suivant : strokeStyle, fillStyle, globalAlpha, lineWidth (en-US), lineCap, lineJoin, miterLimit (en-US), lineDashOffset (en-US), shadowOffsetX (en-US), shadowOffsetY (en-US), shadowBlur (en-US), shadowColor (en-US), globalCompositeOperation, font, textAlign, textBaseline, direction, imageSmoothingEnabled.

Cet exemple utilise la méthode save() pour enregistrer l'état par défaut et restore() pour le rétablir plus tard, on pourra ainsi dessiner un rectangle avec l'état de base après.

HTML

<canvas id="canvas"></canvas>

JavaScript

const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');

// On sauvegarde l'état par défaut
ctx.save();

ctx.fillStyle = 'green';
ctx.fillRect(10, 10, 100, 100);

// On restaure l'état par défaut
ctx.restore();

ctx.fillRect(150, 40, 100, 100);

Résultat

• L'interface définissant cette méthode : CanvasRenderingContext2D
• CanvasRenderingContext2D.restore() (en-US)