vp9_codec_registration.src.html

<pre class='metadata'>
Title: VP9 WebCodecs Registration
Repository: w3c/webcodecs
Status: NOTE-ED
Shortname: webcodecs-vp9-codec-registration
Level: none
Group: mediawg
ED: https://w3c.github.io/webcodecs/vp9_codec_registration.html
TR: https://www.w3.org/TR/webcodecs-vp9-codec-registration/
Editor: Paul Adenot, w3cid 62410, Mozilla https://www.mozilla.org/
Editor: Bernard Aboba, w3cid 65611, Microsoft Corporation https://www.microsoft.com/
Former Editor: Chris Cunningham, w3cid 114832, Google Inc. https://www.google.com/

Abstract: This registration is entered into the [[webcodecs-codec-registry]].
    It describes, for VP9, the (1) fully qualified codec strings,
    (2) the codec-specific {{EncodedVideoChunk}}
    {{EncodedVideoChunk/[[internal data]]}} bytes, (3) the
    {{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
    authors are advised to seek appropriate legal counsel in this matter if they
    intend to implement or use a specific codec format. Implementers of
    WebCodecs are not required to support the VP9 codec.

    This registration is non-normative.

Markup Shorthands:css no, markdown yes, dfn yes
!Participate: <a href="https://github.com/w3c/webcodecs">Git Repository.</a>
!Participate: <a href="https://github.com/w3c/webcodecs/issues/new">File an issue.</a>
!Version History: <a href="https://github.com/w3c/webcodecs/commits">https://github.com/w3c/webcodecs/commits</a>
</pre>

<pre class='biblio'>
{
  "VP9": {
    "href": "https://storage.googleapis.com/downloads.webmproject.org/docs/vp9/vp9-bitstream-specification-v0.6-20160331-draft.pdf",
    "title": "VP9 Bitstream & Decoding Process Specification",
    "publisher": "The WebM Project"
  },
  "VP9-ISOBMFF": {
    "href": "https://github.com/webmproject/vp9-dash/blob/master/VPCodecISOMediaFileFormatBinding.md",
    "title": "VP Codec ISO Media File Format Binding",
    "publisher": "The WebM Project"
  }
}
</pre>

Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string begins with the prefix `"vp09."`, followed by a variable length
suffix as described in the "Codecs Parameter String" Section of [[VP9-ISOBMFF]].

EncodedVideoChunk data {#encodedvideochunk-data}
================================================

{{EncodedVideoChunk}} {{EncodedVideoChunk/[[internal data]]}} is expected to be
a frame as described in Section 6 of [[VP9]].

VideoDecoderConfig description {#videodecoderconfig-description}
================================================================

The {{VideoDecoderConfig/description}} is not used for this codec.

EncodedVideoChunk type {#encodedvideochunk-type}
================================================

If an {{EncodedVideoChunk}}'s {{EncodedVideoChunk/[[type]]}} is
{{EncodedVideoChunkType/key}}, then the {{EncodedVideoChunk}} is expected to
contain a frame with a `frame_type` of `KEY_FRAME` as defined in Section
7.2 of [[VP9]].

VideoEncoderEncodeOptions extensions {#videoencoderencodeoptions-extensions}
==============================================================

<pre class='idl'>
<xmp>
partial dictionary VideoEncoderEncodeOptions {
  VideoEncoderEncodeOptionsForVp9 vp9;
};
</xmp>
</pre>

<dl>
  <dt><dfn dict-member for=VideoEncoderEncodeOptions>vp9</dfn></dt>
  <dd>
    Contains codec specific encode options for the [[VP9]] codec.
  </dd>
</dl>

VideoEncoderEncodeOptionsForVp9 {#vp9-encode-options}
--------------------------------------
<pre class='idl'>
<xmp>
dictionary VideoEncoderEncodeOptionsForVp9 {
  unsigned short? quantizer;
};
</xmp>
</pre>

<dl>
  <dt><dfn dict-member for=VideoEncoderEncodeOptionsForVp9>quantizer</dfn></dt>
  <dd>
    Sets per-frame quantizer value.
    In [[VP9]] the quantizer threshold can be varied from 0 to 63
  </dd>
</dl>


Privacy Considerations {#privacy-considerations}
==========================================================================

Please refer to the section [[WEBCODECS#privacy-considerations|Privacy
Considerations]] in [[WEBCODECS]].

Security Considerations {#security-considerations}
==========================================================================

Please refer to the section [[WEBCODECS#security-considerations|Security
Considerations]] in [[WEBCODECS]].