Skip to content

Commit 129b7b4

Browse files
committed
Update copyright dates on spec markup.
Use modern quote style everywhere.
1 parent 178e353 commit 129b7b4

26 files changed

Lines changed: 404 additions & 431 deletions

‎BUILD.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2014-2024 The Khronos Group Inc.
1+
// Copyright 2014-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
= Khronos^(TM) Data Format Specification Build Instructions and Notes

‎CODE_OF_CONDUCT.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2018-2024 The Khronos Group Inc.
1+
// Copyright 2018-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
= Code of Conduct

‎CONTRIBUTING.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2020-2024 The Khronos Group Inc.
1+
// Copyright 2020-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
= Contributing

‎COPYING.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2020-2024 The Khronos Group Inc.
1+
// Copyright 2020-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
= COPYING File for the KhronosGroup/DataFormat Project

‎LICENSE.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2020-2024 The Khronos Group Inc.
1+
// Copyright 2020-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
= LICENSE File for the KhronosGroup/Vulkan-Docs Project

‎Makefile‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Copyright 2024 The Khronos Group Inc.
1+
# Copyright 2024-2026 The Khronos Group Inc.
22
# SPDX-License-Identifier: Apache-2.0
33

44
# Khronos Data Format Specification Makefile

‎README.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2014-2024 The Khronos Group Inc.
1+
// Copyright 2014-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
ifdef::env-github[]

‎chapters/astc.adoc‎

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2014-2024 The Khronos Group Inc.
1+
// Copyright 2014-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
[[ASTC]]
@@ -20,7 +20,7 @@ ASTC textures may be encoded using either high or low dynamic range.
2020
Low dynamic range images may optionally be specified using the sRGB
2121
transfer function for the _RGB_ channels.
2222

23-
Two sub-profiles (``LDR Profile'' and ``HDR Profile'') may be implemented,
23+
Two sub-profiles ("`LDR Profile`" and "`HDR Profile`") may be implemented,
2424
which support only 2D images at low or high dynamic range respectively.
2525

2626
ASTC textures may be encoded as 1, 2, 3 or 4 components, but they are
@@ -42,7 +42,7 @@ The design goals for the format are as follows:
4242
rates, leaving content developers with only coarse control over
4343
the size/quality tradeoff.
4444
* Scalable and long-lived. The format should support existing _R_, _RG_,
45-
_RGB_ and _RGBA_ image types, and also have high ``headroom'', allowing
45+
_RGB_ and _RGBA_ image types, and also have high "`headroom`", allowing
4646
continuing use for several years and the ability to innovate in
4747
encoders. Part of this is the choice to include HDR and 3D.
4848
* Feature orthogonality. The choices for the various features of the
@@ -67,10 +67,10 @@ is divided into a number of blocks of uniform size, which makes it
6767
possible to quickly determine which block a given texel resides in.
6868

6969
Each block has a fixed memory footprint of 128 bits, but these bits
70-
can represent varying numbers of texels (the block ``footprint'').
70+
can represent varying numbers of texels (the block "`footprint`").
7171

72-
NOTE: The term ``block footprint'' in ASTC refers to the same concept
73-
as ``compressed texel block dimensions'' elsewhere in the Data Format
72+
NOTE: The term "`block footprint`" in ASTC refers to the same concept
73+
as "`compressed texel block dimensions`" elsewhere in the Data Format
7474
Specification.
7575

7676
Block footprint sizes are not confined to powers-of-two, and are
@@ -87,7 +87,7 @@ simplifies cache design, reduces bandwidth and improves encoder throughput.
8787
To understand how the blocks are stored and decoded, it is useful to start
8888
with a simple example, and then introduce additional features.
8989

90-
The simplest block encoding starts by defining two color ``endpoints''. The
90+
The simplest block encoding starts by defining two color "`endpoints`". The
9191
endpoints define two colors, and a number of additional colors are generated
9292
by interpolating between them. We can define these colors using 1, 2, 3,
9393
or 4 components (usually corresponding to _R_, _RG_, _RGB_ and _RGBA_ textures),
@@ -116,7 +116,7 @@ For blocks which have a mixture of disparate colors, a single line in the
116116
color space is not a good fit to the colors of the pixels in the original
117117
image. It is therefore possible to partition the texels into multiple sets,
118118
the pixels within each set having similar colors. For each of these
119-
``partitions'', we specify separate endpoint pairs, and choose which pair of
119+
"`partitions`", we specify separate endpoint pairs, and choose which pair of
120120
endpoints to use for a particular texel by looking up the partition index
121121
from a partitioning pattern table. In ASTC, this partition table is actually
122122
implemented as a function.
@@ -126,7 +126,7 @@ The endpoint encoding for each partition is independent.
126126
For blocks which have uncorrelated channels -- for example an image with a
127127
transparency mask, or an image used as a normal map -- it may be necessary
128128
to specify two weights for each texel. Interpolation between the components
129-
of the endpoint colors can then proceed independently for each ``plane'' of
129+
of the endpoint colors can then proceed independently for each "`plane`" of
130130
the image. The assignment of channels to planes is selectable.
131131

