Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje