Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ImageData.data — čitanje i izmjena RGBA piksela

ImageData sadrži pravokutno područje piksela. Njegovo svojstvo ImageData.data izlaže jednodimenzionalni niz RGBA kanala: njegove se stavke mogu mijenjati iako je samo svojstvo samo za čitanje. Naučite indeksirati piksele i razlikovati 8-bitni format od formata s pomičnim zarezom.

Verzija: 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 sučelje Web API-ja, a ne dio samog ECMAScripta. Predstavlja pravokutno područje piksela. Može se stvoriti pomoću new ImageData(width, height) ili dohvatiti putem createImageData() odnosno getImageData() iz konteksta canvas 2D. Konstruktor bez niza stvara prozirne crne piksele.

ImageData.data izlaže kanale redoslijedom RGBA: crveni, zeleni, plavi i alfa. Pikseli se pohranjuju po redovima, počevši od gornjeg lijevog kuta. Niz sadrži 4 * width * height stavki. Za cjelobrojne koordinate 0 <= x < width i 0 <= y < height, indeks crvenog kanala iznosi 4 * (y * width + x); sljedeći kanali imaju pomake 1, 2, 3.

Zadani format "rgba-unorm8" koristi Uint8ClampedArray s cjelobrojnim vrijednostima od 0 do 255; alfa 0 znači potpuno prozirno, a 255 potpuno neprozirno. Format "rgba-float16" koristi Float16Array, zato na njega nemojte primjenjivati bajtnu ljestvicu. Podršku za taj format i eksperimentalno svojstvo pixelFormat zasebno provjerite u ciljnim preglednicima.

Svojstvo data samo je za čitanje, no stavke vraćenog niza nisu: mijenjajte imageData.data[i] umjesto da svojstvu imageData.data dodijelite zamjenski niz. Promjena međuspremnika ne ažurira automatski canvas; upotrijebite putImageData(imageData, 0, 0). Dostupnost Node 24 ne dokazuje podršku za ovaj API preglednika.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori