Sync

.github/workflows/auto-publish.yml

@@ -93,6 +93,16 @@ jobs:
             echidna_token: ECHIDNA_TOKEN_ULAW_REGISTRATION
             build_override: |
               status: NOTE-WD
+          - source: hevc_codec_registration.src.html
+            destination: hevc_codec_registration.html
+            echidna_token: ECHIDNA_TOKEN_HEVC_REGISTRATION
+            build_override: |
+              status: NOTE-WD
+          - source: video_frame_metadata_registry.src.html
+            destination: video_frame_metadata_registry.html
+            echidna_token: ECHIDNA_TOKEN_VIDEOFRAMEMETADATA_REGISTRY
+            build_override: |
+              status: DRY
     steps:
       # See doc at https://github.com/actions/checkout#checkout-v2
       - name: Checkout repository

.gitignore

@@ -1,17 +1,19 @@
 /index.html
+aac_codec_registration.html
+alaw_codec_registration.html
 alaw_codec_registration.html
 av1_codec_registration.html
 avc_codec_registration.html
 codec_registry.html
 flac_codec_registration.html
+hevc_codec_registration.html
 mp3_codec_registration.html
-aac_codec_registration.html
 opus_codec_registration.html
 out/
+pcm_codec_registration.html
 ulaw_codec_registration.html
+ulaw_codec_registration.html
+video_frame_metadata_registry.html
 vorbis_codec_registration.html
 vp8_codec_registration.html
 vp9_codec_registration.html
-pcm_codec_registration.html
-alaw_codec_registration.html
-ulaw_codec_registration.html

README.md

@@ -9,12 +9,12 @@ Many Web APIs use media codecs internally to support APIs for particular uses:
 - MediaRecorder
 - WebRTC
 
-But there’s no general way to flexibly configure and use these media codecs. 
-Because of this, many web applications have resorted to implementing 
+But there’s no general way to flexibly configure and use these media codecs.
+Because of this, many web applications have resorted to implementing
 media codecs in JavaScript or WebAssembly, despite the disadvantages:
 - Increased bandwidth to download codecs already in the browser.
 - Reduced performance
-- Reduced power efficiency 
+- Reduced power efficiency
 
 It's great for:
 - Live streaming
