Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje