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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.