ImageData

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Das ImageData-Interface stellt die zugrunde liegenden Pixeldaten eines Bereichs eines <canvas>-Elements dar.

Es wird mit dem ImageData()-Konstruktor oder Erzeugermethoden auf dem mit einer Leinwand (canvas) verbundenen CanvasRenderingContext2D-Objekt erstellt: createImageData() und getImageData(). Es kann auch verwendet werden, um einen Teil der Leinwand festzulegen, indem putImageData() verwendet wird.

Konstruktoren

ImageData()

Erstellt ein ImageData-Objekt aus einem gegebenen Uint8ClampedArray und der Größe des Bildes, das es enthält. Wenn kein Array angegeben ist, erstellt es ein Bild eines transparenten schwarzen Rechtecks. Beachten Sie, dass dies die gebräuchlichste Methode ist, um ein solches Objekt in Arbeitern (workers) zu erstellen, da createImageData() dort nicht verfügbar ist.

Instanzeigenschaften

ImageData.data Nur lesbar

Ein Uint8ClampedArray, das ein eindimensionales Array darstellt, das die Daten in der RGBA-Reihenfolge enthält, mit ganzzahligen Werten zwischen 0 und 255 (einschließlich). Die Reihenfolge erfolgt zeilenweise von oben links nach unten rechts.

ImageData.colorSpace Nur lesbar

Ein String, der den Farbraum der Bilddaten angibt.

ImageData.height Nur lesbar

Ein unsigned long, der die tatsächliche Höhe des ImageData in Pixeln darstellt.

ImageData.width Nur lesbar

Ein unsigned long, der die tatsächliche Breite des ImageData in Pixeln darstellt.

Spezifikationen

Specification
HTML Standard
# imagedata

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch