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