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.