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

CKTIS / JavaScript

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

Разграничавайте трансформацията, пикселите и пътя по подразбиране. Научете кога се преобразуват координатите, кои извиквания веднага променят пикселите и какво остава след `stroke()`.

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

Синтаксис

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)

CanvasRenderingContext2D е интерфейс на уеб API, а не част от ECMAScript 2024. Извиквайте методите върху контекста ctx, получен от canvas.getContext('2d'); резултатът може да е null. Поддръжката на отделните форми на извикване зависи от средата за изпълнение. При нормално извикване и седемте метода връщат undefined.

setTransform(a, b, c, d, e, f) заменя текущата матрица, за разлика от transform(), който я умножава. Точката (x, y) се преобразува в (a*x + c*y + e, b*x + d*y + f). Формата с обект приема речник за двумерна матрица (DOMMatrix2DInit): пропуснатите компоненти приемат стойностите на единичната матрица, а противоречиви стойности за синонимни имена като a и m11 предизвикват TypeError. Според стандарта извикване без аргументи задава единичната матрица. При формата с шест числа текущата матрица остава непроменена, ако някой от аргументите е NaN или безкрайност. Формата с речник създава DOMMatrix от валиден речник и я задава като текуща матрица без тази проверка.

fillRect(x, y, width, height) веднага запълва правоъгълник с fillStyle. Със същите параметри clearRect() изчиства пикселите до прозрачно черно (непрозрачно черно при alpha: false), независимо от стила, globalAlpha и режима на композиране. И двата метода използват текущата трансформация и областта на изрязване, без да променят пътя. Нулев размер няма ефект, а отрицателен размер разширява правоъгълника в обратната посока от (x, y).

beginPath() изпразва пътя по подразбиране, без да изтрива пиксели. moveTo(x, y) започва нов подпът, без да го свързва с предишния. lineTo(x, y) добавя права отсечка от последната точка; ако няма подпът, само задава начална точка. Никой от трите метода не рисува. moveTo(), lineTo() и двата метода за правоъгълници пренебрегват извиквания с безкрайни стойности или NaN в координатите или размерите.

stroke() очертава текущия път по подразбиране с strokeStyle и настройки на линията като lineWidth. Не затваря отворени подпътища и не изпразва пътя. Координатите на пътя по подразбиране се преобразуват при добавяне, а не повторно при очертаване, но текущата матрица все пак влияе на щриха, например на дебелината му. При stroke(path) геометрията на подадения Path2D се преобразува при рисуването, без да се променя обектът. save() и restore() запазват и възстановяват състоянието на рисуване, включително матрицата, но не и пътя по подразбиране или пикселите.

Примери

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
  const canvas = document.getElementById('demo');
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable');

  ctx.setTransform(1, 0, 0, 1, 8, 4);
  ctx.fillStyle = '#000';
  ctx.fillRect(0, 0, 16, 8);
  ctx.beginPath();
  ctx.moveTo(2, 12);
  ctx.lineTo(14, 12);
  ctx.clearRect(0, 0, 4, 8);

  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.strokeStyle = '#000';
  ctx.lineWidth = 4;
  ctx.stroke();

  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>

Резултат

0, 255, 255, 0

Запазете примера като HTML файл, отворете го в браузър и проверете изхода в конзолата. Очакваните алфа стойности `0, 255, 255, 0` съответстват на изчистената област, останалото запълване, преместената отсечка и незасегната точка в непреместената координатна система. `getImageData()` чете в координатите на растерното изображение. Настройките за поверителност могат да променят резултата; четенето от платно с неразрешено съдържание от друг източник може да предизвика `SecurityError`.

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

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

Източници