type: method; text: getFramebufferAttachmentParameter; url: 5.14.6

type: method; text: getRenderbufferParameter; url: 5.14.7

type: method; text: checkFramebufferStatus; url: 5.14.6

type: dfn; text: Create the WebGL context; url:#2.1

type: dfn; text: WebGL viewport; url:#5.14.4

type: dfn; text: WebGL context lost flag; url:#webgl-context-lost-flag

type: dfn; text: handle the context loss; url:#CONTEXT_LOST

type: dfn; text: Restore the context; url: #restore-the-drawing-buffer

urlPrefix: https://www.khronos.org/registry/webgl/specs/latest/2.0/

type: interface; text: WebGL2RenderingContext; url: WebGL2RenderingContext

urlPrefix: https://w3c.github.io/orientation-sensor/; spec: ORIENTATION-SENSOR

1. If |newState|'s {{XRRenderStateInit/depthFar}} value is set, set |activeState|'s {{XRRenderState/depthFar}} to |newState|'s {{XRRenderStateInit/depthFar}}.

1. If |newState|'s {{XRRenderStateInit/inlineVerticalFieldOfView}} is set, set |activeState|'s {{XRRenderState/inlineVerticalFieldOfView}} to |newState|'s {{XRRenderStateInit/inlineVerticalFieldOfView}}.

1. If |newState|'s {{XRRenderStateInit/baseLayer}} is set, set |activeState|'s {{XRRenderState/baseLayer}} to |newState|'s {{XRRenderStateInit/baseLayer}}.

1. If |activeState|'s {{XRRenderState/inlineVerticalFieldOfView}} is less than |session|'s [=minimum inline field of view=] set |activeState|'s {{XRRenderState/inlineVerticalFieldOfView}} to |session|'s [=minimum inline field of view=].

1. If |activeState|'s {{XRRenderState/inlineVerticalFieldOfView}} is greater than |session|'s [=maximum inline field of view=] set |activeState|'s {{XRRenderState/inlineVerticalFieldOfView}} to |session|'s [=maximum inline field of view=].

NOTE: Most Virtual Reality devices exhibit {{XREnvironmentBlendMode/opaque}} blending behavior. Augmented Reality devices that use transparent optical elements frequently exhibit {{XREnvironmentBlendMode/additive}} blending behavior, and Augmented Reality devices that use passthrough cameras frequently exhibit {{XREnvironmentBlendMode/alpha-blend}} blending behavior.

The <dfn attribute for="XRSession">onblur</dfn> attribute is an [=Event handler IDL attribute=] for the {{blur}} event type.

double depthFar;

double inlineVerticalFieldOfView;

XRLayer? baseLayer;

};

[SecureContext, Exposed=Window] interface XRRenderState {

readonly attribute double depthNear;

readonly attribute double depthFar;

readonly attribute double? inlineVerticalFieldOfView;

readonly attribute XRLayer? baseLayer;

};

1. If |session| is an [=immersive session=], initialize |state|'s {{XRRenderState/inlineVerticalFieldOfView}} to <code>null</code>.

1. Else initialize |state|'s {{XRRenderState/inlineVerticalFieldOfView}} to <code>PI * 0.5</code>.

1. Initialize |state|'s {{XRRenderState/baseLayer}} to <code>null</code>.

The <dfn attribute for="XRRenderState">depthNear</dfn> attribute defines the distance, in meters, of the near clip plane from the viewer. The <dfn attribute for="XRRenderState">depthFar</dfn> attribute defines the distance, in meters, of the far clip plane from the viewer.

{{XRRenderState/depthNear}} and {{XRRenderState/depthFar}} is used in the computation of the {{XRView/projectionMatrix}} of {{XRView}}s and determines how the values of an {{XRWebGLLayer}} depth buffer are interpreted. {{XRRenderState/depthNear}} MAY be greater than {{XRRenderState/depthFar}}.

Animation Frames {#animation-frames}

----------------

1. If |session|'s [=list of pending render states=] is not empty, [=apply pending render states=].

1. If |session|'s {{XRSession/renderState}}'s {{XRRenderState/baseLayer}} is <code>null</code>, abort these steps.

1. Let |callbacks| be a list of the entries in |session|'s [=list of animation frame callback=], in the order in which they were added to the list.

1. Set |session|'s [=list of animation frame callbacks=] to the empty list.

1. Set |frame|'s [=active=] boolean to <code>true</code>.

WebGL2RenderingContext) XRWebGLRenderingContext;

dictionary XRWebGLLayerInit {

boolean antialias = true;

boolean depth = true;

boolean stencil = false;

1. If |context| is lost, throw an {{InvalidStateError}} and abort these steps.

1. If |context|'s [=XR compatible=] boolean is false, throw an {{InvalidStateError}} and abort these steps.

1. Initialize |layer|'s {{XRWebGLLayer/context}} to |context|.

1. Return |layer|.

The <dfn attribute for="XRWebGLLayer">context</dfn> attribute is the {{WebGLRenderingContext}} the {{XRWebGLLayer}} was created with.

- An [=opaque framebuffer=] MAY support antialiasing, even in WebGL 1.0.

- An [=opaque framebuffer=]'s attachments cannot be inspected or changed. Calling {{framebufferTexture2D}}, {{framebufferRenderbuffer}}, {{getFramebufferAttachmentParameter}}, or {{getRenderbufferParameter}} with an [=opaque framebuffer=] MUST generate an {{INVALID_OPERATION}} error.

- An [=opaque framebuffer=] is considered incomplete outside of an {{XRSession/requestAnimationFrame()}} callback. When not in a {{XRSession/requestAnimationFrame()}} callback calls to {{checkFramebufferStatus}} outside of an {{XRSession/requestAnimationFrame()}} callback MUST generate a {{FRAMEBUFFER_UNSUPPORTED}} error and attempts to clear, draw to, or read from the [=opaque framebuffer=] MUST generate an {{INVALID_FRAMEBUFFER_OPERATION}} error.

The <dfn attribute for="XRWebGLLayer">ignoreDepthValues</dfn> attribute, if <code>true</code>, indicates the [=XR Compositor=] MUST NOT make use of values in the depth buffer attachment when rendering. When the attribute is <code>false</code> it indicates that the content of the depth buffer attachment will be used by the [=XR Compositor=] and is expected to be representative of the scene rendered into the layer.

Depth values stored in the buffer are expected to be between <code>0.0</code> and <code>1.0</code>, with <code>0.0</code> representing the distance of {{XRRenderState/depthNear}} and <code>1.0</code> representing the distance of {{XRRenderState/depthFar}}, with intermediate values interpolated linearly. This is the default behavior of WebGL. (See documentation for the <a href="https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glDepthRangef.xml">depthRange function</a> for additional details.))

NOTE: Making the scene's depth buffer available to the compositor allows some platforms to provide quality and comfort improvements such as improved reprojection.

{{getViewport()}} queries the {{XRViewport}} the given {{XRView}} should use when rendering to the layer.

1. Let |session| be the target {{XRSession}}.

1. If |session|'s [=XRSession/mode=] value is not <code>"inline"</code>, set the [=native WebGL framebuffer resolution=] to the resolution required to have a 1:1 ratio between the pixels of a framebuffer large enough to contain all of the session's {{XRView}}s and the physical screen pixels in the area of the display under the highest magnification and abort these steps. If no method exists to determine the native resolution as described, the [=recommended WebGL framebuffer resolution=] MAY be used.

Events {#events}

========