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

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, lineCap, lineJoin, miterLimit, lineDashOffset, shadowOffsetX, shadowOffsetY, shadowBlur, shadowColor, globalCompositeOperation, font, textAlign, textBaseline, direction, imageSmoothingEnabled.

Syntaxe

void ctx.save();

Exemple

Enregistrer l'état du dessin

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

Spécifications

Compatibilité des navigateurs

Voir aussi

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