WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ImageData.data — RGBA-Pixel lesen und ändern

ImageData enthält einen rechteckigen Pixelbereich. Die Eigenschaft ImageData.data stellt ein eindimensionales Array mit RGBA-Kanälen bereit: Seine Elemente lassen sich ändern, obwohl die Eigenschaft selbst schreibgeschützt ist. Lerne die Pixelindizierung und den Unterschied zwischen 8-Bit- und Gleitkommaformaten kennen.

Version: 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 ist eine Web-API-Schnittstelle und kein Bestandteil von ECMAScript selbst. Sie stellt einen rechteckigen Pixelbereich dar. Erstellen lässt sie sich mit new ImageData(width, height) oder über createImageData() beziehungsweise getImageData() eines 2D-Canvas-Kontexts. Der Konstruktor ohne Array erzeugt vollständig transparente schwarze Pixel.

ImageData.data stellt die Kanäle in RGBA-Reihenfolge bereit: Rot, Grün, Blau und Alpha. Die Pixel sind zeilenweise ab der linken oberen Ecke gespeichert. Das Array enthält 4 * width * height Elemente. Für ganzzahlige Koordinaten 0 <= x < width und 0 <= y < height ist der Index des roten Kanals 4 * (y * width + x); die folgenden Kanäle liegen bei den Offsets 1, 2, 3.

Das Standardformat "rgba-unorm8" verwendet ein Uint8ClampedArray mit ganzzahligen Werten von 0 bis 255; Alpha 0 bedeutet vollständig transparent und 255 vollständig undurchsichtig. Das Format "rgba-float16" verwendet ein Float16Array; wenden Sie darauf daher nicht die Byte-Skala an. Prüfen Sie die Unterstützung dieses Formats und der experimentellen Eigenschaft pixelFormat separat in den Zielbrowsern.

Die Eigenschaft data ist schreibgeschützt, die Elemente des zurückgegebenen Arrays sind es jedoch nicht: Ändern Sie imageData.data[i], statt der Eigenschaft imageData.data ein Ersatzarray zuzuweisen. Eine Änderung des Puffers aktualisiert ein Canvas nicht automatisch; verwenden Sie putImageData(imageData, 0, 0). Dass Node 24 verfügbar ist, belegt nicht die Unterstützung dieser Browser-API.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen