ImageData: pixelFormat-Eigenschaft

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die schreibgeschützte ImageData.pixelFormat-Eigenschaft ist ein String, der das Pixelformat der Bilddaten angibt.

Das Pixelformat kann während der ImageData-Initialisierung entweder mit dem ImageData()-Konstruktor oder der createImageData()-Methode festgelegt werden.

Wert

Diese Eigenschaft kann die folgenden Werte haben:

  • "rgba-unorm8" repräsentiert RGBA mit 8 Bit pro Komponente im unsignierten, normalisierten Format, unter Verwendung eines Uint8ClampedArray.
  • "rgba-float16" repräsentiert RGBA mit 16 Bits pro Komponente, unter Verwendung eines Float16Array. Gleitkommapixel-Werte ermöglichen die Darstellung von Farben in beliebig breiten Farbumfängen und im Hochdynamikbereich (HDR).

Beispiele

Gleitkomma-Pixeldaten für breite Farbumfänge und hohen Dynamikbereich (HDR)

Gleitkommapixel-Werte ermöglichen die Darstellung von Farben in beliebig breiten Farbumfängen und im hohen Dynamikbereich (HDR). Sie können die pixelFormat-Einstellung auf "rgba-float16" setzen, um RGBA-Werte mit 16 Bits pro Komponente zu verwenden. Dies erfordert, dass das dataArray ein Float16Array ist.

js
let floatArray = new Float16Array(4 * 200 * 200);
let imageData = new ImageData(floatArray, 200, 200, {
  pixelFormat: "rgba-float16",
});
console.log(imageData.pixelFormat); // "rgba-float16"

Spezifikationen

Specification
HTML
# dom-imagedata-pixelformat

Browser-Kompatibilität

Siehe auch