CKTIS / JavaScript
ImageData.data — четене и промяна на RGBA пиксели
ImageData съдържа правоъгълна област от пиксели. Свойството ImageData.data предоставя едномерен масив от RGBA канали: елементите му могат да се променят, въпреки че самото свойство е само за четене. Научете как се индексират пикселите и каква е разликата между 8-битов и формат с плаваща запетая.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
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 е интерфейс от Web API, а не част от самия ECMAScript. Той представя правоъгълна област от пиксели. Може да се създаде с new ImageData(width, height) или да се получи чрез createImageData() или getImageData() от контекст canvas 2D. Конструкторът без масив създава прозрачни черни пиксели.
ImageData.data предоставя каналите в ред RGBA: червен, зелен, син и алфа. Пикселите се съхраняват по редове, започвайки от горния ляв ъгъл. Масивът съдържа 4 * width * height елемента. За целочислени координати 0 <= x < width и 0 <= y < height индексът на червения канал е 4 * (y * width + x); следващите канали имат отмествания 1, 2, 3.
Форматът по подразбиране "rgba-unorm8" използва Uint8ClampedArray с цели стойности от 0 до 255; алфа 0 означава пълна прозрачност, а 255 — пълна непрозрачност. Форматът "rgba-float16" използва Float16Array, затова не прилагайте към него байтовата скала. Проверете отделно поддръжката на този формат и експерименталното свойство pixelFormat в целевите браузъри.
Свойството data е само за четене, но елементите на върнатия масив не са: променяйте imageData.data[i], вместо да присвоявате нов масив на imageData.data. Промяната на буфера не обновява автоматично canvas; използвайте putImageData(imageData, 0, 0). Наличието на Node 24 не доказва поддръжка на този браузърен API.
Примери
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(','));Резултат
2x1; 8 255,0,0,255,0,255,255,255
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.