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 gegebenenUint8ClampedArray
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, dacreateImageData()
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 zwischen0
und255
(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 desImageData
darstellt. ImageData.width
Schreibgeschützt-
Ein
unsigned long
, der die tatsächliche Breite in Pixeln desImageData
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
CanvasRenderingContext2D
- Das
<canvas>
-Element und sein zugehöriges Interface,HTMLCanvasElement
.