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
Spécification | Statut | Commentaire |
---|---|---|
HTML Living Standard La définition de 'CanvasRenderingContext2D.save' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
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.
Voir aussi
- L'interface définissant cette méthode:
CanvasRenderingContext2D
CanvasRenderingContext2D.restore()