CKTIS / JavaScript
ImageData.data — leggere e modificare i pixel RGBA
ImageData contiene un’area rettangolare di pixel. La proprietà ImageData.data espone un array unidimensionale di canali RGBA: i suoi elementi si possono modificare, anche se la proprietà in sé è di sola lettura. Scopri l’indicizzazione dei pixel e la differenza tra i formati a 8 bit e in virgola mobile.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
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 è un’interfaccia della Web API, non fa parte di ECMAScript. Rappresenta un’area rettangolare di pixel. Si può creare con new ImageData(width, height) oppure ottenere tramite createImageData() o getImageData() di un contesto canvas 2D. Il costruttore senza array crea pixel neri trasparenti.
ImageData.data espone i canali nell’ordine RGBA: rosso, verde, blu e alfa. I pixel sono memorizzati riga per riga, a partire dall’angolo in alto a sinistra. L’array contiene 4 * width * height elementi. Per coordinate intere 0 <= x < width e 0 <= y < height, l’indice del canale rosso è 4 * (y * width + x); i canali successivi hanno gli offset 1, 2, 3.
Il formato predefinito "rgba-unorm8" usa un Uint8ClampedArray con valori interi da 0 a 255; alfa 0 significa completamente trasparente e 255 completamente opaco. Il formato "rgba-float16" usa un Float16Array, quindi non applicare la scala dei byte. Verifica separatamente il supporto di questo formato e della proprietà sperimentale pixelFormat nei browser di destinazione.
La proprietà data è di sola lettura, ma gli elementi dell’array restituito non lo sono: modifica imageData.data[i] invece di assegnare un nuovo array a imageData.data. Modificare il buffer non aggiorna automaticamente un canvas; usa putImageData(imageData, 0, 0). La disponibilità di Node 24 non dimostra il supporto di questa API del browser.
Esempi
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(','));Risultato
2x1; 8 255,0,0,255,0,255,255,255
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.