@@ -27,6 +27,20 @@ See the [explainer](https://github.com/w3c/webcodecs/blob/main/explainer.md) for
 
 Please see https://w3c.github.io/webcodecs/samples/
 
-## WebCodecs Codec Registry
+## WebCodecs registries
 
-This repository also contains the [WebCodecs Codec Registry](https://w3c.github.com/webcodecs/codec_registry.html), which provides the means to identify and avoid collisions among codec strings used in WebCodecs and provides a mechanism to define codec-specific members of WebCodecs codec configuration dictionaries. Codec-specific registrations entered in the registry are also maintained in the repository, please refer to the registry for a comprehensive list.
+This repository also contains two registries:
+
+* The [WebCodecs Codec Registry](https://w3c.github.io/webcodecs/codec_registry.html)
+provides the means to identify and avoid collisions among codec strings
+used in WebCodecs and provides a mechanism to define codec-specific members of
+WebCodecs codec configuration dictionaries. Codec-specific registrations entered
+in the registry are also maintained in the repository, please refer to the
+registry for a comprehensive list.
+
+* The [WebCodecs VideoFrame Metadata Registry](https://w3c.github.io/webcodecs/video_frame_metadata_registry.html)
+enumerates the metadata fields that can be attached to
+[VideoFrame](https://w3c.github.io/webcodecs/#videoframe-interface) objects via the
+[VideoFrameMetadata](https://w3c.github.io/webcodecs/#dictdef-videoframemetadata) dictionary.
+Metadata registrations entered in the registry may be maintained in this repository
+or elsewhere. Please refer to the registry for a comprehensive list.

aac_codec_registration.src.html

@@ -7,16 +7,16 @@
 Group: mediawg
 ED: https://w3c.github.io/webcodecs/aac_codec_registration.html
 TR: https://www.w3.org/TR/webcodecs-aac-codec-registration/
-Editor: Chris Cunningham, w3cid 114832, Google Inc. https://www.google.com/
 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 AAC, the (1) fully qualified codec strings, (2) the
-    codec-specific {{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=]
-    bytes, (3) the {{AudioDecoderConfig.description}} bytes, (4) the values of
-    {{EncodedAudioChunk}} [=EncodedAudioChunk/[[type]]=], and (5) the
-    codec-specific extensions to {{AudioEncoderConfig}}
+    codec-specific {{EncodedAudioChunk}} {{EncodedAudioChunk/[[internal data]]}}
+    bytes, (3) the {{AudioDecoderConfig/description|AudioDecoderConfig.description}}
+    bytes, (4) the values of {{EncodedAudioChunk}} {{EncodedAudioChunk/[[type]]}},
+    and (5) the codec-specific extensions to {{AudioEncoderConfig}}
 
     The registration is not intended to include any information on whether a
     codec format is encumbered by intellectual property claims. Implementers and
@@ -32,23 +32,6 @@
 !Version History: <a href="https://github.com/w3c/webcodecs/commits">https://github.com/w3c/webcodecs/commits</a>
 </pre>
 
-<pre class='anchors'>
-spec: WEBCODECS; urlPrefix: https://w3c.github.io/webcodecs/#
-    type: attribute
-        text: AudioDecoderConfig.description; url: dom-audiodecoderconfig-description
-        text: AudioDecoderConfig.sampleRate; url: dom-audiodecoderconfig-samplerate
-        text: AudioDecoderConfig.numberOfChannels; url: dom-audiodecoderconfig-numberofchannels
-    type: dfn
-        for: EncodedAudioChunkType; text: key; url: dom-encodedaudiochunktype-key
-        for: EncodedAudioChunk; text: [[internal data]]; url: dom-encodedaudiochunk-internal-data-slot
-        for: EncodedAudioChunk; text: [[type]]; url: dom-encodedaudiochunk-type-slot
-    type: interface
-        text: EncodedAudioChunk; url: encodedaudiochunk
-    type: dictionary
-        text: AudioDecoderConfig; url: dictdef-audiodecoderconfig
-        text: AudioEncoderConfig; url: dictdef-audioencoderconfig
-</pre>
-
 <pre class='biblio'>
 {
   "iso14496-3": {
@@ -76,32 +59,32 @@
 ================================================
 
 If the bitstream is in {{AacBitstreamFormat/adts}} format, the
-[=EncodedAudioChunk/[[internal data]]=] of {{EncodedAudioChunk}}s are expected
+{{EncodedAudioChunk/[[internal data]]}} of {{EncodedAudioChunk}}s are expected
 to be an ADTS frame, as described in section 1.A.3.2 of [[iso14496-3]].
 
 If the bitstream is in {{AacBitstreamFormat/aac}} format, the
-[=EncodedAudioChunk/[[internal data]]=] of {{EncodedAudioChunk}}s are expected
+{{EncodedAudioChunk/[[internal data]]}} of {{EncodedAudioChunk}}s are expected
 to be a raw AAC frame (syntax element `raw_data_block()`), as described in
 section 4.4.2.1 of [[iso14496-3]].
 
 AudioDecoderConfig description {#audiodecoderconfig-description}
 ================================================================
 
-If {{AudioDecoderConfig.description}} is present, it is assumed to a
+If {{AudioDecoderConfig/description}} is present, it is assumed to a
 `AudioSpecificConfig` as defined in [[iso14496-3]] section 1.6.2.1, Table 1.15,
 and the bitstream is assumed to be in {{AacBitstreamFormat/aac}}.
 
-If the {{AudioDecoderConfig.description}} is not present, the bitstream is
+If the {{AudioDecoderConfig/description}} is not present, the bitstream is
 assumed to be in {{AacBitstreamFormat/adts}} format.
 
-The {{AudioDecoderConfig.sampleRate}} and {{AudioDecoderConfig.numberOfChannels}}
+The {{AudioDecoderConfig/sampleRate}} and {{AudioDecoderConfig/numberOfChannels}}
 members are ignored.
 
 EncodedAudioChunk type {#encodedaudiochunk-type}
 ================================================
 
-The [=EncodedAudioChunk/[[type]]=] for an {{EncodedAudioChunk}} containing
-AAC is always "[=EncodedAudioChunkType/key=]".
+The {{EncodedAudioChunk/[[type]]}} for an {{EncodedAudioChunk}} containing
+AAC is always "{{EncodedAudioChunkType/key}}".
 
 NOTE: Once the initialization has succeeded, any AAC packet can be decoded at
     any time without error, but this might not result in the expected audio
@@ -161,17 +144,22 @@
       <dt><dfn enum-value for=AacBitstreamFormat>aac</dfn></dt>
       <dd>
         The metadata of the encoded audio stream are provided at configuration via
-        {{AudioDecoderConfig.description}}.
+        {{AudioDecoderConfig/description|AudioDecoderConfig.description}}.
       </dd>
       <dt><dfn enum-value for=AacBitstreamFormat>adts</dfn></dt>
       <dd>
         The metadata of the encoded audio stream are provided in each ADTS frame,
-        and therefore no {{AudioDecoderConfig.description}} is necessary.
+        and therefore no {{AudioDecoderConfig/description|AudioDecoderConfig.description}} is necessary.
     </dl>
 
-Privacy and Security Considerations {#privacy-and-security-considerations}
+Privacy Considerations {#privacy-considerations}
+==========================================================================
+
+Please refer to the section [[WEBCODECS#privacy-considerations|Privacy
+Considerations]] in [[WEBCODECS]].
+
+Security Considerations {#security-considerations}
 ==========================================================================
 
-Please refer to the [[WEBCODECS#privacy-considerations|Privacy Considerations]]
-and [[WEBCODECS#security-considerations|Security Considerations]] sections in
-[[WEBCODECS]].
+Please refer to the section [[WEBCODECS#security-considerations|Security
+Considerations]] in [[WEBCODECS]].

alaw_codec_registration.src.html

@@ -7,16 +7,16 @@
 Group: mediawg
 ED: https://w3c.github.io/webcodecs/alaw_codec_registration.html
 TR: https://www.w3.org/TR/webcodecs-alaw-codec-registration/
-Editor: Chris Cunningham, w3cid 114832, Google Inc. https://www.google.com/
 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 A-law encoded PCM, the (1) fully qualified codec strings,
     (2) the codec-specific {{EncodedAudioChunk}}
-    [=EncodedAudioChunk/[[internal data]]=] bytes, (3) the
-    {{AudioDecoderConfig.description}}, and (4) the values of
-    {{EncodedAudioChunk}} [=EncodedAudioChunk/[[type]]=].
+    {{EncodedAudioChunk/[[internal data]]}} bytes, (3) the
+    {{AudioDecoderConfig/description|AudioDecoderConfig.description}},
+    and (4) the values of {{EncodedAudioChunk}} {{EncodedAudioChunk/[[type]]}}.
 
     The registration is not intended to include any information on whether a
     codec format is encumbered by intellectual property claims. Implementers and
@@ -32,21 +32,6 @@
 !Version History: <a href="https://github.com/w3c/webcodecs/commits">https://github.com/w3c/webcodecs/commits</a>
 </pre>
 
-<pre class='anchors'>
-spec: WEBCODECS; urlPrefix: https://w3c.github.io/webcodecs/#
-    type: attribute
-        text: AudioDecoderConfig.description; url: dom-audiodecoderconfig-description
-    type: dfn
-        for: EncodedAudioChunkType; text: key; url: dom-encodedaudiochunktype-key
-        for: EncodedAudioChunk; text: [[internal data]]; url: dom-encodedaudiochunk-internal-data-slot
-        for: EncodedAudioChunk; text: [[type]]; url: dom-encodedaudiochunk-type-slot
-    type: interface
-        text: EncodedAudioChunk; url: encodedaudiochunk
-    type: dictionary
-        text: AudioDecoderConfig; url: dictdef-audiodecoderconfig
-        text: AudioEncoderConfig; url: dictdef-audioencoderconfig
-</pre>
-
 <pre class='biblio'>
 {
   "ITU-G.711": {
@@ -66,25 +51,30 @@
 EncodedAudioChunk data {#encodedaudiochunk-data}
 ================================================
 
-{{EncodedAudioChunk}} [=EncodedAudioChunk/[[internal data]]=] is expected to be
+{{EncodedAudioChunk}} {{EncodedAudioChunk/[[internal data]]}} is expected to be
 a sequence of bytes of arbitrary length, where each byte is an A-law
 encoded PCM sample as defined by Tables 1a and 1b in [[ITU-G.711]].
 
 AudioDecoderConfig description {#audiodecoderconfig-description}
 ================================================================
 
-An {{AudioDecoderConfig.description}} is expected to be omitted from the
+The {{AudioDecoderConfig/description}} is expected to be omitted from the
 {{AudioDecoderConfig}}.
 
 EncodedAudioChunk type {#encodedaudiochunk-type}
 ================================================
 
-The [=EncodedAudioChunk/[[type]]=] for an {{EncodedAudioChunk}} containing
-A-law PCM is always "[=EncodedAudioChunkType/key=]".
+The {{EncodedAudioChunk/[[type]]}} for an {{EncodedAudioChunk}} containing
+A-law PCM is always "{{EncodedAudioChunkType/key}}".
+
+Privacy Considerations {#privacy-considerations}
+==========================================================================
+
+Please refer to the section [[WEBCODECS#privacy-considerations|Privacy
+Considerations]] in [[WEBCODECS]].
 
-Privacy and Security Considerations {#privacy-and-security-considerations}
+Security Considerations {#security-considerations}
 ==========================================================================
 
-Please refer to the [[WEBCODECS#privacy-considerations|Privacy Considerations]]
-and [[WEBCODECS#security-considerations|Security Considerations]] sections in
-[[WEBCODECS]].
+Please refer to the section [[WEBCODECS#security-considerations|Security
+Considerations]] in [[WEBCODECS]].