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

CKTIS / JavaScript

CanvasRenderingContext2D — рисуване върху растерно изображение

CanvasRenderingContext2D предоставя състояниев интерфейс за 2D рисуване на правоъгълници, контури, текст, изображения и пиксели. Разграничавайте състоянието на контекста, текущия контур и съдържанието на растерното изображение.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const ctx = canvas.getContext('2d');

Получавате CanvasRenderingContext2D чрез canvas.getContext('2d'); проверете дали резултатът е null. Това е Web API от стандарта HTML, а не ECMAScript. Тези основни операции се поддържат от съвременните браузърни енджини; Node 24 не доказва наличността им. Задайте canvas.width и canvas.height преди рисуване: присвояването им нулира растерното изображение и състоянието.

fillRect запълва правоъгълник, strokeRect очертава контура му, а clearRect изчиства област, обикновено до прозрачно черно; при alpha: false — до плътно черно. Те не променят контура. beginPath отхвърля текущия контур; moveTo започва подконтур, lineTo добавя отсечка, а closePath затваря подконтура. arc добавя дъга с ъгли в радиани; rect добавя правоъгълник. fill запълва контура, а stroke очертава контура му.

fillStyle и strokeStyle задават цветове, градиенти или шаблони; lineWidth задава дебелината на линията. fillText запълва текста, а strokeText очертава контура му; font избира шрифт и размер, докато textBaseline задава отправната базова линия. measureText връща TextMetrics, включително width; метриките зависят от шрифта.

save запазва състоянието, а restore го възстановява, без да отменя пикселите или контура. setTransform(a, b, c, d, e, f) заменя трансформацията. clip пресича областта на изрязване с контура; използвайте save/restore, за да ограничите обхвата ѝ. drawImage рисува източник на изображение, като по избор го изрязва и мащабира.

getImageData чете пиксели като ImageData, а putImageData ги записва; и двете операции пренебрегват трансформацията, а записът пренебрегва и изрязването. Изображение от друг произход без подходящ CORS може да замърси растерното изображение: четенето задейства SecurityError. Осигурете достъпна алтернатива на съдържанието на растерното изображение.

Референтни идентификатори, обхванати в тази статия: CanvasRenderingContext2D.clearRect, CanvasRenderingContext2D.fillRect, CanvasRenderingContext2D.strokeRect, CanvasRenderingContext2D.beginPath, CanvasRenderingContext2D.moveTo, CanvasRenderingContext2D.lineTo, CanvasRenderingContext2D.closePath, CanvasRenderingContext2D.stroke, CanvasRenderingContext2D.arc, CanvasRenderingContext2D.fill, CanvasRenderingContext2D.fillText, CanvasRenderingContext2D.strokeText, CanvasRenderingContext2D.lineWidth, CanvasRenderingContext2D.strokeStyle, CanvasRenderingContext2D.fillStyle, CanvasRenderingContext2D.font, CanvasRenderingContext2D.textBaseline, CanvasRenderingContext2D.save, CanvasRenderingContext2D.restore, CanvasRenderingContext2D.measureText, CanvasRenderingContext2D.setTransform, CanvasRenderingContext2D.rect, CanvasRenderingContext2D.clip, CanvasRenderingContext2D.drawImage, CanvasRenderingContext2D.getImageData, CanvasRenderingContext2D.putImageData.

Примери

(() => {
  const canvas = document.createElement('canvas');
  canvas.width = 64;
  canvas.height = 48;
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D unavailable');
  document.body.append(canvas);

  ctx.clearRect(0, 0, 64, 48);
  ctx.save();
  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.beginPath();
  ctx.rect(0, 0, 32, 48);
  ctx.clip();
  ctx.fillStyle = '#ff0000';
  ctx.fillRect(0, 0, 64, 48);
  ctx.restore();
  ctx.beginPath();

  const pixel = ctx.getImageData(8, 8, 1, 1);
  ctx.putImageData(pixel, 48, 8);
  console.log(Array.from(ctx.getImageData(48, 8, 1, 1).data).join(','));
  console.log(Array.from(ctx.getImageData(40, 8, 1, 1).data).join(','));
})();

Резултат

255,0,0,255
0,0,0,0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници