CKTIS / JavaScript
Canvas 2D: spremanje i vraćanje stanja crtanja
`save()` stavlja trenutačno stanje crtanja na stog, a `restore()` skida sa stoga i vraća posljednje spremljeno stanje. Nijedna metoda ne poništava promjene piksela.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
ctx.save();
ctx.restore();Pozovi save() i restore() na istom objektu CanvasRenderingContext2D, primjerice ctx dobivenom pozivom canvas.getContext('2d'). Obje se metode pozivaju bez argumenata i vraćaju undefined. Dio su web API-ja Canvas 2D, a ne ECMAScripta, pa sam JavaScriptov pogon ne jamči da su dostupne.
save() stavlja kopiju trenutačnog stanja crtanja na stog tog konteksta. restore() skida zapis s vrha stoga i postavlja spremljeno stanje kao trenutačno. Ugniježđena spremanja zato se vraćaju obrnutim redoslijedom: zadnje spremljeno stanje vraća se prvo (LIFO). Ako je stog prazan, restore() ništa ne mijenja i ne baca iznimku.
Spremljeno stanje obuhvaća, među ostalim, matricu transformacije, područje izrezivanja, stilove ispune i obrisa te globalAlpha. Ne obuhvaća trenutačnu zadanu putanju ni piksele platna: restore() ne briše nacrtano i ne poništava promjene putanje. Novu zadanu putanju započni pozivom beginPath().
Upotrijebi save() i restore() u paru kad promjene trebaju utjecati samo na dio crteža. Ako kod između tih poziva može baciti iznimku, najprije pozovi save(), stavi taj kod u blok try i pozovi restore() u bloku finally. Tako se stanje vraća i ako dođe do iznimke.
Primjeri
<!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
Nakon dvaju ugniježđenih spremanja konzola ispisuje `0.25`, a zatim vraćene vrijednosti `0.5` i `1`. Pri posljednjem pozivu `restore()` stog je prazan, pa `0.125` ostaje nepromijenjen.
Povezane lekcije
- JavaScript · Lekcija 26 · Srednje · Verzija: 3