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

CKTIS / JavaScript

Canvas 2D: трансформации, състояние на рисуване, изрязване и правоъгълници

Разграничавай състоянието на рисуване, текущия контур и растерното изображение, за да ограничиш изрязването до една стъпка и да изтриеш само нужните пиксели.

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

Синтаксис

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)

Тези методи принадлежат на уеб интерфейса CanvasRenderingContext2D, а не на ECMAScript 2024. Поддръжката зависи от средата за изпълнение. setTransform(a, b, c, d, e, f) заменя матрицата, вместо да я умножава: (x, y) се преобразува в (a*x + c*y + e, b*x + d*y + f). Методът приема и обект DOMMatrix2DInit: по подразбиране a и d са 1, а останалите коефициенти са 0. Затова извикване без аргументи задава единичната матрица. Различни стойности за равнозначни ключове като a и m11 предизвикват TypeError. Вариантът с шест числа не променя матрицата, ако някой аргумент е безкраен или NaN.

save() поставя копие на състоянието на рисуване в стека, включително трансформацията, областта за изрязване и стиловете. restore() изважда и възстановява последното запазено състояние; при празен стек не прави нищо. Текущият контур и пикселите не се запазват. beginPath() изпразва контура, без да променя областта за изрязване или растерното изображение. rect(x, y, width, height) добавя затворен правоъгълен подконтур, без да рисува пиксели. Трансформацията се прилага към геометрията на този контур при изграждането му.

clip() заменя областта за изрязване със сечението ѝ с вътрешността на текущия контур или на подадения Path2D. При Path2D трансформацията се прилага при извикването на clip(), без да променя обекта. Незадължителното правило за запълване 'nonzero' (по подразбиране) проверява дали сумата на пресичанията със знак е различна от нула; 'evenodd' проверява дали броят на пресичанията е нечетен. clip() не рисува и следващи извиквания не могат да разширят областта. Запази състоянието преди изрязване и го възстанови след рисуването: задаването на единичната матрица не отменя изрязването.

fillRect() запълва с fillStyle, strokeRect() очертава със strokeStyle и настройките на линията, а clearRect() изтрива до прозрачно черно (непрозрачно черно при alpha: false), като пренебрегва сенките, глобалната алфа и композирането. И трите действат директно върху растерното изображение, съобразяват се с трансформацията и изрязването и не променят контура. Затова fillRect() не предоставя геометрия на clip(). clearRect() не премахва ограничението за четене на растерно изображение, замърсено с данни от друг произход: getImageData() продължава да предизвиква SecurityError.

Примери

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
  const canvas = document.getElementById('canvas');
  const ctx = canvas.getContext('2d', { alpha: true });
  if (!ctx) throw new Error('Canvas 2D unavailable');

  ctx.fillRect(0, 0, 12, 12);
  ctx.save();
  try {
    ctx.setTransform(1, 0, 0, 1, 4, 2);
    ctx.beginPath();
    ctx.rect(0, 0, 8, 8);
    ctx.clip();
    ctx.clearRect(-2, 2, 6, 4);
  } finally {
    ctx.restore();
  }

  ctx.lineWidth = 2;
  ctx.strokeRect(14, 2, 4, 8);
  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>

Резултат

255, 0, 255, 255, 0

Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата за разработчици. Петте алфа стойности показват последователно запълване, защитено от областта за изрязване, изтрит пиксел, незасегнато запълване, очертание след възстановяване на състоянието и прозрачната му вътрешност.

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

  • JavaScript · Урок 12 · Напреднало · Версия: 4

Източници