CKTIS / JavaScript
Canvas 2D: de tekentoestand opslaan en herstellen
`save()` zet de huidige tekentoestand op een stapel en `restore()` haalt de laatst opgeslagen toestand eraf en herstelt die. Geen van beide methoden maakt pixelwijzigingen ongedaan.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
ctx.save();
ctx.restore();Roep save() en restore() aan op dezelfde CanvasRenderingContext2D, bijvoorbeeld ctx, verkregen met canvas.getContext('2d'). Beide methoden nemen geen argumenten aan en geven undefined terug. Ze horen bij de Canvas 2D-web-API, niet bij ECMAScript. Een JavaScript-engine alleen garandeert dus niet dat ze beschikbaar zijn.
save() zet een kopie van de huidige tekentoestand op de stapel van die context. restore() haalt het bovenste item van de stapel en maakt die toestand weer actief. Genest opgeslagen toestanden worden dus in omgekeerde volgorde hersteld: als laatste erop, als eerste eraf (LIFO). Is de stapel leeg, dan verandert restore() niets en treedt er geen uitzondering op.
De opgeslagen toestand omvat onder meer de transformatiematrix, het knipgebied, de vul- en lijnstijlen en globalAlpha. Het huidige standaardpad en de pixels van het canvas horen er niet bij: restore() wist niets wat al getekend is en maakt geen wijzigingen aan het pad ongedaan. Gebruik beginPath() om een nieuw standaardpad te beginnen.
Gebruik save() en restore() samen als wijzigingen maar voor één deel van de tekening bedoeld zijn. Kan de code ertussen een uitzondering veroorzaken, roep dan eerst save() aan, zet die code in try en roep restore() aan in finally. Zo wordt de toestand ook bij een uitzondering hersteld.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas 2D: save and restore</title>
</head>
<body>
<canvas id="canvas" width="1" height="1" hidden></canvas>
<script>
(() => {
const ctx = document.getElementById("canvas").getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable.");
ctx.globalAlpha = 1;
ctx.save();
ctx.globalAlpha = 0.5;
ctx.save();
ctx.globalAlpha = 0.25;
console.log(ctx.globalAlpha);
ctx.restore();
console.log(ctx.globalAlpha);
ctx.restore();
console.log(ctx.globalAlpha);
ctx.globalAlpha = 0.125;
ctx.restore(); // The stack is empty.
console.log(ctx.globalAlpha);
})();
</script>
</body>
</html>Resultaat
0.25 0.5 1 0.125
Met twee geneste opslagbewerkingen toont de console `0.25`, gevolgd door de herstelde waarden `0.5` en `1`. Bij de laatste aanroep van `restore()` is de stapel leeg, dus `0.125` blijft ongewijzigd.
Gerelateerde lessen
- JavaScript · Les 26 · Gemiddeld · Versie: 3