From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- dom/webidl/VideoEncoder.webidl | 120 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 dom/webidl/VideoEncoder.webidl (limited to 'dom/webidl/VideoEncoder.webidl') diff --git a/dom/webidl/VideoEncoder.webidl b/dom/webidl/VideoEncoder.webidl new file mode 100644 index 0000000000..5fd40ca3c6 --- /dev/null +++ b/dom/webidl/VideoEncoder.webidl @@ -0,0 +1,120 @@ +/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this file, + * You can obtain one at http://mozilla.org/MPL/2.0/. + * + * The origin of this IDL file is + * https://w3c.github.io/webcodecs/#videoencoder + * + * Some members of this API are codec-specific, in which case the source of the + * IDL are in the codec-specific registry entries, that are listed in + * https://w3c.github.io/webcodecs/codec_registry.html. Those members are + * commented with a link of the document in which the member is listed. + */ + +[Exposed=(Window,DedicatedWorker), SecureContext, Pref="dom.media.webcodecs.enabled"] +interface VideoEncoder : EventTarget { + [Throws] + constructor(VideoEncoderInit init); + + readonly attribute CodecState state; + readonly attribute unsigned long encodeQueueSize; + attribute EventHandler ondequeue; + + [Throws] + undefined configure(VideoEncoderConfig config); + [Throws, BinaryName="VideoEncoder::EncodeVideoFrame"] + undefined encode(VideoFrame frame , optional VideoEncoderEncodeOptions options = {}); + [Throws] + Promise flush(); + [Throws] + undefined reset(); + [Throws] + undefined close(); + + [NewObject, Throws] + static Promise isConfigSupported(VideoEncoderConfig config); +}; + +dictionary VideoEncoderInit { + required EncodedVideoChunkOutputCallback output; + required WebCodecsErrorCallback error; +}; + +callback EncodedVideoChunkOutputCallback = + undefined (EncodedVideoChunk chunk, + optional EncodedVideoChunkMetadata metadata = {}); + +// AVC (H264)-specific +// https://w3c.github.io/webcodecs/avc_codec_registration.html +enum AvcBitstreamFormat { + "annexb", + "avc", +}; + +// AVC (H264)-specific +// https://w3c.github.io/webcodecs/avc_codec_registration.html +dictionary AvcEncoderConfig { + AvcBitstreamFormat format = "avc"; +}; + +dictionary VideoEncoderConfig { + required DOMString codec; + required [EnforceRange] unsigned long width; + required [EnforceRange] unsigned long height; + [EnforceRange] unsigned long displayWidth; + [EnforceRange] unsigned long displayHeight; + [EnforceRange] unsigned long long bitrate; + double framerate; + HardwareAcceleration hardwareAcceleration = "no-preference"; + AlphaOption alpha = "discard"; + DOMString scalabilityMode; + VideoEncoderBitrateMode bitrateMode = "variable"; + LatencyMode latencyMode = "quality"; + DOMString contentHint; + // AVC (H264)-specific + // https://w3c.github.io/webcodecs/avc_codec_registration.html + AvcEncoderConfig avc; +}; + +dictionary VideoEncoderEncodeOptions { + boolean keyFrame = false; + // AVC (H264)-specific + // https://w3c.github.io/webcodecs/avc_codec_registration.html + VideoEncoderEncodeOptionsForAvc avc; +}; + +// AVC (H264)-specific +// https://w3c.github.io/webcodecs/avc_codec_registration.html +dictionary VideoEncoderEncodeOptionsForAvc { + unsigned short? quantizer; +}; + +enum VideoEncoderBitrateMode { + "constant", + "variable", + // AVC (H264)-specific + // https://w3c.github.io/webcodecs/avc_codec_registration.html + "quantizer" +}; + +enum LatencyMode { + "quality", + "realtime" +}; + +dictionary VideoEncoderSupport { + boolean supported; + VideoEncoderConfig config; +}; + +dictionary EncodedVideoChunkMetadata { + VideoDecoderConfig decoderConfig; + SvcOutputMetadata svc; + // Not implemented https://bugzilla.mozilla.org/show_bug.cgi?id=1867067 + // BufferSource alphaSideData; +}; + +dictionary SvcOutputMetadata { + unsigned long temporalLayerId; +}; -- cgit v1.2.3