From 559f005c9fcf8fedad472c123cd4c5ff8ecb3397 Mon Sep 17 00:00:00 2001
From: Eugene Zemtsov <eugene@chromium.org>
Date: Fri, 31 Mar 2023 17:19:44 -0700
Subject: [PATCH] Per frame quantizer option for Av1.

This value is used by VideoEncoder.encode() if VideoEncoder is configured
with "quantizer" bitrate mode.
---
 av1_codec_registration.src.html | 41 +++++++++++++++++++++++++++++++--
 1 file changed, 39 insertions(+), 2 deletions(-)

diff --git a/av1_codec_registration.src.html b/av1_codec_registration.src.html
index 7f73ca66..603cc474 100644
--- a/av1_codec_registration.src.html
+++ b/av1_codec_registration.src.html
@@ -15,8 +15,9 @@
     It describes, for AV1, the (1) fully qualified codec strings,
     (2) the codec-specific {{EncodedVideoChunk}}
     {{EncodedVideoChunk/[[internal data]]}} bytes, (3) the
-    {{VideoDecoderConfig/description|VideoDecoderConfig.description}} bytes, and
-    (4) the values of {{EncodedVideoChunk}} {{EncodedVideoChunk/[[type]]}}.
+    {{VideoDecoderConfig/description|VideoDecoderConfig.description}} bytes,
+    (4) the values of {{EncodedVideoChunk}} {{EncodedVideoChunk/[[type]]}}, and
+    (5) the codec-specific extensions to {{VideoEncoderEncodeOptions}}.
 
     The registration is not intended to include any information on whether a
     codec format is encumbered by intellectual property claims. Implementers and
@@ -73,6 +74,42 @@
 contain a frame with a `frame_type` of `KEY_FRAME` as defined in Section
 6.8.2 of [[AV1]].
 
+VideoEncoderEncodeOptions extensions {#videoencoderencodeoptions-extensions}
+==============================================================
+
+<pre class='idl'>
+<xmp>
+partial dictionary VideoEncoderEncodeOptions {
+  VideoEncoderEncodeOptionsForAv1 av1;
+};
+</xmp>
+</pre>
+
+<dl>
+  <dt><dfn dict-member for=VideoEncoderEncodeOptions>av1</dfn></dt>
+  <dd>
+    Contains codec specific encode options for the [[AV1]] codec.
+  </dd>
+</dl>
+
+VideoEncoderEncodeOptionsForAv1 {#av1-encode-options}
+--------------------------------------
+<pre class='idl'>
+<xmp>
+dictionary VideoEncoderEncodeOptionsForAv1 {
+  unsigned short? quantizer;
+};
+</xmp>
+</pre>
+
+<dl>
+  <dt><dfn dict-member for=VideoEncoderEncodeOptionsForAv1>quantizer</dfn></dt>
+  <dd>
+    Sets per-frame quantizer value.
+    In [[AV1]] the quantizer threshold can be varied from 0 to 63
+  </dd>
+</dl>
+
 Privacy Considerations {#privacy-considerations}
 ==========================================================================