CKTIS / JavaScript
ImageData.data — odczyt i modyfikacja pikseli RGBA
ImageData przechowuje prostokątny obszar pikseli. Właściwość ImageData.data udostępnia jednowymiarową tablicę kanałów RGBA: można zmieniać jej elementy, choć sama właściwość jest tylko do odczytu. Poznaj indeksowanie pikseli i różnicę między formatem 8-bitowym a zmiennoprzecinkowym.
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 imageData = new ImageData(width, height);
const pixels = imageData.data;
const i = 4 * (y * imageData.width + x);
pixels[i + 0] = red;
pixels[i + 1] = green;
pixels[i + 2] = blue;
pixels[i + 3] = alpha;ImageData to interfejs Web API, a nie część samego ECMAScript. Reprezentuje prostokątny obszar pikseli; można go utworzyć przez new ImageData(width, height) albo uzyskać przez createImageData() lub getImageData() kontekstu canvas 2D. Konstruktor bez tablicy tworzy przezroczystą czerń.
ImageData.data udostępnia kanały w kolejności RGBA: czerwony, zielony, niebieski i alfa. Piksele są zapisane wierszami, od lewego górnego rogu. Tablica ma 4 * width * height elementów. Dla całkowitych współrzędnych 0 <= x < width i 0 <= y < height indeks czerwonego kanału wynosi 4 * (y * width + x); kolejne kanały mają przesunięcia 1, 2, 3.
Domyślny format "rgba-unorm8" używa Uint8ClampedArray z wartościami całkowitymi od 0 do 255; alfa 0 oznacza pełną przezroczystość, a 255 pełną nieprzezroczystość. Format "rgba-float16" używa Float16Array, więc nie należy stosować do niego skali bajtowej. Obsługę tego formatu i eksperymentalnej właściwości pixelFormat trzeba sprawdzić osobno w docelowych przeglądarkach.
Tylko do odczytu jest właściwość data, nie elementy zwracanej tablicy: modyfikuj imageData.data[i], zamiast przypisywać nową tablicę do imageData.data. Zmiana bufora nie odświeża automatycznie canvas; użyj putImageData(imageData, 0, 0). Dostępność Node 24 nie dowodzi obsługi tego przeglądarkowego API.
Przykłady
const imageData = new ImageData(2, 1);
const pixels = imageData.data;
pixels.set([255, 0, 0, 255, 0, 255, 0, 255]);
const x = 1;
const y = 0;
const i = 4 * (y * imageData.width + x);
pixels[i + 2] = 255;
console.log(`${imageData.width}x${imageData.height}; ${pixels.length}`);
console.log(Array.from(pixels).join(','));Wynik
2x1; 8 255,0,0,255,0,255,255,255
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.