ImageDecoder: ImageDecoder() Konstruktor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

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

Der ImageDecoder() Konstruktor erstellt ein neues ImageDecoder-Objekt, das Bilddaten entpackt und dekodiert.

Syntax

js
new ImageDecoder(init)

Parameter

init

Ein Objekt, das die folgenden Mitglieder enthält:

type

Ein String, der den MIME-Typ der zu dekodierenden Bilddatei enthält.

data

Ein ArrayBuffer, ein TypedArray, ein DataView oder ein ReadableStream von Bytes, die einen kodierten Bildtyp repräsentieren, wie durch type beschrieben.

premultiplyAlpha Optional

Gibt an, ob die Farbkanäle des dekodierten Bildes mit dem Alphakanal vorvervielfacht werden sollen. Wenn nicht angegeben, wird "default" verwendet:

  • "none"
  • "premultiply"
  • "default"
colorSpaceConversion Optional

Gibt an, ob das Bild unter Verwendung der Farbkonvertierung dekodiert werden soll. Wenn nicht angegeben, wird "default" verwendet. Der Wert "default" zeigt an, dass implementierungsspezifisches Verhalten verwendet wird:

  • "none"
  • "default"
desiredWidth Optional

Eine ganze Zahl, die die gewünschte Breite für die dekodierte Ausgabe angibt. Hat keine Auswirkungen, es sei denn, der Bildcodec unterstützt das Dekodieren mit variabler Auflösung.

desiredHeight Optional

Eine ganze Zahl, die die gewünschte Höhe für die dekodierte Ausgabe angibt. Hat keine Auswirkungen, es sei denn, der Bildcodec unterstützt das Dekodieren mit variabler Auflösung.

preferAnimation Optional

Ein Boolean, der angibt, ob die anfängliche Track-Auswahl einen animierten Track bevorzugen soll.

transfer

Ein Array von ArrayBuffers, die vom ImageDecoder gelöst und in Besitz genommen werden. Wenn das Array den ArrayBuffer enthält, der data unterstützt, wird der ImageDecoder diesen Puffer direkt verwenden, anstatt ihn zu kopieren.

Beispiele

Das folgende Beispiel erstellt einen neuen ImageDecoder mit den erforderlichen Optionen.

js
let init = {
  type: "image/png",
  data: imageByteStream,
};

let imageDecoder = new ImageDecoder(init);

Spezifikationen

Specification
WebCodecs
# dom-imagedecoder-imagedecoder

Browser-Kompatibilität

BCD tables only load in the browser