ImageData
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Das ImageData-Interface repräsentiert die zugrunde liegenden Pixel-Daten eines Bereichs eines <canvas>-Elements.
Es wird mithilfe des ImageData()-Konstruktors oder durch Erstellmethoden des CanvasRenderingContext2D-Objekts erstellt, das mit einem Canvas verknüpft ist: createImageData() und getImageData(). Es kann auch verwendet werden, um einen Teil des Canvas festzulegen, indem putImageData() verwendet wird.
Konstruktoren
ImageData()-
Erstellt ein
ImageData-Objekt aus einem gegebenenUint8ClampedArrayoderFloat16Arrayund der Größe des Bildes, das es enthält. Wenn kein Array angegeben ist, wird ein Bild eines transparenten schwarzen Rechtecks erstellt. Dies ist der häufigste Weg, um ein solches Objekt in Arbeitern zu erstellen, dacreateImageData()dort nicht verfügbar ist.
Instanz-Eigenschaften
ImageData.dataSchreibgeschützt-
Ein
Uint8ClampedArrayoderFloat16Array, das ein eindimensionales Array darstellt, welches die Daten in der RGBA-Reihenfolge enthält. Die Reihenfolge erfolgt zeilenweise vom Pixel oben links bis unten rechts. ImageData.colorSpaceSchreibgeschützt-
Ein String, der den Farbraum der Bilddaten angibt.
ImageData.heightSchreibgeschützt-
Ein
unsigned long, der die tatsächliche Höhe desImageDatain Pixeln darstellt. ImageData.widthSchreibgeschützt-
Ein
unsigned long, der die tatsächliche Breite desImageDatain Pixeln darstellt. ImageData.pixelFormatSchreibgeschützt Experimentell-
Ein String, der das Format angibt, das für das
ImageDataverwendet werden soll.
Spezifikationen
| Spezifikation |
|---|
| HTML # imagedata |
Browser-Kompatibilität
Siehe auch
CanvasRenderingContext2D- Das
<canvas>-Element und seine zugehörige Schnittstelle,HTMLCanvasElement.