KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ImageData.data — RGBA-pixels lezen en aanpassen

ImageData bevat een rechthoekig pixelgebied. De eigenschap ImageData.data geeft een eendimensionale array met RGBA-kanalen: de elementen kunnen worden aangepast, ook al is de eigenschap zelf alleen-lezen. Leer hoe pixelindexering werkt en wat het verschil is tussen 8-bits- en drijvendekomma-indelingen.

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

Syntax

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 is een interface van de Web-API en geen onderdeel van ECMAScript zelf. Deze vertegenwoordigt een rechthoekig pixelgebied. Je kunt er een maken met new ImageData(width, height) of er een ophalen via createImageData() of getImageData() van een 2D-canvascontext. De constructor zonder array maakt transparante zwarte pixels.

ImageData.data geeft de kanalen in RGBA-volgorde: rood, groen, blauw en alfa. Pixels worden rij voor rij opgeslagen, vanaf de linkerbovenhoek. De array bevat 4 * width * height elementen. Voor gehele coördinaten 0 <= x < width en 0 <= y < height is de index van het rode kanaal 4 * (y * width + x); de volgende kanalen hebben de offsets 1, 2, 3.

De standaardindeling "rgba-unorm8" gebruikt een Uint8ClampedArray met gehele waarden van 0 tot 255; alfa 0 betekent volledig transparant en 255 volledig ondoorzichtig. De indeling "rgba-float16" gebruikt een Float16Array, dus pas de byteschaal daar niet op toe. Controleer afzonderlijk of deze indeling en de experimentele eigenschap pixelFormat worden ondersteund in de doelbrowsers.

De eigenschap data is alleen-lezen, maar de elementen van de geretourneerde array niet: wijzig imageData.data[i] in plaats van een vervangende array toe te wijzen aan imageData.data. Een wijziging van de buffer werkt een canvas niet automatisch bij; gebruik putImageData(imageData, 0, 0). De beschikbaarheid van Node 24 toont niet aan dat deze browser-API wordt ondersteund.

Voorbeelden

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(','));

Resultaat

2x1; 8
255,0,0,255,0,255,255,255

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen