The OES_texture_half_float
extension is part of the WebGL API and adds texture formats with 16- (aka half float) and 32-bit floating-point components.
WebGL extensions are available using the WebGLRenderingContext.getExtension()
method. For more information, see also Using Extensions in the WebGL tutorial.
Constants
ext.HALF_FLOAT_OES
- Half floating-point type (16-bit).
Extended methods
This extension extends WebGLRenderingContext.texImage2D()
and WebGLRenderingContext.texSubImage2D()
:
- The
type
parameter now acceptsext.HALF_FLOAT_OES
.
Limitation: Linear filtering
Linear filtering on half floating-point textures is not allowed with this extension. If you set the magnification or minification filter in the WebGLRenderingContext.texParameter()
method to one of gl.LINEAR
, gl.LINEAR_MIPMAP_NEAREST
, gl.NEAREST_MIPMAP_LINEAR
, or gl.LINEAR_MIPMAP_LINEAR
, and use half floating-point textures, the texture will be marked as incomplete.
To use linear filtering on half floating-point textures, enable the OES_texture_half_float_linear
extension in addition to this extension.
Half floating-point color buffers
This extension implicitly enables the EXT_color_buffer_half_float
extension (if supported), which allows rendering to 16-bit floating point formats.
Examples
var ext = gl.getExtension('OES_texture_half_float');
var texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, ext.HALF_FLOAT_OES, image);
Specifications
Specification | Status | Comment |
---|---|---|
OES_texture_half_float The definition of 'OES_texture_half_float' in that specification. |
Recommendation | Initial definition. |
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.