CKTIS / JavaScript
ImageData.data — čtení a úprava pixelů RGBA
ImageData obsahuje obdélníkovou oblast pixelů. Její vlastnost ImageData.data zpřístupňuje jednorozměrné pole kanálů RGBA: jeho prvky lze měnit, přestože samotná vlastnost je pouze pro čtení. Seznamte se s indexováním pixelů a rozdílem mezi 8bitovým a plovoucím formátem.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 je rozhraní Web API, nikoli součást samotného ECMAScriptu. Představuje obdélníkovou oblast pixelů. Lze ji vytvořit pomocí new ImageData(width, height) nebo získat prostřednictvím createImageData() či getImageData() z kontextu canvas 2D. Konstruktor bez pole vytvoří průhledné černé pixely.
ImageData.data zpřístupňuje kanály v pořadí RGBA: červený, zelený, modrý a alfa. Pixely jsou uloženy po řádcích od levého horního rohu. Pole obsahuje 4 * width * height prvků. Pro celočíselné souřadnice 0 <= x < width a 0 <= y < height je index červeného kanálu 4 * (y * width + x); následující kanály mají posuny 1, 2, 3.
Výchozí formát "rgba-unorm8" používá Uint8ClampedArray s celočíselnými hodnotami od 0 do 255; alfa 0 znamená úplnou průhlednost a 255 úplnou neprůhlednost. Formát "rgba-float16" používá Float16Array, proto na něj nepoužívejte bajtovou stupnici. Podporu tohoto formátu a experimentální vlastnosti pixelFormat ověřte v cílových prohlížečích zvlášť.
Vlastnost data je pouze pro čtení, prvky vráceného pole však nikoli: upravujte imageData.data[i] místo přiřazení náhradního pole do imageData.data. Změna bufferu canvas automaticky neaktualizuje; použijte putImageData(imageData, 0, 0). Dostupnost Node 24 nedokazuje podporu tohoto API prohlížeče.
Příklady
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(','));Výsledek
2x1; 8 255,0,0,255,0,255,255,255
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.