EXT_texture_norm16
The EXT_texture_norm16
extension is part of the WebGL API and provides a set of new 16-bit signed normalized and unsigned normalized formats (fixed-point texture, renderbuffer and texture buffer).
When this extension is enabled:
- The
WebGLRenderingContext.texImage2D()
andWebGLRenderingContext.texSubImage2D()
methods accept new formats provided by this extension. - The 16-bit normalized fixed-point types
ext.R16_EXT
,ext.RG16_EXT
andext.RGBA16_EXT
become available as color-renderable formats and renderbuffers and be created in these formats.
WebGL extensions are available using the WebGLRenderingContext.getExtension()
method. For more information, see also Using Extensions in the WebGL tutorial.
Availability: This extension is only available to WebGL 2 contexts.
Constants
ext.R16_EXT
- Red 16-bit unsigned format. Color-renderable.
ext.RG16_EXT
- RG 16-bit unsigned format. Color-renderable.
ext.RGB16_EXT
- RGB 16-bit unsigned format.
ext.RGBA16_EXT
- RGBA 16-bit unsigned format. Color-renderable.
ext.R16_SNORM_EXT
- Red 16-bit signed normalized format.
ext.RG16_SNORM__EXT
- RG 16-bit signed normalized format.
ext.RGB16_SNORM__EXT
- RGB 16-bit signed normalized format.
ext.RGBA16_SNORM__EXT
- RGBA 16-bit signed normalized format.
Examples
Enabling the extension
let ext = gl.getExtension('EXT_texture_norm16');
Texture formats
The WebGLRenderingContext.texImage2D()
method accepts new formats when EXT_texture_norm16
is enabled. Example calls:
// imageData = Uint16Array
gl.texImage2D(gl.TEXTURE_2D, 0, ext.R16_EXT, 1, 1, 0, gl.RED, gl.UNSIGNED_SHORT, imageData);
gl.texImage2D(gl.TEXTURE_2D, 0, ext.RG16_EXT, 1, 1, 0, gl.RG, gl.UNSIGNED_SHORT, imageData);
gl.texImage2D(gl.TEXTURE_2D, 0, ext.RGB16_EXT, 1, 1, 0, gl.RGB, gl.UNSIGNED_SHORT, imageData);
gl.texImage2D(gl.TEXTURE_2D, 0, ext.RGBA16_EXT, 1, 1, 0, gl.RGBA, gl.UNSIGNED_SHORT, imageData);
// imageData = Int16Array
gl.texImage2D(gl.TEXTURE_2D, 0, ext.R16_SNORM_EXT, 1, 1, 0, gl.RED, gl.SHORT, imageData);
gl.texImage2D(gl.TEXTURE_2D, 0, ext.RG16_SNORM_EXT, 1, 1, 0, gl.RG, gl.SHORT, imageData);
gl.texImage2D(gl.TEXTURE_2D, 0, ext.RGB16_SNORM_EXT, 1, 1, 0, gl.RGB, gl.SHORT, imageData);
gl.texImage2D(gl.TEXTURE_2D, 0, ext.RGBA16_SNORM_EXT, 1, 1, 0, gl.RGBA, gl.SHORT, imageData);
Renderbuffer formats
The WebGLRenderingContext.renderbufferStorage()
method accepts ext.R16_EXT
,
ext.RG16_EXT
and ext.RGBA16_EXT
as internal formats to create renderbuffers in these formats. Example calls:
gl.renderbufferStorage(gl.RENDERBUFFER, ext.R16_EXT, 1, 1);
gl.renderbufferStorage(gl.RENDERBUFFER, ext.RG16_EXT, 1, 1);
gl.renderbufferStorage(gl.RENDERBUFFER, ext.RGBA16_EXT, 1, 1);
Specifications
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.