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