132132
Since each of the above options is independent, it is possible to specify any
@@ -140,12 +140,12 @@ which are nevertheless highly amenable to hardware decode.
140140

141141
All of the values used as weights and color endpoint values can be specified
142142
with a variable number of bits. The encoding scheme used allows a fine-grained
143-
tradeoff between weight bits and color endpoint bits using ``integer
144-
sequence encoding''. This can pack adjacent values together, allowing us to
143+
tradeoff between weight bits and color endpoint bits using "`integer
144+
sequence encoding`". This can pack adjacent values together, allowing us to
145145
use fractional numbers of bits per value.
146146

147-
Finally, a block may be just a single color. This is a so-called ``void
148-
extent block'' and has a special coding which also allows it to identify
147+
Finally, a block may be just a single color. This is a so-called "`void
148+
extent block`" and has a special coding which also allows it to identify
149149
nearby regions of single color. This may be used to short-circuit fetching of
150150
what would be identical blocks, and further reduce memory bandwidth.
151151

@@ -297,7 +297,7 @@ For square and nearly-square blocks, this gives the bit rates in
297297
^| 12 ^| 12 ^| 0.89 ^|
298298
|====
299299

300-
The ``Increment'' column indicates the ratio of bit rate against the next
300+
The "`Increment`" column indicates the ratio of bit rate against the next
301301
lower available rate. A consistent value in this column indicates an even
302302
spread of bit rates.
303303

@@ -396,13 +396,13 @@ Each block has the same basic layout, shown in <<astc-block-layout>>.
396396
3+| {nbsp} Extra 2+| {nbsp} Part 11+| {nbsp} Block mode
397397
|====
398398

399-
Since the size of the ``texel weight data'' field is variable, the
400-
positions shown for the ``more config data'' field and ``color endpoint
401-
data'' field are only representative and not fixed.
399+
Since the size of the "`texel weight data`" field is variable, the
400+
positions shown for the "`more config data`" field and "`color endpoint
401+
data`" field are only representative and not fixed.
402402

403-
The ``Block mode'' field specifies how the Texel Weight Data is encoded.
403+
The "`Block mode`" field specifies how the Texel Weight Data is encoded.
404404

405-
The ``Part'' field specifies the number of partitions, minus one. If dual
405+
The "`Part`" field specifies the number of partitions, minus one. If dual
406406
plane mode is enabled, the number of partitions must be 3 or fewer.
407407
If 4 partitions are specified, the error value is returned for all
408408
texels in the block.
@@ -446,7 +446,7 @@ weight data.
446446
If dual-plane mode is active, the color component selector bits then appear
447447
directly below the additional CEM bits.
448448

449-
The final special case is that if bits [8..0] of the block are ``111111100'',
449+
The final special case is that if bits [8..0] of the block are "`111111100`",
450450
then the block is a void-extent block, which has a separate encoding
451451
described in <<astc-void-extent-blocks>>.
452452

@@ -650,7 +650,7 @@ value in a sequence (e.g. a color weight) is constrained.
650650

651651
Since it is often the case that the most efficient range for these
652652
values is not a power of two, each value sequence is encoded using a
653-
technique known as ``integer sequence encoding''. This allows efficient,
653+
technique known as "`integer sequence encoding`". This allows efficient,
654654
hardware-friendly packing and unpacking of values with non-power-of-two
655655
ranges.
656656

@@ -664,8 +664,8 @@ in one of the forms shown in <<astc-range-forms>> and
664664
|====
665665
| {nbsp} Value range | {nbsp} MSB encoding | {nbsp} LSB encoding
666666
| {nbsp} latexmath:[0 \dots 2^n-1] | {nbsp} - | {nbsp} _n_-bit value _m_ (_n_ {leq} 8)
667-
| {nbsp} latexmath:[0 \dots (3 \times 2^n)-1] | {nbsp} Base-3 ``trit'' value _t_ | {nbsp} _n_-bit value _m_ (_n_ {leq} 6)
668-
| {nbsp} latexmath:[0 \dots (5 \times 2^n)-1] | {nbsp} Base-5 ``quint'' value _q_ | {nbsp} _n_-bit value _m_ (_n_ {leq} 5)
667+
| {nbsp} latexmath:[0 \dots (3 \times 2^n)-1] | {nbsp} Base-3 "`trit`" value _t_ | {nbsp} _n_-bit value _m_ (_n_ {leq} 6)
668+
| {nbsp} latexmath:[0 \dots (5 \times 2^n)-1] | {nbsp} Base-5 "`quint`" value _q_ | {nbsp} _n_-bit value _m_ (_n_ {leq} 5)
669669
|====
670670

671671
[[astc-range-encodings]]

‎chapters/bptc.adoc‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
// Copyright 2014-2024 The Khronos Group Inc.
1+
// Copyright 2014-2026 The Khronos Group Inc.
22
// SPDX-License-Identifier: CC-BY-4.0
33

44
[[BPTC]]
55
== BPTC Compressed Texture Image Formats
66

7-
_This description is derived from the ``BPTC Compressed Texture Image Formats''
7+
_This description is derived from the "`BPTC Compressed Texture Image Formats`"
88
section of the OpenGL 4.4 specification._
99
More information on
1010
link:https://docs.microsoft.com/en-us/windows/desktop/direct3d11/bc7-format[BC7],
@@ -1084,7 +1084,7 @@ The resultant bit pattern should be interpreted as a 16-bit half float.
10841084

10851085
[NOTE]
10861086
====
1087-
The ability to support latexmath:[-\infty] is considered ``accidental''
1087+
The ability to support latexmath:[-\infty] is considered "`accidental`"
10881088
due to the asymmetry of two's complement representation: in order to
10891089
map integer 0x7FFF to 65504.0 and 0x0000 to 0.0, -0x7FFF maps to the
10901090
largest finite negative value, -65504.0, represented as 0xFBFF.

‎chapters/colormodels.adoc‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -24,16 +24,16 @@ _YUV_.
2424

2525
In the broadcast standards which define these models:
2626

27-
* A prime mark ({prime}) is used to refer to the ``gamma
28-
pre-corrected'' version of a value. That is, an approximation to a
27+
* A prime mark ({prime}) is used to refer to the "`gamma
28+
pre-corrected`" version of a value. That is, an approximation to a
2929
perceptually linear mapping between value and intensity. The absence
3030
of a prime mark indicates that the value is linear in intensity.
3131
* _R{prime}G{prime}B{prime}_ is used to refer to the red, green and blue
32-
reference values in ``gamma pre-corrected'' form.
32+
reference values in "`gamma pre-corrected`" form.
3333
That is, _R{prime}_, _G{prime}_ and _B{prime}_ have a non-linear transfer
3434
function, whereas _R_, _G_ and _B_ are linear with respect to light
3535
intensity.
36-
The transfer function used resembles an exponentiation ``gamma correction''
36+
The transfer function used resembles an exponentiation "`gamma correction`"
3737
operation, with a linear segment near zero for mathematical stability.
3838
See <<TRANSFER_ITU>> for details of the transfer function typically used
3939
in these cases.
@@ -58,7 +58,7 @@ In the broadcast standards which define these models:
5858
and _B{prime}_ values, and represents non-physically-linear
5959
(but perceptually-linear) light intensity, as distinct from
6060
physically-linear light intensity.
61-
Note that the ITU broadcast standards use ``luminance'' for
61+
Note that the ITU broadcast standards use "`luminance`" for
6262
_Y{prime}_ despite some authorities reserving that term for a
6363
linear intensity representation.
6464
Since this is a weighted sum of non-linear values, latexmath:[Y'] is
@@ -68,7 +68,7 @@ In the broadcast standards which define these models:
6868
The prime symbol is often omitted so that _Y{prime}_ is confusingly
6969
written _Y_.
7070
<<bt601,BT.601>> and <<bt709,BT.709>> refers to the continuous non-linear
71-
``luminance'' signal as latexmath:[E'_Y]; in <<bt2020,BT.2020>> and
71+
"`luminance`" signal as latexmath:[E'_Y]; in <<bt2020,BT.2020>> and
7272
<<bt2100,BT.2100>> this value is just _Y{prime}_.
7373
The quantized digital representation is written as simply _Y{prime}_
7474
in <<bt601,BT.601>>, as latexmath:[D'_Y] in <<bt709,BT.709>>, and as
@@ -416,7 +416,7 @@ For the inverse conversion:
416416
[[MODEL_YCCBCCRC]]
417417
=== _Y{prime}~C~C{prime}~BC~C{prime}~CR~_ constant luminance color model
418418

419-
<<bt2020,ITU-T Rec. BT.2020>> introduced a ``constant luminance''
419+
<<bt2020,ITU-T Rec. BT.2020>> introduced a "`constant luminance`"
420420
color representation as an alternative representation to
421421
_Y{prime}C~B~C~R~_:
422422

@@ -469,7 +469,7 @@ case, which is a simple matrix transform.
469469
[[MODEL_ICTCP]]
470470
=== _IC~T~C~P~_ constant intensity color model
471471

472-
<<bt2100,ITU-T Rec. BT.2100>> introduced a ``constant intensity''
472+
<<bt2100,ITU-T Rec. BT.2100>> introduced a "`constant intensity`"
473473
color representation as an alternative representation to
474474
_Y{prime}C~B~C~R~_:
475475

0 commit comments

Comments
 (0)