ImageDecoder: метод decode()

Метод decode() интерфейса ImageDecoder добавляет в очередь управляющее сообщение для декодирования кадра изображения.

options Необязательно

Объект, содержащий следующие члены:

frameIndex Необязательно

Целое число, представляющее индекс кадра для декодирования. По умолчанию 0 (первый кадр).

completeFramesOnly Необязательно

Значение типа boolean по умолчанию true. Когда false указывает, что для прогрессивных изображений декодер может выдать изображение с уменьшенной детализацией. При false, промис, возвращаемый decode(), разрешится ровно один раз для каждого нового уровня детализации.

Промис promise, который разрешается объектом, содержащим следующие члены:

image

VideoFrame, содержащий декодированное изображение.

complete

Значение типа boolean, если true указывает, что image содержит окончательный вывод с полной детализацией.

Если произошла ошибка, промис разрешится следующим исключением:

InvalidStateError DOMException

Возвращается, если выполняются следующие условия:

• close имеет значение true, что означает, что метод close() уже был вызван.
• Запрашиваемого кадра не существует.

В следующем примере декодируется второй кадр (с индексом 1) и выводится полученный VideoFrame в консоль.

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

В следующем примере декодируется первый кадр до тех пор, пока он не станет полным:

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 is won't needlessly spin.
  let result = await imageDecode.decode({ completeFramesOnly: false });

  // Do something with `result.image`.

  complete = result.complete;
}