Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

CanvasRenderingContext2D — rysowanie na bitmapie

CanvasRenderingContext2D udostępnia stanowy interfejs rysowania 2D: prostokąty, ścieżki, tekst, obrazy i piksele. Rozróżniaj stan kontekstu, bieżącą ścieżkę oraz zawartość bitmapy.

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

Składnia

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

CanvasRenderingContext2D otrzymujesz przez canvas.getContext('2d'); sprawdź wynik null. To Web API standardu HTML, nie ECMAScript. Opisane podstawowe operacje są obsługiwane przez współczesne silniki przeglądarek; Node 24 nie dowodzi ich dostępności. Ustaw canvas.width i canvas.height przed rysowaniem: ich przypisanie resetuje bitmapę i stan.

fillRect wypełnia prostokąt, strokeRect rysuje obrys, a clearRect czyści obszar, domyślnie do przezroczystej czerni; przy alpha: false do nieprzezroczystej czerni. Nie zmieniają ścieżki. beginPath usuwa bieżącą ścieżkę; moveTo rozpoczyna podścieżkę, lineTo dodaje odcinek, closePath zamyka podścieżkę. arc dodaje łuk z kątami w radianach, rect — prostokąt. fill wypełnia, a stroke obrysowuje ścieżkę.

fillStyle i strokeStyle określają kolory, gradienty lub wzory; lineWidth określa grubość linii. fillText wypełnia tekst, strokeText rysuje jego kontury; font wybiera krój i rozmiar, a textBaseline — linię odniesienia. measureText zwraca TextMetrics, w tym width; metryki zależą od fontu.

save zapisuje stan, a restore go przywraca, bez cofania pikseli ani ścieżki. setTransform(a, b, c, d, e, f) zastępuje transformację. clip przecina obszar przycinania ze ścieżką; używaj save/restore, by ograniczyć jego zasięg. drawImage rysuje źródło obrazu, opcjonalnie kadrując i skalując.

getImageData odczytuje piksele jako ImageData, a putImageData zapisuje je; obie operacje ignorują transformację, a zapis także przycinanie. Obraz z innego pochodzenia bez odpowiedniego CORS może zanieczyścić bitmapę: odczyt zgłosi SecurityError. Zapewnij dostępny odpowiednik treści bitmapy.

Identyfikatory objęte tym wpisem: 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.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła