CKTIS / JavaScript
Canvas 2D: uložení a obnovení stavu kreslení
`save()` uloží aktuální stav kreslení na zásobník a `restore()` z něj odebere a obnoví naposledy uložený stav. Ani jedna metoda nevrací zpět změny pixelů.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
ctx.save();
ctx.restore();Metody save() a restore() volej na stejném objektu CanvasRenderingContext2D, například na ctx získaném pomocí canvas.getContext('2d'). Obě metody se volají bez argumentů a vracejí undefined. Patří do webového API Canvas 2D, nikoli do ECMAScriptu; samotný engine JavaScriptu proto jejich dostupnost nezaručuje.
save() vloží kopii aktuálního stavu kreslení na zásobník daného kontextu. restore() odebere položku z vrcholu zásobníku a nastaví uložený stav jako aktuální. Vnořené stavy se tak obnovují v opačném pořadí: naposledy uložený se obnoví jako první (LIFO). Je-li zásobník prázdný, restore() nic nezmění a nevyvolá výjimku.
Uložený stav zahrnuje mimo jiné transformační matici, oblast ořezu, styly výplně a obrysu a globalAlpha. Nezahrnuje aktuální výchozí cestu ani pixely plátna: restore() nesmaže nakreslený obsah ani nevrátí změny cesty. Novou výchozí cestu začneš voláním beginPath().
Používej dvojici save() a restore(), když se změny mají týkat jen části kresby. Pokud může kód mezi voláními vyvolat výjimku, zavolej nejprve save(), vlož kód do bloku try a zavolej restore() v bloku finally. Stav se tak obnoví i při výjimce.
Pří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ýsledek
0.25 0.5 1 0.125
Při dvou vnořených uloženích konzole vypíše `0.25` a poté obnovené hodnoty `0.5` a `1`. Při posledním volání `restore()` je zásobník prázdný, takže `0.125` zůstane beze změny.
Související lekce
- JavaScript · Lekce 26 · Středně pokročilá · Verze: 3