The getSubImage() method of the XRWebGLBinding interface returns a XRWebGLSubImage object representing the WebGL texture to render.


getSubImage(layer, frame)
getSubImage(layer, frame, eye)



The XRCompositionLayer to use for rendering (can be all types of XRCompositionLayer objects except XRProjectionLayer, see XRWebGLBinding.getViewSubImage() for rendering projection layers).


The XRFrame frame to use for rendering.

eye Optional

An optional XRView.eye indicating which view's eye to use for rendering. Possible values:

  • left: The XRView represents the point-of-view of the viewer's left eye.
  • right: The view represents the viewer's right eye.
  • none: The view describes a monoscopic view, or the view otherwise doesn't represent a particular eye's point-of-view.

Defaults to none.

Return value

A XRWebGLSubImage object.


A TypeError is thrown,


Rendering an XRQuadLayer

The following example renders an XRQuadLayer.

const xrGlBinding = new XRWebGLBinding(xrSession, gl);
const quadLayer = xrGlBinding.createQuadLayer({
  space: xrReferenceSpace,
  viewPixelWidth: 512,
  viewPixelHeight: 512

// Position 2 meters away from the origin with a width and height of 1.5 meters
quadLayer.transform = new XRRigidTransform({z: -2});
quadLayer.width = 1.5;
quadLayer.height = 1.5;

const framebuffer = gl.createFramebuffer();
xrSession.updateRenderState({ layers: [quadLayer] });

function onXRFrame(time, xrFrame) {

  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
  let subImage = xrGlBinding.getSubImage(quadLayer, xrFrame);
  gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, subImage.colorTexture, 0);
  let viewport = subImage.viewport;
  gl.viewport(viewport.x, viewport.y, viewport.width, viewport.height);

  // Render content for the quad layer


No specification found

No specification data found for api.XRWebGLBinding.getSubImage.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

No compatibility data found for api.XRWebGLBinding.getSubImage.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

See also