ImageDecoder: Konstruktor ImageDecoder()

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: Dieses Feature ist verfügbar in Dedicated Web Workers.

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 darstellen, wie durch type beschrieben.

premultiplyAlpha Optional

Gibt an, ob die Farbkanäle des dekodierten Bildes mit dem Alphakanal vorkompliziert werden sollen. Wenn nicht angegeben, ist der Standardwert "default":

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

Gibt an, ob das Bild mit Farbkonvertierung dekodiert werden soll. Wenn nicht angegeben, ist der Standardwert "default". Der Wert "default" weist auf eine implementierungsspezifische Verhaltensweise hin:

  • "none"
  • "default"
desiredWidth Optional

Ein ganzzahliger Wert, der die gewünschte Breite für die dekodierte Ausgabe angibt. Hat keine Wirkung, es sei denn, der Bildcodec unterstützt variabel auflösende Dekodierung.

desiredHeight Optional

Ein ganzzahliger Wert, der die gewünschte Höhe für die dekodierte Ausgabe angibt. Hat keine Wirkung, es sei denn, der Bildcodec unterstützt variabel auflösende Dekodierung.

preferAnimation Optional

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

transfer

Ein Array von ArrayBuffers, die ImageDecoder abtrennen und übernehmen wird. Wenn das Array den das data unterstützenden ArrayBuffer enthält, wird 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