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 gegebenenUint8ClampedArray
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, dacreateImageData()
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 zwischen0
und255
(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 desImageData
in Pixeln darstellt. ImageData.width
Nur lesbar-
Ein
unsigned long
, der die tatsächliche Breite desImageData
in Pixeln darstellt.
Spezifikationen
Specification |
---|
HTML Standard # imagedata |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
CanvasRenderingContext2D
- Das
<canvas>
-Element und sein zugehöriges Interface,HTMLCanvasElement
.