CKTIS / JavaScript
ImageData.data — branje in spreminjanje slikovnih pik RGBA
ImageData vsebuje pravokotno območje slikovnih pik. Njegova lastnost ImageData.data izpostavi enodimenzionalno polje kanalov RGBA: njegove elemente je mogoče spreminjati, čeprav je lastnost sama samo za branje. Spoznajte indeksiranje slikovnih pik in razliko med 8-bitnimi ter plavajočimi formati.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 vmesnik spletnega API-ja, ne del samega ECMAScripta. Predstavlja pravokotno območje slikovnih pik. Ustvarite ga lahko z new ImageData(width, height) ali pridobite prek createImageData() oziroma getImageData() iz konteksta canvas 2D. Konstruktor brez polja ustvari prosojne črne slikovne pike.
ImageData.data izpostavi kanale v vrstnem redu RGBA: rdeči, zeleni, modri in alfa. Slikovne pike so shranjene po vrsticah, začenši v zgornjem levem kotu. Polje vsebuje 4 * width * height elementov. Za celoštevilski koordinati 0 <= x < width in 0 <= y < height je indeks rdečega kanala 4 * (y * width + x); naslednji kanali imajo odmike 1, 2, 3.
Privzeti format "rgba-unorm8" uporablja Uint8ClampedArray s celoštevilskimi vrednostmi od 0 do 255; alfa 0 pomeni popolno prosojnost, 255 pa popolno neprosojnost. Format "rgba-float16" uporablja Float16Array, zato zanj ne uporabljajte bajtne lestvice. Podporo temu formatu in eksperimentalni lastnosti pixelFormat preverite ločeno v ciljnih brskalnikih.
Lastnost data je samo za branje, elementi vrnjenega polja pa ne: spreminjajte imageData.data[i] namesto dodelitve nadomestnega polja lastnosti imageData.data. Sprememba medpomnilnika ne posodobi canvasa samodejno; uporabite putImageData(imageData, 0, 0). Razpoložljivost Node 24 ne dokazuje podpore tega brskalniškega API-ja.
Primeri
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(','));Rezultat
2x1; 8 255,0,0,255,0,255,255,255
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.