EXT_texture_norm16 extension
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("WebGL")}}{{AvailableInWorkers}}
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 {{domxref("WebGLRenderingContext.texImage2D()")}} and {{domxref("WebGLRenderingContext.texSubImage2D()")}} methods accept new formats provided by this extension.
- The 16-bit normalized fixed-point types
ext.R16_EXT,ext.RG16_EXTandext.RGBA16_EXTbecome available as color-renderable formats and renderbuffers and be created in these formats.
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see Using WebGL extensions.
توجه: This extension is only available to {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} 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 {{domxref("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 {{domxref("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
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("WebGLRenderingContext.getExtension()")}}
- {{domxref("WebGLRenderingContext.texImage2D()")}}
- {{domxref("WebGLRenderingContext.renderbufferStorage()")}}