CKTIS / JavaScript
Canvas 2D: uloženie a obnovenie stavu kreslenia
`save()` uloží aktuálny stav kreslenia na zásobník a `restore()` z neho odoberie a obnoví naposledy uložený stav. Ani jedna metóda nevracia zmeny pixelov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
ctx.save();
ctx.restore();Metódy save() a restore() volaj na tom istom objekte CanvasRenderingContext2D, napríklad na ctx získanom pomocou canvas.getContext('2d'). Obe sa volajú bez argumentov a vracajú undefined. Patria do webového API Canvas 2D, nie do ECMAScriptu. Samotný JavaScriptový engine teda nezaručuje ich dostupnosť.
save() vloží kópiu aktuálneho stavu kreslenia na zásobník daného kontextu. restore() odoberie položku z vrchu zásobníka a nastaví uložený stav ako aktuálny. Vnorené uloženia sa teda obnovujú v opačnom poradí: posledný uložený stav sa obnoví ako prvý (LIFO). Ak je zásobník prázdny, restore() nič nezmení ani nevyvolá výnimku.
Uložený stav zahŕňa okrem iného transformačnú maticu, oblasť orezania, štýly výplne a obrysu a globalAlpha. Nezahŕňa aktuálnu predvolenú cestu ani pixely plátna: restore() nevymaže nakreslený obsah ani nevráti zmeny cesty. Novú predvolenú cestu začneš volaním beginPath().
Použi dvojicu save() a restore(), ak majú zmeny ovplyvniť len časť kresby. Ak môže kód medzi volaniami vyvolať výnimku, zavolaj najprv save(), vlož kód do bloku try a zavolaj restore() v bloku finally. Stav sa tak obnoví aj pri výnimke.
Príklady
<!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>Výsledok
0.25 0.5 1 0.125
Pri dvoch vnorených uloženiach konzola vypíše `0.25` a potom obnovené hodnoty `0.5` a `1`. Pri poslednom volaní `restore()` je zásobník prázdny, takže `0.125` zostane bez zmeny.
Súvisiace lekcie
- JavaScript · Lekcia 26 · Stredne pokročilá · Verzia: 3