Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ImageData.data — leer y modificar píxeles RGBA

ImageData contiene una zona rectangular de píxeles. Su propiedad ImageData.data expone un array unidimensional de canales RGBA: sus elementos se pueden cambiar aunque la propiedad en sí sea de solo lectura. Aprende a indexar píxeles y a distinguir entre los formatos de 8 bits y de coma flotante.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

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 es una interfaz de Web API, no forma parte de ECMAScript. Representa una zona rectangular de píxeles. Se puede crear con new ImageData(width, height) u obtener mediante createImageData() o getImageData() de un contexto canvas 2D. El constructor sin un array crea píxeles negros transparentes.

ImageData.data expone los canales en orden RGBA: rojo, verde, azul y alfa. Los píxeles se almacenan fila por fila, empezando por la esquina superior izquierda. El array contiene 4 * width * height elementos. Para coordenadas enteras 0 <= x < width y 0 <= y < height, el índice del canal rojo es 4 * (y * width + x); los canales siguientes tienen los desplazamientos 1, 2, 3.

El formato predeterminado "rgba-unorm8" utiliza un Uint8ClampedArray con valores enteros de 0 a 255; alfa 0 significa totalmente transparente y 255, totalmente opaco. El formato "rgba-float16" utiliza un Float16Array, así que no apliques la escala de bytes. Comprueba por separado la compatibilidad con ese formato y con la propiedad experimental pixelFormat en los navegadores de destino.

La propiedad data es de solo lectura, pero los elementos del array que devuelve no lo son: modifica imageData.data[i] en lugar de asignar un array nuevo a imageData.data. Cambiar el búfer no actualiza automáticamente un canvas; usa putImageData(imageData, 0, 0). Tener Node 24 disponible no demuestra que esta API del navegador sea compatible.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes