База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Canvas 2D: запазване и възстановяване на състоянието на рисуване

`save()` поставя текущото състояние на рисуване в стек, а `restore()` изважда и възстановява последното запазено състояние. Нито един от двата метода не отменя промени в пикселите.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Извиквай save() и restore() върху един и същ обект CanvasRenderingContext2D, например ctx, получен чрез canvas.getContext('2d'). И двата метода се извикват без аргументи и връщат undefined. Те са част от уеб API Canvas 2D, а не от ECMAScript, затова наличието на JavaScript среда само по себе си не гарантира достъп до тях.

save() поставя копие на текущото състояние на рисуване в стека на контекста. restore() изважда записа от върха на стека и задава запазеното състояние като текущо. Вложените запазвания се възстановяват в обратен ред: последното запазено състояние се възстановява първо (LIFO). Ако стекът е празен, restore() не променя нищо и не хвърля изключение.

Запазеното състояние включва например матрицата на трансформацията, областта на изрязване, стиловете на запълване и контур и globalAlpha. То не включва текущия път по подразбиране или пикселите на платното: restore() не изтрива нарисуваното и не отменя промени по пътя. Използвай beginPath(), за да започнеш нов път по подразбиране.

Използвай save() и restore() в двойка, когато промените трябва да засегнат само част от рисунката. Ако кодът между тях може да хвърли изключение, първо извикай save(), постави кода в try и извикай restore() във finally. Така състоянието ще се възстанови дори при изключение.

Примери

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

Резултат

0.25
0.5
1
0.125

При две вложени запазвания конзолата извежда `0.25`, а след това възстановените стойности `0.5` и `1`. При последното извикване на `restore()` стекът е празен, затова `0.125` остава непроменено.

Свързани уроци

  • JavaScript · Урок 26 · Средно · Версия: 3

Източници