CKTIS / JavaScript
CanvasRenderingContext2D — kreslenie do bitmapy
CanvasRenderingContext2D poskytuje stavové rozhranie na 2D kreslenie obdĺžnikov, ciest, textu, obrázkov a pixelov. Rozlišujte stav kontextu, aktuálnu cestu a obsah bitmapy.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const ctx = canvas.getContext('2d');CanvasRenderingContext2D získate pomocou canvas.getContext('2d'); overte, či výsledok nie je null. Ide o Web API štandardu HTML, nie ECMAScriptu. Tieto základné operácie podporujú moderné prehliadačové enginy; Node 24 ich dostupnosť nedokazuje. Pred kreslením nastavte canvas.width a canvas.height: priradenie hodnôt resetuje bitmapu aj stav.
fillRect vyplní obdĺžnik, strokeRect vykreslí jeho obrys a clearRect vymaže oblasť, zvyčajne na priehľadnú čiernu; pri alpha: false na nepriehľadnú čiernu. Cestu nemenia. beginPath zahodí aktuálnu cestu; moveTo začne podcestu, lineTo pridá úsečku a closePath podcestu uzavrie. arc pridá oblúk s uhlami v radiánoch; rect pridá obdĺžnik. fill cestu vyplní a stroke vykreslí jej obrys.
fillStyle a strokeStyle určujú farby, prechody alebo vzory; lineWidth určuje hrúbku čiary. fillText vyplní text a strokeText vykreslí jeho obrys; font vyberá typ a veľkosť písma, kým textBaseline vyberá referenčnú základnú líniu. measureText vracia TextMetrics vrátane width; metriky závisia od písma.
save uloží stav a restore ho obnoví bez vrátenia zmien pixelov alebo cesty. setTransform(a, b, c, d, e, f) nahradí transformáciu. clip pretne oblasť orezania s cestou; jej rozsah obmedzte pomocou save/restore. drawImage vykreslí zdrojový obrázok, prípadne orezaný a zmenšený alebo zväčšený.
getImageData číta pixely ako ImageData a putImageData ich zapisuje; obe operácie ignorujú transformáciu a zápis ignoruje aj orezanie. Obrázok z iného pôvodu bez vhodného CORS môže bitmapu kontaminovať: čítanie vyvolá SecurityError. Zabezpečte prístupnú alternatívu 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.
Prí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ýsledok
255,0,0,255 0,0,0,0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.