Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje