CKTIS / JavaScript
CanvasRenderingContext2D — kreslení do bitmapy
CanvasRenderingContext2D poskytuje stavové rozhraní pro 2D kreslení obdélníků, cest, textu, obrázků a pixelů. Rozlišujte stav kontextu, aktuální cestu a obsah bitmapy.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const ctx = canvas.getContext('2d');CanvasRenderingContext2D získáte pomocí canvas.getContext('2d'); ověřte, zda výsledek není null. Jde o Web API standardu HTML, nikoli ECMAScriptu. Tyto základní operace podporují moderní prohlížečové enginy; Node 24 jejich dostupnost nedokládá. Před kreslením nastavte canvas.width a canvas.height: přiřazení hodnot bitmapu i stav resetuje.
fillRect vyplní obdélník, strokeRect vykreslí jeho obrys a clearRect vymaže oblast, obvykle na průhlednou černou; při alpha: false na neprůhlednou černou. Cestu nemění. beginPath zahodí aktuální cestu; moveTo zahájí podcestu, lineTo přidá úsečku a closePath podcestu uzavře. arc přidá oblouk s úhly v radiánech; rect přidá obdélník. fill cestu vyplní a stroke vykreslí její obrys.
fillStyle a strokeStyle určují barvy, přechody nebo vzory; lineWidth určuje tloušťku čáry. fillText vyplní text a strokeText vykreslí jeho obrys; font vybírá typ a velikost písma, zatímco textBaseline určuje referenční základní linku. measureText vrací TextMetrics včetně width; metriky závisí na písmu.
save uloží stav a restore jej obnoví, aniž by vrátil změny pixelů nebo cesty. setTransform(a, b, c, d, e, f) nahradí transformaci. clip protne oblast ořezu s cestou; její působnost omezte pomocí save/restore. drawImage vykreslí zdrojový obrázek, případně oříznutý a změněný na požadovanou velikost.
getImageData načítá pixely jako ImageData a putImageData je zapisuje; obě operace ignorují transformaci a zápis ignoruje také ořez. Obrázek z jiného původu bez odpovídajícího CORS může bitmapu kontaminovat: čtení vyvolá SecurityError. Zajistěte přístupnou alternativu k obsahu bitmapy.
Referenční identifikátory zahrnuté v tomto hesle: 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.
Příklady
(() => {
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(','));
})();Výsledek
255,0,0,255 0,0,0,0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.