Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

CanvasRenderingContext2D — risanje na bitno sliko

CanvasRenderingContext2D ponuja stanje ohranjajoč vmesnik za 2D-risanje pravokotnikov, poti, besedila, slik in slikovnih pik. Razlikujte med stanjem konteksta, trenutno potjo in vsebino bitne slike.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const ctx = canvas.getContext('2d');

CanvasRenderingContext2D pridobite z canvas.getContext('2d'); preverite, ali je rezultat null. To je spletni API standarda HTML, ne ECMAScript. Te osnovne operacije podpirajo sodobni brskalniški pogoni; Node 24 njihove razpoložljivosti ne dokazuje. Pred risanjem nastavite canvas.width in canvas.height: dodelitev vrednosti ponastavi bitno sliko in stanje.

fillRect zapolni pravokotnik, strokeRect nariše njegov obris, clearRect pa izbriše območje, običajno v prozorno črno; pri alpha: false v neprosojno črno. Poti ne spreminjajo. beginPath zavrže trenutno pot; moveTo začne podpot, lineTo doda odsek in closePath podpot sklene. arc doda lok s koti v radianih; rect doda pravokotnik. fill zapolni pot, stroke pa nariše njen obris.

fillStyle in strokeStyle določata barve, prelive ali vzorce; lineWidth določa debelino črte. fillText zapolni besedilo, strokeText pa nariše njegov obris; font izbere pisavo in velikost, textBaseline pa referenčno osnovno črto. measureText vrne TextMetrics, vključno z width; metrike so odvisne od pisave.

save shrani stanje, restore pa ga obnovi, ne da bi razveljavil slikovne pike ali pot. setTransform(a, b, c, d, e, f) zamenja transformacijo. clip preseka območje izreza s potjo; njegov obseg omejite z save/restore. drawImage nariše vir slike, po želji obrezan in pomanjšan ali povečan.

getImageData prebere slikovne pike kot ImageData, putImageData pa jih zapiše; obe operaciji prezreta transformacijo, zapis pa prezre tudi izrez. Slika iz drugega izvora brez ustreznega CORS lahko onesnaži bitno sliko: branje sproži SecurityError. Zagotovite dostopno alternativo vsebini bitne slike.

Referenčni identifikatorji, zajeti v tem geslu: 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.

Primeri

(() => {
  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(','));
})();

Rezultat

255,0,0,255
0,0,0,0

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri