WEBGL_compressed_texture_astc extension

The WEBGL_compressed_texture_astc extension is part of the WebGL API and exposes Adaptive Scalable Texture Compression (ASTC) compressed texture formats to WebGL.

For more information, see the article Using ASTC Texture Compression for Game Assets by NVIDIA.

WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

[!NOTE] ASTC compression is typically available on Mali ARM GPUs, Intel GPUs, and NVIDIA Tegra chips.

This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

Instance methods

This extension exposes one new methods.

{{domxref("WEBGL_compressed_texture_astc.getSupportedProfiles", "ext.getSupportedProfiles()")}}
- : Returns an array of strings containing the names of the ASTC profiles supported by the implementation.

Constants

The compressed texture formats are exposed by 28 constants and can be used in two functions: {{domxref("WebGLRenderingContext.compressedTexImage2D", "compressedTexImage2D()")}} and {{domxref("WebGLRenderingContext.compressedTexSubImage2D", "compressedTexSubImage2D()")}}.

<table class="no-markdown"> <thead> <tr> <th>Constants</th> <th>Blocks</th> <th>Bits per pixel</th> <th>{{jsxref("ArrayBuffer")}} <code>byteLength</code></th> <th>bytes if height and width are 512</th> </tr> </thead> <tbody> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_4x4_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR</code > </td> <td>4x4</td> <td>8.00</td> <td> <code>floor((width + 3) / 4) * floor((height + 3) / 4) * 16</code> </td> <td>262144</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_5x4_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR</code > </td> <td>5x4</td> <td>6.40</td> <td> <code>floor((width + 4) / 5) * floor((height + 3) / 4) * 16</code> </td> <td>210944</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_5x5_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR</code > </td> <td>5x5</td> <td>5.12</td> <td> <code>floor((width + 4) / 5) * floor((height + 4) / 5) * 16</code> </td> <td>169744</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_6x5_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR</code > </td> <td>6x5</td> <td>4.27</td> <td> <code>floor((width + 5) / 6) * floor((height + 4) / 5) * 16</code> </td> <td>141728</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_6x6_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR</code > </td> <td>6x6</td> <td>3.56</td> <td> <code>floor((width + 5) / 6) * floor((height + 5) / 6) * 16</code> </td> <td>118336</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_8x5_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR</code > </td> <td>8x5</td> <td>3.20</td> <td> <code>floor((width + 7) / 8) * floor((height + 4) / 5) * 16</code> </td> <td>105472</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_8x6_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR</code > </td> <td>8x6</td> <td>2.67</td> <td> <code>floor((width + 7) / 8) * floor((height + 5) / 6) * 16</code> </td> <td>88064</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_8x8_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR</code > </td> <td>8x8</td> <td>2.00</td> <td> <code>floor((width + 7) / 8) * floor((height + 7) / 8) * 16</code> </td> <td>65536</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_10x5_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR</code > </td> <td>10x5</td> <td>2.56</td> <td> <code>floor((width + 9) / 10) * floor((height + 4) / 5) * 16</code> </td> <td>85696</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_10x6_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR</code > </td> <td>10x6</td> <td>2.13</td> <td> <code>floor((width + 9) / 10) * floor((height + 5) / 6) * 16</code> </td> <td>71552</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_10x8_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR</code > </td> <td>10x8</td> <td>1.60</td> <td> <code>floor((width + 9) / 10) * floor((height + 7) / 8) * 16</code> </td> <td>53248</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_10x10_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR</code > </td> <td>10x10</td> <td>1.28</td> <td> <code>floor((width + 9) / 10) * floor((height + 9) / 10) * 16</code> </td> <td>43264</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_12x10_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR</code > </td> <td>12x10</td> <td>1.07</td> <td> <code>floor((width + 11) / 12) * floor((height + 9) / 10) * 16</code> </td> <td>35776</td> </tr> <tr> <td> <code >ext.COMPRESSED_RGBA_ASTC_12x12_KHR ext.COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR</code > </td> <td>12x12</td> <td>0.89</td> <td> <code>floor((width + 11) / 12) * floor((height + 11) / 12) * 16</code> </td> <td>29584</td> </tr> </tbody> </table>

Examples

const ext = gl.getExtension("WEBGL_compressed_texture_astc");

const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);

gl.compressedTexImage2D(
  gl.TEXTURE_2D,
  0,
  ext.COMPRESSED_RGBA_ASTC_12x12_KHR,
  512,
  512,
  0,
  textureData,
);

Instance methods

Constants

Examples

Specifications

Browser compatibility

See also