W3cubDocs

/DOM

WEBGL depth texture

The WEBGL_depth_texture extension is part of the WebGL API and defines 2D depth and depth-stencil textures.

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 WebGL1 contexts. In WebGL2, the functionality of this extension is available on the WebGL2 context by default. The constant in WebGL2 is gl.UNSIGNED_INT_24_8.

Constants

This extension adds a new constant:

ext.UNSIGNED_INT_24_8_WEBGL
Unsigned integer type for 24-bit depth texture data.

Extended methods

This extension extends WebGLRenderingContext.texImage2D():

  • The format and internalformat parameters now accept gl.DEPTH_COMPONENT and gl.DEPTH_STENCIL.
  • The type parameter now accepts gl.UNSIGNED_SHORT, gl.UNSIGNED_INT, and ext.UNSIGNED_INT_24_8_WEBGL.
  • The pixels parameter now accepts an ArrayBufferView of type Uint16Array and Uint32Array.

This extension extends WebGLRenderingContext.framebufferTexture2D():

  • The target parameter now accepts gl.DEPTH_ATTACHMENT and gl.DEPTH_STENCIL_ATTACHMENT.

Examples

var ext = gl.getExtension('WEBGL_depth_texture');

gl.texImage2D(gl.TEXTURE_2D, 0, gl.DEPTH_COMPONENT, 512, 512, 0, gl.DEPTH_COMPONENT, gl.UNSIGNED_SHORT, null);

Specifications

Specification Status Comment
WEBGL_depth_texture
The definition of 'WEBGL_depth_texture' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Edge Firefox Internet Explorer Opera Safari Servo
Basic Support ? ? 22.01 ? ? ? ?
Feature Android Chrome for Android Edge Mobile Firefox for Android IE Mobile Opera Mobile Safari Mobile
Basic Support ? ? ? ? ? ? ?

1. This extension was prefixed with MOZ_ in prior versions.

See also

© 2005–2017 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WEBGL_depth_texture