Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The read-only depthStencilTexture property of the XRWebGLSubImage interface represents the depth/stencil WebGLTexture object for the XRCompositionLayer to render.


An opaque WebGLTexture. See WebXR opaque textures for details.

Using depthStencilTexture

The depthStencilTexture property can be passed to WebGL2RenderingContext.framebufferTextureLayer() to attach the depth texture to a framebuffer.

const xrGlBinding = new XRWebGLBinding(xrSession, gl);
const layer = xrGlBinding.createProjectionLayer({ textureType: "texture-array" });
const framebuffer = gl.createFramebuffer();

xrSession.updateRenderState({ layers: [layer] });

function onXRFrame(time, xrFrame) {

  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
  const viewport = xrGlBinding.getSubImage(layer, xrFrame).viewport;
  gl.viewport(viewport.x, viewport.y, viewport.width, viewport.height);

  for (const view in xrViewerPose.views) {
    const subImage = xrGlBinding.getViewSubImage(layer, view);
    gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0,
      subImage.colorTexture, 0, subImage.imageIndex);
    gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT,
      subImage.depthStencilTexture, 0, subImage.imageIndex);

    // Render from the viewpoint of xrView


WebXR Layers API Level 1
# dom-xrwebglsubimage-depthstenciltexture

Browser compatibility

BCD tables only load in the browser

See also