CKTIS / JavaScript
ImageData.data — ler e modificar píxeis RGBA
ImageData contém uma área retangular de píxeis. A propriedade ImageData.data expõe um array unidimensional de canais RGBA: os elementos podem ser alterados, embora a propriedade em si seja só de leitura. Aprenda a indexar píxeis e a distinguir os formatos de 8 bits dos formatos de vírgula flutuante.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
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 é uma interface da Web API, não faz parte do próprio ECMAScript. Representa uma área retangular de píxeis. Pode ser criada com new ImageData(width, height) ou obtida através de createImageData() ou getImageData() de um contexto canvas 2D. O construtor sem array cria píxeis pretos transparentes.
ImageData.data expõe os canais pela ordem RGBA: vermelho, verde, azul e alfa. Os píxeis são armazenados linha a linha, a partir do canto superior esquerdo. O array contém 4 * width * height elementos. Para coordenadas inteiras 0 <= x < width e 0 <= y < height, o índice do canal vermelho é 4 * (y * width + x); os canais seguintes têm os deslocamentos 1, 2, 3.
O formato predefinido "rgba-unorm8" utiliza um Uint8ClampedArray com valores inteiros de 0 a 255; alfa 0 significa totalmente transparente e 255 totalmente opaco. O formato "rgba-float16" utiliza um Float16Array, por isso não aplique a escala dos bytes. Verifique separadamente o suporte deste formato e da propriedade experimental pixelFormat nos browsers de destino.
A propriedade data é só de leitura, mas os elementos do array devolvido não o são: altere imageData.data[i] em vez de atribuir um novo array a imageData.data. Alterar o buffer não atualiza automaticamente um canvas; utilize putImageData(imageData, 0, 0). A disponibilidade do Node 24 não comprova o suporte desta API de browser.
Exemplos
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(','));Resultado
2x1; 8 255,0,0,255,0,255,255,255
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.