Skip to content

Proper links for all references of codec strings #895

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 14, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions aac_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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
It describes, for AAC, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]], (2) the
codec-specific {{EncodedAudioChunk}} {{EncodedAudioChunk/[[internal data]]}}
bytes, (3) the {{AudioDecoderConfig/description|AudioDecoderConfig.description}}
bytes, (4) the values of {{EncodedAudioChunk}} {{EncodedAudioChunk/[[type]]}},
Expand Down Expand Up @@ -47,7 +47,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

This codec has multiple possible codec strings:
This codec has multiple possible [[WEBCODECS#config-codec-string|codec strings]]:

- `"mp4a.40.2"` — MPEG-4 AAC LC
- `"mp4a.40.02"` — MPEG-4 AAC LC, leading 0 for Aud-OTI compatibility
Expand Down
4 changes: 2 additions & 2 deletions alaw_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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,
It describes, for A-law encoded PCM, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedAudioChunk}}
{{EncodedAudioChunk/[[internal data]]}} bytes, (3) the
{{AudioDecoderConfig/description|AudioDecoderConfig.description}},
Expand Down Expand Up @@ -47,7 +47,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string is `"alaw"`.
The [[WEBCODECS#config-codec-string|codec string]] is `"alaw"`.

EncodedAudioChunk data {#encodedaudiochunk-data}
================================================
Expand Down
4 changes: 2 additions & 2 deletions av1_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 AV1, the (1) fully qualified codec strings,
It describes, for AV1, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedVideoChunk}}
{{EncodedVideoChunk/[[internal data]]}} bytes, (3) the codec-specific
extensions to {{VideoEncoderConfig}}, (4) the
Expand Down Expand Up @@ -53,7 +53,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string begins with the prefix `"av01."`, followed by a variable length
The [[WEBCODECS#config-codec-string|codec string]] begins with the prefix `"av01."`, followed by a variable length
suffix as described in Section 5 of [[AV1-ISOBMFF]].

EncodedVideoChunk data {#encodedvideochunk-data}
Expand Down
4 changes: 2 additions & 2 deletions avc_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 AVC (H.264), the (1) fully qualified codec strings,
It describes, for AVC (H.264), the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedVideoChunk}}
{{EncodedVideoChunk/[[internal data]]}} bytes, (3) the
{{VideoDecoderConfig/description|VideoDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -55,7 +55,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string begins with the prefix "avc1." or "avc3.", with a suffix of 6
The [[WEBCODECS#config-codec-string|codec string]] begins with the prefix "avc1." or "avc3.", with a suffix of 6
characters as described respectively in Section 3.4 of [[rfc6381]] and Section
5.4.1 of [[iso14496-15]].

Expand Down
10 changes: 5 additions & 5 deletions codec_registry.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -39,16 +39,16 @@
Organization {#organization}
============================

This registry maintains a mapping between codec strings and registration
This registry maintains a mapping between <a>codec strings</a> and registration
specifications as described below.

Registration Entry Requirements {#registration-entry-requirements}
==================================================================

1. Each entry must include a unique codec string, a common name string, and a
1. Each entry must include a unique <a>codec string</a>, a common name string, and a
link to the codec's specification.
2. The codec string must be crafted as follows:
1. If the codec string contains a fixed prefix with variable suffix values,
2. The <a>codec string</a> must be crafted as follows:
1. If the <a>codec string</a> contains a fixed prefix with variable suffix values,
the suffix must be represented by an asterisk and the registration's
public specification must describe how to fully qualify the variable
portion of the string.
Expand Down Expand Up @@ -79,7 +79,7 @@
The registry editors will review and merge the pull request.
6. Existing entries cannot be deleted or deprecated. They may be changed after
being published through the same process as candidate entries. Possible
changes include expansion of the codec string to better qualify the codec,
changes include expansion of the <a>codec string</a> to better qualify the codec,
adjustments to the codec name string, and modification of the link to the
codec's specification.

Expand Down
4 changes: 2 additions & 2 deletions flac_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 FLAC, the (1) fully qualified codec strings,
It describes, for FLAC, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedAudioChunk}}
{{EncodedAudioChunk/[[internal data]]}} bytes, (3) the
{{AudioDecoderConfig/description|AudioDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -47,7 +47,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string is `"flac"`.
The [[WEBCODECS#config-codec-string|codec string]] is `"flac"`.

EncodedAudioChunk data {#encodedaudiochunk-data}
================================================
Expand Down
4 changes: 2 additions & 2 deletions hevc_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 HEVC (H.265), the (1) fully qualified codec strings,
It describes, for HEVC (H.265), the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedVideoChunk}}
{{EncodedVideoChunk/[[internal data]]}} bytes, (3) the
{{VideoDecoderConfig/description|VideoDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -55,7 +55,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string begins with the prefix "hev1." or "hvc1.", with a suffix of
The [[WEBCODECS#config-codec-string|codec string]] begins with the prefix "hev1." or "hvc1.", with a suffix of
four dot-separated fields as described in Section E.3 of [[iso14496-15]].

EncodedVideoChunk data {#encodedvideochunk-data}
Expand Down
5 changes: 2 additions & 3 deletions index.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -2013,8 +2013,7 @@

<dl>
<dt><dfn dict-member for=VideoDecoderConfig>codec</dfn></dt>
<dd>Contains a codec string describing the codec.</dd>

<dd>Contains a <a>codec string</a> describing the codec.</dd>
<dt><dfn dict-member for=VideoDecoderConfig>description</dfn></dt>
<dd>
A sequence of codec specific bytes, commonly known as extradata.
Expand Down Expand Up @@ -2118,7 +2117,7 @@

<dl>
<dt><dfn dict-member for=AudioEncoderConfig>codec</dfn></dt>
<dd>Contains a codec string describing the codec.</dd>
<dd>Contains a <a>codec string</a> describing the codec.</dd>

<dt><dfn dict-member for=AudioEncoderConfig>sampleRate</dfn></dt>
<dd>The number of frame samples per second.</dd>
Expand Down
4 changes: 2 additions & 2 deletions mp3_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 MP3, the (1) fully qualified codec strings, (2)
It describes, for MP3, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]], (2)
the {{AudioDecoderConfig/description|AudioDecoderConfig.description}} bytes,
(3) the codec-specific {{EncodedAudioChunk}}
{{EncodedAudioChunk/[[internal data]]}} bytes, and (4)
Expand Down Expand Up @@ -48,7 +48,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

This codec has multiple equivalent codec strings:
This codec has multiple equivalent [[WEBCODECS#config-codec-string|codec strings]]:

- `"mp3"`
- `"mp4a.69"`
Expand Down
4 changes: 2 additions & 2 deletions opus_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 Opus, the (1) fully qualified codec strings, (2) the
It describes, for Opus, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]], (2) the
codec-specific {{EncodedAudioChunk}} {{EncodedAudioChunk/[[internal data]]}}
bytes, (3) the {{AudioDecoderConfig/description|AudioDecoderConfig.description}}
bytes, (4) the values of {{EncodedAudioChunk}} {{EncodedAudioChunk/[[type]]}},
Expand Down Expand Up @@ -54,7 +54,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string is `"opus"`.
The [[WEBCODECS#config-codec-string|codec string]] is `"opus"`.

EncodedAudioChunk data {#encodedaudiochunk-data}
================================================
Expand Down
13 changes: 8 additions & 5 deletions pcm_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 Linear PCM, the (1) fully qualified codec strings,
It describes, for Linear PCM, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedAudioChunk}}
{{EncodedAudioChunk/[[internal data]]}} bytes, (3) the
{{AudioDecoderConfig/description|AudioDecoderConfig.description}}, and
Expand Down Expand Up @@ -41,14 +41,17 @@
spec: WEBCODECS; urlPrefix: https://w3c.github.io/webcodecs/#
type: dfn
text: interleaved; url: interleaved
spec: WEBCODECS; urlPrefix: https://w3c.github.io/webcodecs/#
type: dfn
text: samples; url: sample
</pre>


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

This codec's string begins with the prefix "pcm-", followed by a suffix that
indicates the sample format. The complete list of strings and associated
This [[WEBCODECS#config-codec-string|codec string]] begins with the prefix "pcm-", followed by a suffix that
indicates the sample format. The complete list of [[WEBCODECS#config-codec-string|codec strings]] and associated
formats is as follows.

* pcm-u8, using format {{u8}}
Expand All @@ -71,8 +74,8 @@
between two successive values are linearly uniform.

{{EncodedAudioChunk}} {{EncodedAudioChunk/[[internal data]]}} is expected to be
a sequence of bytes of arbitrary length, with a [=sample=] occuring every N
bits, where N is defined by the codec string. For multichannel PCM, [=samples=]
a sequence of bytes of arbitrary length, with a [=sample=] occurring every N
bits, where N is defined by the [[WEBCODECS#config-codec-string|codec string]]. For multichannel PCM, [=samples=]
from different channels are [=interleaved=].


Expand Down
4 changes: 2 additions & 2 deletions ulaw_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 u-law encoded PCM, the (1) fully qualified codec strings,
It describes, for u-law encoded PCM, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedAudioChunk}}
{{EncodedAudioChunk/[[internal data]]}} bytes, (3) the
{{AudioDecoderConfig/description|AudioDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -47,7 +47,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string is `"ulaw"`.
The [[WEBCODECS#config-codec-string|codec string]] is `"ulaw"`.

EncodedAudioChunk data {#encodedaudiochunk-data}
================================================
Expand Down
4 changes: 2 additions & 2 deletions vorbis_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 Vorbis, the (1) fully qualified codec strings,
It describes, for Vorbis, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedAudioChunk}}
{{EncodedAudioChunk/[[internal data]]}} bytes, (3) the
{{AudioDecoderConfig/description|AudioDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -52,7 +52,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string is `"vorbis"`.
The [[WEBCODECS#config-codec-string|codec string]] is `"vorbis"`.

EncodedAudioChunk data {#encodedaudiochunk-data}
================================================
Expand Down
4 changes: 2 additions & 2 deletions vp8_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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 VP8, the (1) fully qualified codec strings,
It describes, for VP8, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedVideoChunk}}
{{EncodedVideoChunk/[[internal data]]}} bytes, (3) the
{{VideoDecoderConfig/description|VideoDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -46,7 +46,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string is `"vp8"`.
The [[WEBCODECS#config-codec-string|codec string]] is `"vp8"`.

EncodedVideoChunk data {#encodedvideochunk-data}
================================================
Expand Down
4 changes: 2 additions & 2 deletions vp9_codec_registration.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
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,
It describes, for VP9, the (1) fully qualified [[WEBCODECS#config-codec-string|codec strings]],
(2) the codec-specific {{EncodedVideoChunk}}
{{EncodedVideoChunk/[[internal data]]}} bytes, (3) the
{{VideoDecoderConfig/description|VideoDecoderConfig.description}} bytes,
Expand Down Expand Up @@ -52,7 +52,7 @@
Fully qualified codec strings {#fully-qualified-codec-strings}
==============================================================

The codec string begins with the prefix `"vp09."`, followed by a variable length
The [[WEBCODECS#config-codec-string|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}
Expand Down