Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Canvas 2D: zapisywanie i przywracanie stanu rysowania

`save()` zapisuje bieżący stan rysowania na stosie, a `restore()` zdejmuje i przywraca ostatni zapisany stan. Żadna z tych metod nie cofa zmian pikseli.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

ctx.save();
ctx.restore();

Wywołuj save() i restore() na tej samej instancji CanvasRenderingContext2D, na przykład ctx uzyskanej przez canvas.getContext('2d'). Obie metody nie przyjmują argumentów i zwracają undefined. Należą do webowego API Canvas 2D, a nie do ECMAScript; sam silnik JavaScript nie gwarantuje ich dostępności.

save() odkłada kopię bieżącego stanu rysowania na stos danego kontekstu. restore() zdejmuje stan ze szczytu stosu i ustawia go jako bieżący. Zagnieżdżone zapisy przywraca się więc w odwrotnej kolejności: ostatni zapisany stan wraca jako pierwszy (LIFO). Gdy stos jest pusty, restore() nic nie zmienia i nie zgłasza wyjątku.

Stan obejmuje między innymi macierz transformacji, obszar przycinania, style wypełnienia i obrysu oraz globalAlpha. Nie obejmuje bieżącej domyślnej ścieżki ani pikseli płótna: restore() nie usuwa narysowanych kształtów ani nie cofa zmian ścieżki. Aby rozpocząć nową domyślną ścieżkę, wywołaj beginPath().

Używaj pary save() i restore(), gdy zmiany mają dotyczyć tylko części rysunku. Jeśli kod pomiędzy nimi może zgłosić wyjątek, po save() umieść go w bloku try, a restore() wywołaj w finally, by przywrócić stan również w takim przypadku.

Przykłady

<!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>

Wynik

0.25
0.5
1
0.125

Dwa zagnieżdżone zapisy sprawiają, że po `0.25` konsola wypisuje przywrócone wartości `0.5` i `1`. Ostatnie `restore()` zastaje pusty stos, więc pozostawia `0.125`.

Powiązane lekcje

  • JavaScript · Lekcja 26 · Średniozaawansowany · Wersja: 3

Źródła