Skip to content

Clarified WebGL-specific dimensions restrictions for RGTC and BPTC #3111

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.

Sign up for GitHub

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
kdashg merged 1 commit into from
Jul 7, 2020
Merged

Clarified WebGL-specific dimensions restrictions for RGTC and BPTC #3111

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
27 changes: 27 additions & 0 deletions extensions/EXT_texture_compression_bptc/extension.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,9 @@
<p>
Unlike the OpenGL ES extension, this WebGL extension does not extend <code>texImage2D</code> entry point.
</p>
<p>
For compatibility reasons, the width and the height of the top level mip map are required to be a multiple of 4.
</p>
<features>
<feature>
Compression format <code>COMPRESSED_RGBA_BPTC_UNORM_EXT</code>,
Expand All @@ -53,6 +56,22 @@
</code></blockquote>
<p>If it is not, an <code>INVALID_VALUE</code> error is generated.</p>
</feature>
<feature>
<p>The following format-specific restrictions must be enforced:</p>
<dl>
<dt>COMPRESSED_RGBA_BPTC_UNORM_EXT</dt>
<dt>COMPRESSED_SRGB_ALPHA_BPTC_UNORM_EXT</dt>
<dt>COMPRESSED_RGB_BPTC_SIGNED_FLOAT_EXT</dt>
<dt>COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_EXT</dt>
<dd>
<p>When <code>level</code> equals zero <code>width</code> and <code>height</code>
must be a multiple of 4.</p>
<p>
If they are not an <code>INVALID_OPERATION</code> error is generated.
</p>
</dd>
</dl>
</feature>
</features>
</overview>
<idl xml:space="preserve">
Expand Down Expand Up @@ -96,6 +115,11 @@ interface EXT_texture_compression_bptc {
ceil(width / 4) * ceil(height / 4) * 16
</code></blockquote>
</error>
<error enum="INVALID_OPERATION">
The error <code>INVALID_OPERATION</code> is generated by <code>compressedTexImage2D</code> and
<code>compressedTexSubImage2D</code> if the <code>level</code> parameter is
<code>0</code> and the <code>width</code> or <code>height</code> is not a multiple of 4.
</error>
</errors>

<history>
Expand All @@ -115,5 +139,8 @@ interface EXT_texture_compression_bptc {
<revision date="2020/06/25">
<change>Clarified <code>texImage2D</code> entry point.</change>
</revision>
<revision date="2020/07/07">
<change>Clarified WebGL-specific dimensions restriction.</change>
</revision>
</history>
</extension>
21 changes: 21 additions & 0 deletions extensions/EXT_texture_compression_rgtc/extension.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,9 @@
<p>
Unlike the OpenGL ES extension, this WebGL extension does not extend <code>texImage2D</code> entry point.
</p>
<p>
For compatibility reasons, the width and the height of the top level mip map are required to be a multiple of 4.
</p>
<features>
<feature>
Compression formats <code>COMPRESSED_RED_RGTC1_EXT</code>,
Expand All @@ -51,6 +54,11 @@
ceil(width / 4) * ceil(height / 4) * 8
</code></blockquote>
<p>If it is not, an <code>INVALID_VALUE</code> error is generated.</p>
<p>When <code>level</code> equals zero <code>width</code> and <code>height</code>
must be a multiple of 4.</p>
<p>
If they are not an <code>INVALID_OPERATION</code> error is generated.
</p>
</dd>
<dt>COMPRESSED_RED_GREEN_RGTC2_EXT</dt>
<dt>COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT</dt>
Expand All @@ -60,6 +68,11 @@
ceil(width / 4) * ceil(height / 4) * 16
</code></blockquote>
<p>If it is not, an <code>INVALID_VALUE</code> error is generated.</p>
<p>When <code>level</code> equals zero <code>width</code> and <code>height</code>
must be a multiple of 4.</p>
<p>
If they are not an <code>INVALID_OPERATION</code> error is generated.
</p>
</dd>
</dl>
</feature>
Expand Down Expand Up @@ -116,6 +129,11 @@ interface EXT_texture_compression_rgtc {
ceil(width / 4) * ceil(height / 4) * 16
</code></blockquote>
</error>
<error enum="INVALID_OPERATION">
The error <code>INVALID_OPERATION</code> is generated by <code>compressedTexImage2D</code> and
<code>compressedTexSubImage2D</code> if the <code>level</code> parameter is
<code>0</code> and the <code>width</code> or <code>height</code> is not a multiple of 4.
</error>
</errors>

<history>
Expand All @@ -131,5 +149,8 @@ interface EXT_texture_compression_rgtc {
<revision date="2020/06/25">
<change>Clarified <code>texImage2D</code> entry point.</change>
</revision>
<revision date="2020/07/07">
<change>Clarified WebGL-specific dimensions restriction.</change>
</revision>
</history>
</extension>