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.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das ImageData-Interface repräsentiert die zugrunde liegenden Pixeldaten eines Bereichs eines <canvas>-Elements.

Es wird erzeugt durch den ImageData()-Konstruktor oder Erzeugermethoden auf dem CanvasRenderingContext2D-Objekt, das mit einem Canvas verbunden ist: createImageData() und getImageData(). Es kann auch verwendet werden, um einen Teil des Canvas mit putImageData() zu setzen.

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 mit einem transparenten schwarzen Rechteck. Beachten Sie, dass dies die häufigste Methode ist, um ein solches Objekt in Workern zu erstellen, da createImageData() dort nicht verfügbar ist.

Instanzeigenschaften

ImageData.data Schreibgeschützt

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

ImageData.colorSpace Schreibgeschützt

Ein String, der den Farbraum der Bilddaten angibt.

ImageData.height Schreibgeschützt

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

ImageData.width Schreibgeschützt

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

ImageData.pixelFormat Schreibgeschützt Experimentell

Ein String, der das Format angibt, das für das ImageData verwendet werden soll.

Spezifikationen

Specification
HTML
# imagedata

Browser-Kompatibilität

Siehe auch