Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Canvas 2D: spremanje i vraćanje stanja crtanja

`save()` stavlja trenutačno stanje crtanja na stog, a `restore()` skida sa stoga i vraća posljednje spremljeno stanje. Nijedna metoda ne poništava promjene piksela.

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

Sintaksa

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

Pozovi save() i restore() na istom objektu CanvasRenderingContext2D, primjerice ctx dobivenom pozivom canvas.getContext('2d'). Obje se metode pozivaju bez argumenata i vraćaju undefined. Dio su web API-ja Canvas 2D, a ne ECMAScripta, pa sam JavaScriptov pogon ne jamči da su dostupne.

save() stavlja kopiju trenutačnog stanja crtanja na stog tog konteksta. restore() skida zapis s vrha stoga i postavlja spremljeno stanje kao trenutačno. Ugniježđena spremanja zato se vraćaju obrnutim redoslijedom: zadnje spremljeno stanje vraća se prvo (LIFO). Ako je stog prazan, restore() ništa ne mijenja i ne baca iznimku.

Spremljeno stanje obuhvaća, među ostalim, matricu transformacije, područje izrezivanja, stilove ispune i obrisa te globalAlpha. Ne obuhvaća trenutačnu zadanu putanju ni piksele platna: restore() ne briše nacrtano i ne poništava promjene putanje. Novu zadanu putanju započni pozivom beginPath().

Upotrijebi save() i restore() u paru kad promjene trebaju utjecati samo na dio crteža. Ako kod između tih poziva može baciti iznimku, najprije pozovi save(), stavi taj kod u blok try i pozovi restore() u bloku finally. Tako se stanje vraća i ako dođe do iznimke.

Primjeri

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

Rezultat

0.25
0.5
1
0.125

Nakon dvaju ugniježđenih spremanja konzola ispisuje `0.25`, a zatim vraćene vrijednosti `0.5` i `1`. Pri posljednjem pozivu `restore()` stog je prazan, pa `0.125` ostaje nepromijenjen.

Povezane lekcije

  • JavaScript · Lekcija 26 · Srednje · Verzija: 3

Izvori