Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Canvas 2D: czyszczenie, rysowanie i edycja pikseli

Rozróżnij operacje rysowania w kontekście 2D od odczytu i zapisu pikseli bezpośrednio w bitmapie.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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

ctx.clearRect(x, y, width, height);

ctx.drawImage(image, dx, dy);
ctx.drawImage(image, dx, dy, dw, dh);
ctx.drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh);

const snapshot = ctx.getImageData(sx, sy, sw, sh);
const configuredSnapshot = ctx.getImageData(sx, sy, sw, sh, settings);

ctx.putImageData(imageData, dx, dy);
ctx.putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight);

clearRect, drawImage, getImageData i putImageData to metody instancji kontekstu uzyskanego przez canvas.getContext('2d'), należące do API WWW, a nie do ECMAScript 2024. clearRect() uwzględnia bieżącą transformację i obszar przycinania. Ustawia piksele na przezroczystą czerń (nieprzezroczystą przy alpha: false), ale nie resetuje stanu ani bieżącej ścieżki. Przed rozpoczęciem nowej ścieżki wywołaj beginPath().

drawImage() przyjmuje gotowe źródło typu CanvasImageSource, np. obraz lub inny canvas, ale nie ImageData. Wariant z 3 argumentami rysuje całe źródło w naturalnym rozmiarze, z 5 — skaluje je do rozmiaru docelowego, a z 9 — mapuje prostokąt źródłowy na docelowy. Ujemne wymiary rozciągają prostokąt w przeciwną stronę bez odbicia obrazu. Rysowanie uwzględnia transformację, przycinanie i kompozycję. Jeśli obraz wciąż się ładuje i nie nadaje się jeszcze do użycia, drawImage() go nie narysuje. Obraz, który jest w pełni dostępny i można go zdekodować, da się narysować bez wcześniejszego wywołania decode() ani wcześniejszego dekodowania klatki. Płótno źródłowe o zerowym wymiarze powoduje InvalidStateError.

getImageData() odczytuje piksele bitmapy bez uwzględniania transformacji i przycinania. Zwraca niezależną kopię ImageData: zmiana data nie zmienia płótna. Tablica przechowuje wartości RGBA wierszami; pierwszy kanał piksela (x, y) w kopii ma indeks (y * imageData.width + x) * 4. Poza bitmapą zwracana jest przezroczysta czerń. Ujemne sw lub sh rozszerzają prostokąt w przeciwną stronę; zero powoduje IndexSizeError.

putImageData() zastępuje piksele bez skalowania, transformacji, przycinania kontekstu ani mieszania. Wariant z 7 argumentami wybiera podobszar wewnątrz ImageData, a nie na płótnie docelowym: piksel (x, y) trafia do (dx + x, dy + y). Odłączony bufor powoduje InvalidStateError. Konwersje przestrzeni barw i premultiplikacja alfa mogą zmienić wartości przy ponownym odczycie, zwłaszcza dla pikseli półprzezroczystych.

Rysowanie zasobu z innego źródła bez odpowiedniej zgody CORS może sprawić, że bitmapa utraci status origin-clean. Odczyt zgłosi wtedy SecurityError, nawet po clearRect(). Przy zasobach z innego źródła użyj żądania CORS i odpowiedniej zgody serwera. Domyślny format odczytu rgba-unorm8 używa Uint8ClampedArray; przed użyciem opcji takich jak display-p3 lub rgba-float16 (Float16Array) sprawdź obsługę w docelowych przeglądarkach.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel readback</title>
<canvas id="source" width="2" height="1" hidden></canvas>
<canvas id="destination" width="2" height="1" hidden></canvas>
<script>
  const source = document.getElementById('source');
  const canvas = document.getElementById('destination');
  const src = source.getContext('2d');
  const ctx = canvas.getContext('2d');
  src.fillStyle = '#ff0000';
  src.fillRect(0, 0, 2, 1);
  ctx.drawImage(source, 0, 0);
  ctx.clearRect(0, 0, 1, 1);

  const snapshot = ctx.getImageData(0, 0, 2, 1);
  console.log(snapshot.data.join(','));
  snapshot.data.set([0, 0, 255, 255], 4);
  ctx.putImageData(snapshot, -1, 0, 1, 0, 1, 1);
  console.log(ctx.getImageData(0, 0, 2, 1).data.join(','));
</script>

Wynik

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

Pierwszy wiersz pokazuje wyczyszczony lewy piksel i czerwony prawy. Kod zmienia prawy piksel kopii na niebieski, po czym zapisuje tylko ten piksel z przesunięciem `dx = -1`. W drugim wierszu lewy piksel jest niebieski, a prawy nadal czerwony.

Powiązane lekcje

  • JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4

Źródła