CKTIS / JavaScript
ImageData.data — lire et modifier des pixels RGBA
ImageData contient une zone rectangulaire de pixels. Sa propriété ImageData.data expose un tableau unidimensionnel de canaux RGBA : ses éléments peuvent être modifiés même si la propriété elle-même est en lecture seule. Découvrez l’indexation des pixels et la différence entre les formats 8 bits et à virgule flottante.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 est une interface de l’API Web, et non une partie d’ECMAScript lui-même. Elle représente une zone rectangulaire de pixels. On peut la créer avec new ImageData(width, height) ou l’obtenir via createImageData() ou getImageData() d’un contexte canvas 2D. Le constructeur sans tableau crée des pixels noirs transparents.
ImageData.data expose les canaux dans l’ordre RGBA : rouge, vert, bleu et alpha. Les pixels sont stockés ligne par ligne, à partir du coin supérieur gauche. Le tableau contient 4 * width * height éléments. Pour des coordonnées entières 0 <= x < width et 0 <= y < height, l’indice du canal rouge est 4 * (y * width + x) ; les canaux suivants ont les décalages 1, 2, 3.
Le format par défaut "rgba-unorm8" utilise un Uint8ClampedArray avec des valeurs entières de 0 à 255 ; alpha 0 signifie entièrement transparent et 255 entièrement opaque. Le format "rgba-float16" utilise un Float16Array : n’y appliquez donc pas l’échelle des octets. Vérifiez séparément la prise en charge de ce format et de la propriété expérimentale pixelFormat dans les navigateurs cibles.
La propriété data est en lecture seule, mais pas les éléments du tableau renvoyé : modifiez imageData.data[i] au lieu d’affecter un nouveau tableau à imageData.data. La modification du tampon ne met pas automatiquement à jour un canvas ; utilisez putImageData(imageData, 0, 0). La disponibilité de Node 24 ne prouve pas la prise en charge de cette API de navigateur.
Exemples
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(','));Résultat
2x1; 8 255,0,0,255,0,255,255,255
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.