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 erstellt mithilfe des ImageData()
Konstruktors oder Erstellermethoden auf dem CanvasRenderingContext2D
Objekt, das mit einem Canvas verbunden ist: createImageData()
und getImageData()
. Es kann auch verwendet werden, um einen Teil des Canvas mithilfe von putImageData()
festzulegen.
Konstruktoren
ImageData()
-
Erstellt ein
ImageData
-Objekt aus einem gegebenenUint8ClampedArray
und der Größe des Bildes, das es enthält. Wenn kein Array angegeben ist, wird ein Bild eines transparenten schwarzen Rechtecks erstellt. Beachten Sie, dass dies die häufigste Art ist, ein solches Objekt in Workern zu erstellen, dacreateImageData()
dort nicht verfügbar ist.
Instanz-Eigenschaften
ImageData.data
Schreibgeschützt-
Ein
Uint8ClampedArray
, das ein eindimensionales Array repräsentiert, das die Daten in der RGBA-Reihenfolge enthält, mit ganzzahligen Werten zwischen0
und255
(einschließlich). Die Reihenfolge verläuft zeilenweise vom oberen linken Pixel zum unteren rechten. 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-
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
.