CKTIS / JavaScript
Canvas 2D: shranjevanje in obnavljanje stanja risanja
`save()` shrani trenutno stanje risanja na sklad, `restore()` pa s sklada odstrani in obnovi nazadnje shranjeno stanje. Nobena od metod ne razveljavi sprememb slikovnih pik.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
ctx.save();
ctx.restore();Metodi save() in restore() pokliči na istem objektu CanvasRenderingContext2D, na primer na ctx, ki ga dobiš s klicem canvas.getContext('2d'). Obe metodi pokličeš brez argumentov in obe vrneta undefined. Sta del spletnega API-ja Canvas 2D, ne ECMAScripta, zato sam pogon JavaScript še ne zagotavlja, da sta na voljo.
save() na sklad konteksta doda kopijo trenutnega stanja risanja. restore() odstrani vrhnji vnos in shranjeno stanje nastavi kot trenutno. Gnezdeno shranjena stanja se zato obnovijo v obratnem vrstnem redu: zadnje dodano se odstrani prvo (LIFO). Če je sklad prazen, restore() ničesar ne spremeni in ne sproži izjeme.
Shranjeno stanje med drugim vključuje transformacijsko matriko, območje obrezovanja, sloga polnila in obrobe ter globalAlpha. Ne vključuje trenutne privzete poti ali slikovnih pik platna: restore() ne izbriše narisanega in ne razveljavi sprememb poti. Novo privzeto pot začneš s klicem beginPath().
Uporabi save() in restore() v paru, če naj spremembe vplivajo le na del risbe. Če lahko vmesna koda sproži izjemo, najprej pokliči save(), vstavi to kodo v blok try in v bloku finally pokliči restore(). Tako se stanje obnovi tudi ob izjemi.
Primeri
<!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>Rezultat
0.25 0.5 1 0.125
Pri dveh gnezdenih shranjevanjih konzola izpiše `0.25`, nato pa obnovljeni vrednosti `0.5` in `1`. Ob zadnjem klicu `restore()` je sklad prazen, zato `0.125` ostane nespremenjena.
Povezane lekcije
- JavaScript · Lekcija 26 · Srednja · Različica: 3