ImageDecoder: decode() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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.

Die decode()-Methode der ImageDecoder-Schnittstelle stellt eine Steuerungsnachricht in die Warteschlange, um den Frame eines Bildes zu decodieren.

In diesem Artikel

Syntax

js
decode()
decode(options)

Parameter

options Optional

Ein Objekt, das die folgenden Mitglieder enthält:

frameIndex Optional

Ein ganzzahliger Wert, der den Index des zu decodierenden Frames darstellt. Standardmäßig 0 (der erste Frame).

completeFramesOnly Optional

Ein boolean, der standardmäßig auf true gesetzt ist. Wenn true, wird das von der Methode zurückgegebene Promise nur dann aufgelöst, wenn das Bild vollständig decodiert ist. Wenn false, gibt die Methode ein neues Promise zurück, das möglicherweise mit einem teilweise decodierten Bild aufgelöst wird. Die Methode kann wiederholt aufgerufen werden, bis result.complete wahr ist, wobei jeder Schritt ein Bild mit der nächsten verfügbaren Detailebene bereitstellt.

Rückgabewert

Ein promise, das mit einem Objekt aufgelöst wird, das die folgenden Mitglieder enthält:

image

Ein VideoFrame, das das decodierte Bild enthält.

complete

Ein boolean, wenn true, zeigt an, dass image die finale, voll detaillierte Ausgabe enthält.

Ausnahmen

Wenn ein Fehler auftritt, wird das Promise mit folgender Ausnahme aufgelöst:

InvalidStateError DOMException

Wird zurückgegeben, wenn eine der folgenden Bedingungen zutrifft:

close ist wahr, was bedeutet, dass close() bereits aufgerufen wurde.
Der angeforderte Frame existiert nicht.

Beispiele

Synchrone Dekodierung eines vollständigen Bildframes

Das folgende Beispiel dekodiert den zweiten Frame (bei Index 1) und gibt das resultierende VideoFrame in der Konsole aus.

js
let result = await imageDecoder.decode({ frameIndex: 1 });
console.log(result.image);

Partielle Dekodierung eines progressiven Bildframes

Das folgende Beispiel dekodiert den ersten Frame wiederholt, bis er vollständig ist:

js
let complete = false;
while (!complete) {
  // The promise returned by `decode()` will only resolve when a new
  // level of detail is available or the frame is complete. I.e.,
  // calling `decode()` in a loop like this won't needlessly spin.
  let result = await imageDecoder.decode({ completeFramesOnly: false });

  // Do something with `result.image`.

  complete = result.complete;
}

Spezifikationen

Spezifikation

WebCodecs
# dom-imagedecoder-decode

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebCodecs API
ImageDecoder
Konstruktor
1. ImageDecoder()
Instanzeigenschaften
Statische Methoden
1. isTypeSupported()
Instanzmethoden
1. close()
2. decode()
3. reset()
Verwandte Seiten für WebCodecs API
Anleitungen
1. Konzepte der Videobearbeitung
2. Verwendung der WebCodecs API
3. Codec-Auswahl