WebXR 层 API 第 1 级

navigator.xr.requestSession('immersive-vr', {
    optionalFeatures: ['layers']
  }

enum XRLayerLayout {
  "default",
  "mono",
  "stereo",
  "stereo-left-right",
  "stereo-top-bottom"
};

enum XRLayerQuality {
  "default",
  "text-optimized",
  "graphics-optimized"
};

[Exposed=Window] interface XRCompositionLayer : XRLayer {
  readonly attribute XRLayerLayout layout;

  attribute boolean blendTextureSourceAlpha;
  attribute boolean forceMonoPresentation;
  attribute float opacity;
  readonly attribute unsigned long mipLevels;
  attribute XRLayerQuality quality;

  readonly attribute boolean needsRedraw;

  undefined destroy();
};

当 XRCompositionLayer layer 的层的底层资源丢失时， 用户代理必须运行以下步骤：

1. 将 layer 的 needsRedraw 设置为 true。

2. 如果 layer 不是 XRProjectionLayer， 则排队一个任务，以便在 layer 上使用 XRLayerEvent 触发 一个事件，该事件名为 redraw。

要使用 XRSession session 和一个可选的 WebGLRenderingContext 或 WebGL2RenderingContext context 实例初始化合成层，用户代理必须运行以下步骤：

1. 将 this session 设置为 session。

2. 如果定义了 context，则将 this context 设置为 context。

3. 将 this blendTextureSourceAlpha 设置为 true。

4. 将 this opacity 设置为 1.0。

调用 destroy() 时，用户代理必须运行以下步骤：

1. 将 this colorTextures 数组设置为空数组。

2. 将 this depthStencilTextures 数组设置为空数组。

3. 销毁底层 GL 附件。

当使用 XRSpace space 和 XRCompositionLayer layer 设置 层上的空间时，用户代理必须运行以下步骤来验证 space 是否 有效：

1. 如果 space 为 null，则抛出 TypeError 并中止这些步骤。

2. 如果 space 的 session 不等于 layer 的 session，则抛出 TypeError 并中止这些步骤。

[Exposed=Window] interface XRProjectionLayer : XRCompositionLayer {
  readonly attribute unsigned long textureWidth;
  readonly attribute unsigned long textureHeight;
  readonly attribute unsigned long textureArrayLength;

  readonly attribute boolean ignoreDepthValues;
  attribute float? fixedFoveation;
  attribute XRRigidTransform? deltaPose;
};

[Exposed=Window] interface XRQuadLayer : XRCompositionLayer {
  attribute XRSpace space;
  attribute XRRigidTransform transform;

  attribute float width;
  attribute float height;

  // Events
  attribute EventHandler onredraw;
};

当使用 XRQuadLayerInit init初始化 XRQuadLayer layer 时，用户代理必须运行以下步骤：

1. 将 layer 的 width 初始化为 init 的 width。

2. 将 layer 的 height 初始化为 init 的 height。

3. 令 layer 的 space 为 init 的 space。

4. 按如下方式初始化 layer 的 transform：

   如果设置了 init 的 transform

   令 layer 的 transform 为在 layer 的相关 Realm 中新建的 XRRigidTransform， 并使用 init 的 transform 的 position 和 orientation 初始化。

   否则

   令 layer 的 transform 为在 layer 的相关 Realm 中新建的 XRRigidTransform， 并使用 DOMPointInit position { x: 0.0, y: 0.0, z: 0.0, w: 1.0 } 初始化。

5. 将 layer 的 isStatic 初始化为 init 的 isStatic

[Exposed=Window] interface XRCylinderLayer : XRCompositionLayer {
  attribute XRSpace space;
  attribute XRRigidTransform transform;

  attribute float radius;
  attribute float centralAngle;
  attribute float aspectRatio;

  // Events
  attribute EventHandler onredraw;
};

当使用 XRCylinderLayerInit init初始化 XRCylinderLayer layer 时，用户代理必须运行以下步骤：

1. 将 layer 的 radius 初始化为 init 的 radius。

2. 将 layer 的 centralAngle 初始化为 init 的 centralAngle。

3. 将 layer 的 aspectRatio 初始化为 init 的 aspectRatio。

4. 令 layer 的 space 为 init 的 space。

5. 按如下方式初始化 layer 的 transform：

   如果设置了 init 的 transform

   令 layer 的 transform 为在 layer 的相关 Realm 中新建的 XRRigidTransform， 并使用 init 的 transform 的 position 和 orientation 初始化。

   否则

   令 layer 的 transform 为在 layer 的相关 Realm 中新建的 XRRigidTransform， 并使用 DOMPointInit position { x: 0.0, y: 0.0, z: 0.0, w: 1.0 } 初始化。

6. 将 layer 的 isStatic 初始化为 init 的 isStatic

[Exposed=Window] interface XREquirectLayer : XRCompositionLayer {
  attribute XRSpace space;
  attribute XRRigidTransform transform;

  attribute float radius;
  attribute float centralHorizontalAngle;
  attribute float upperVerticalAngle;
  attribute float lowerVerticalAngle;

  // Events
  attribute EventHandler onredraw;
};

当使用 XRSpace space 和 XREquirectLayer layer 设置等矩形层上的空间时，用户代理必须运行以下步骤来验证 space 是否 有效：

1. 如果 init 的 space 不是 XRReferenceSpace 类型的实例， 则抛出 TypeError 并中止这些步骤。

2. 如果 init 的 space 具有 "viewer" 的type， 则抛出 TypeError 并中止这些步骤。

3. 使用 space 和 layer 运行设置层上的空间。

当使用 XREquirectLayerInit init初始化 XREquirectLayer layer 时，用户代理必须运行以下步骤：

1. 将 layer 的 radius 初始化为 init 的 radius。

2. 将 layer 的 centralHorizontalAngle 初始化为 init 的 centralHorizontalAngle。

3. 将 layer 的 upperVerticalAngle 初始化为 init 的 upperVerticalAngle。

4. 将 layer 的 lowerVerticalAngle 初始化为 init 的 lowerVerticalAngle。

5. 令 layer 的 space 为 init 的 space。

6. 按如下方式初始化 layer 的 transform：

   如果设置了 init 的 transform

   令 layer 的 transform 为在 layer 的相关 Realm 中新建的 XRRigidTransform， 并使用 init 的 transform 的 position 和 orientation 初始化。

   否则

   令 layer 的 transform 为在 layer 的相关 Realm 中新建的 XRRigidTransform。

7. 将 layer 的 isStatic 初始化为 init 的 isStatic

[Exposed=Window] interface XRCubeLayer : XRCompositionLayer {
  attribute XRSpace space;
  attribute DOMPointReadOnly orientation;

  // Events
  attribute EventHandler onredraw;
};

当使用 XRSpace space 和 XRCubeLayer layer 设置立方体层上的空间时，用户代理必须运行以下步骤来验证 space 是否 有效：

1. 如果 init 的 space 不是 XRReferenceSpace 类型的实例， 则抛出 TypeError 并中止这些步骤。

2. 如果 init 的 space 具有 "viewer" 的type， 则抛出 TypeError 并中止这些步骤。

3. 使用 space 和 layer 运行设置层上的空间。

[Exposed=Window] interface XRSubImage {
  [SameObject] readonly attribute XRViewport viewport;
};

[Exposed=Window] interface XRWebGLSubImage : XRSubImage {
  [SameObject] readonly attribute WebGLTexture colorTexture;
  [SameObject] readonly attribute WebGLTexture? depthStencilTexture;
  [SameObject] readonly attribute WebGLTexture? motionVectorTexture;

  readonly attribute unsigned long? imageIndex;
  readonly attribute unsigned long colorTextureWidth;
  readonly attribute unsigned long colorTextureHeight;
  readonly attribute unsigned long? depthStencilTextureWidth;
  readonly attribute unsigned long? depthStencilTextureHeight;
  readonly attribute unsigned long? motionVectorTextureWidth;
  readonly attribute unsigned long? motionVectorTextureHeight;
};

enum XRTextureType {
  "texture",
  "texture-array"
};

dictionary XRProjectionLayerInit {
  XRTextureType textureType = "texture";
  GLenum colorFormat = 0x1908; // RGBA
  GLenum depthFormat = 0x1902; // DEPTH_COMPONENT
  double scaleFactor = 1.0;
  boolean clearOnAccess = true;
};

dictionary XRLayerInit {
  required XRSpace space;
  XRTextureType textureType = "texture";
  GLenum colorFormat = 0x1908; // RGBA
  GLenum? depthFormat;
  unsigned long mipLevels = 1;
  required unsigned long viewPixelWidth;
  required unsigned long viewPixelHeight;
  XRLayerLayout layout = "mono";
  boolean isStatic = false;
  boolean clearOnAccess = true;
};

dictionary XRQuadLayerInit : XRLayerInit {
  XRRigidTransform? transform;
  float width = 1.0;
  float height = 1.0;
};

dictionary XRCylinderLayerInit : XRLayerInit {
  XRRigidTransform? transform;
  float radius = 2.0;
  float centralAngle = 0.78539;
  float aspectRatio = 2.0;
};

dictionary XREquirectLayerInit : XRLayerInit {
  XRRigidTransform? transform;
  float radius = 0;
  float centralHorizontalAngle = 6.28318;
  float upperVerticalAngle = 1.570795;
  float lowerVerticalAngle = -1.570795;
};

dictionary XRCubeLayerInit : XRLayerInit {
  DOMPointReadOnly? orientation;
};

[Exposed=Window] interface XRWebGLBinding {
  constructor(XRSession session, XRWebGLRenderingContext context);

  readonly attribute double nativeProjectionScaleFactor;
  readonly attribute boolean usesDepthValues;

  XRProjectionLayer createProjectionLayer(optional XRProjectionLayerInit init = {});
  XRQuadLayer createQuadLayer(optional XRQuadLayerInit init = {});
  XRCylinderLayer createCylinderLayer(optional XRCylinderLayerInit init = {});
  XREquirectLayer createEquirectLayer(optional XREquirectLayerInit init = {});
  XRCubeLayer createCubeLayer(optional XRCubeLayerInit init = {});

  XRWebGLSubImage getSubImage(XRCompositionLayer layer, XRFrame frame, optional XREye eye = "none");
  XRWebGLSubImage getViewSubImage(XRProjectionLayer layer, XRView view);

  undefined foveateBoundTexture(GLenum target, float fixed_foveation);
};

XRWebGLBinding(session, context) 构造函数在被调用时必须执行以下步骤：

1. 令 binding 为在 session 的相关 Realm 中新建的 XRWebGLBinding。

2. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

3. 如果 context 已丢失，则抛出 InvalidStateError 并中止这些步骤。

4. 如果 session 不是沉浸式会话，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 context 的 XR compatible 布尔值为 false，则抛出 InvalidStateError 并中止这些步骤。

6. 将 binding 的 context 初始化为 context。

7. 将 binding 的 session 初始化为 session。

8. 将 binding 添加到 session 的 bindings。

9. 返回 binding。

要使用 XRTextureType textureType、XRWebGLRenderingContext context 和 XRLayerLayout layout 确定 layout 属性，用户代理必须运行以下步骤：

1. 如果 context 不是 WebGL2RenderingContext， 且 textureType 为 "texture-array"， 则抛出 TypeError 并中止这些步骤。

2. 如果 textureType 为 "texture-array"， 且会话视图列表中的所有视图并非都具有相同的推荐 WebGL 颜色纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

3. 如果 layout 为 "mono"， 返回 layout 并中止这些步骤。

4. 如果 layout 为 "default"， 则运行以下步骤：

   1. 如果视图列表的大小为 1，则返回 "mono" 并中止这些步骤。

   2. 如果 textureType 为 "texture-array"， 返回 layout 并中止这些步骤。

5. 如果 layout 为 "default" 或 "stereo"， 且 textureType 为 "texture"， 则运行以下步骤：

   1. 如果用户代理偏好 "stereo-left-right" 布局，则返回 "stereo-left-right" 并中止这些步骤。

   2. 如果用户代理偏好 "stereo-top-bottom" 布局，则返回 "stereo-top-bottom" 并中止这些步骤。

6. 返回 layout。

要使用 XRSession session、XRWebGLRenderingContext context 和 XRLayerLayout layout 确定最大 scalefactor，用户代理必须运行以下步骤：

1. 令 largest width 为来自 session 的视图列表中（不包括辅助视图）推荐 WebGL 颜色纹理 分辨率的最大宽度。

2. 令 largest height 为来自 session 的视图列表中（不包括辅助视图）推荐 WebGL 颜色纹理 分辨率的最大高度。

3. 如果 layout 为 "stereo-left-right" 布局，则将 largest width 乘以 2。

4. 如果 layout 为 "stereo-top-bottom" 布局，则将 largest height 乘以 2。

5. 令 largest view dimension 为 largest width 或 largest height 中较大的那个。

6. 令 largest texture dimension 为由 context 创建的 WebGLTexture 的最大尺寸。

7. 返回 largest texture dimension 除以 largest view dimension。

要使用 XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat 和 float scaleFactor 为投影层分配颜色纹理， 用户代理必须运行以下步骤：

1. 令 array 为在 context 的相关 Realm 中新建的数组。

2. 令 context 为 layer 的 context。

3. 令 session 为 layer 的 session。

4. 令 numViews 为 session 的视图列表中排除辅助视图后的数量。

5. 令 view 为 session 的视图列表中第一个不是辅助视图的条目。

6. 令 width 为 view 的推荐 WebGL 颜色纹理 分辨率的宽度乘以 scaleFactor。

7. 令 height 为 view 的推荐 WebGL 颜色纹理 分辨率的高度乘以 scaleFactor。

8. 如果 textureFormat 不在投影层颜色格式列表中， 则抛出 NotSupportedError 并中止这些步骤。

9. 如果 layer 的 layout 为 "mono" 或 "default"：

   如果 textureType 为 "texture-array"：

   如果会话视图列表中的视图（不包括辅助视图）并非都具有相同的推荐 WebGL 颜色纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

   使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array，该实例创建为一个使用 context、textureFormat、 width 和 height、具有 numViews 层的 TEXTURE_2D_ARRAY 纹理。

   如果出于任何原因无法创建该不透明 纹理，则抛出 OperationError 并中止这些步骤。

   返回 array 并中止这些步骤。

   否则

   对 session 的视图列表中的每个 view：

   1. 如果 view 是辅助视图，则继续。

   2. 令 width 为 view 的推荐 WebGL 颜色纹理分辨率的宽度乘以 scaleFactor。

   3. 令 height 为 view 的推荐 WebGL 颜色纹理分辨率的高度乘以 scaleFactor。

   4. 令 texture 为在 context 的相关 Realm 中新建 的不透明纹理实例，该实例创建为一个 使用 context、textureFormat、width 和 height 的 TEXTURE_2D 纹理。

   5. 如果出于任何原因无法创建 texture，则抛出 OperationError 并中止这些步骤。

   6. 将 texture 追加到 array。

   返回 array 并中止这些步骤。

10. 如果会话视图列表中的视图（不包括辅助 视图）并非都具有相同的推荐 WebGL 颜色纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

11. 如果 layer 的 layout 为 stereo-left-right， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context、textureFormat、 numViews 乘以 width 和 height 的 textureType 纹理。

12. 如果 layer 的 layout 为 stereo-top-bottom， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context、textureFormat、 width 和 numViews 乘以 height 的 textureType 纹理。

13. 如果出于任何原因无法创建该不透明 纹理，则抛出 OperationError 并中止这些步骤。

14. 返回 array。

要使用 XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat 和 float scaleFactor 为投影层分配深度纹理， 用户代理必须运行以下步骤：

1. 令 array 为在 context 的相关 Realm 中新建的数组。

2. 令 context 为 layer 的 context。

3. 令 session 为 layer 的 session。

4. 如果 textureFormat 为 0，则返回 array 并中止这些步骤。

5. 如果 context 是 WebGLRenderingContext， 且 WEBGL_depth_texture 扩展未在 context 中启用，则返回 array 并中止这些步骤。

6. 如果 textureFormat 不在投影层深度格式列表中， 则抛出 NotSupportedError 并中止这些步骤。

7. 令 numViews 为 session 的视图列表中排除辅助视图后的数量。

8. 令 view 为 session 的视图列表中第一个不是辅助视图的条目。

9. 令 width 为 view 的推荐 WebGL 深度纹理 分辨率的宽度乘以 scaleFactor。

10. 令 height 为 view 的推荐 WebGL 深度纹理 分辨率的高度乘以 scaleFactor。

11. 如果 layer 的 layout 为 "mono" 或 "default"：

    如果 textureType 为 "texture-array"：

    使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array，该实例创建为一个使用 context、textureFormat、 stencil、width 和 height、具有 numViews 层的 TEXTURE_2D_ARRAY 纹理。

    如果出于任何原因无法创建该不透明 纹理，则抛出 OperationError 并中止这些步骤。

    返回 array 并中止这些步骤。

    否则

    对 session 的视图列表中的每个 view：

    1. 如果 view 是辅助视图，则继续。

    2. 令 width 为 view 的推荐 WebGL 深度纹理分辨率的宽度乘以 scaleFactor。

    3. 令 height 为 view 的推荐 WebGL 深度纹理分辨率的高度乘以 scaleFactor。

    4. 令 texture 为在 context 的相关 Realm 中新建 的不透明纹理实例，该实例创建为一个 使用 context、textureFormat、stencil、 width 和 height 的 TEXTURE_2D 纹理。

    5. 如果出于任何原因无法创建 texture，则抛出 OperationError 并中止这些步骤。

    6. 将 texture 追加到 array。

    返回 array 并中止这些步骤。

12. 如果会话视图列表中的视图（不包括辅助 视图）并非都具有相同的推荐 WebGL 颜色纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

13. 如果 layer 的 layout 为 stereo-left-right， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context、textureFormat、 stencil、numViews 乘以 width 和 height 的 textureType 纹理。

14. 如果 layer 的 layout 为 stereo-top-bottom， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context、textureFormat、 stencil、width 和 numViews 乘以 height 的 textureType 纹理。

15. 如果出于任何原因无法创建该不透明 纹理，则抛出 OperationError 并中止这些步骤。

16. 返回 array。

要使用 XRProjectionLayer layer为投影层分配运动向量纹理， 用户代理必须运行以下步骤：

1. 令 array 为在 context 的相关 Realm 中新建的数组。

2. 令 context 为 layer 的 context。

3. 令 session 为 layer 的 session。

4. 如果 session 不是使用 "space-warp" 特性描述符创建的，则返回 array 并中止 这些步骤。

5. 如果 context 是 WebGLRenderingContext， 且 WEBGL_depth_texture 扩展未在 context 中启用，则返回 array 并中止这些步骤。

6. 令 numViews 为 session 的视图列表中排除辅助视图后的数量。

7. 令 view 为 session 的视图列表中第一个不是辅助视图的条目。

8. 令 width 为 view 的推荐运动向量纹理 分辨率的宽度乘以 scaleFactor。

9. 令 height 为 view 的推荐运动向量纹理 分辨率的高度乘以 scaleFactor。

10. 如果 layer 的 layout 为 "mono" 或 "default"：

    如果 textureType 为 "texture-array"：

    使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array，该实例创建为一个使用 context、RGBA16F、 width 和 height、具有 numViews 层的 TEXTURE_2D_ARRAY 纹理。

    如果出于任何原因无法创建该不透明 纹理，则抛出 OperationError 并中止这些步骤。

    返回 array 并中止这些步骤。

    否则

    对 session 的视图列表中的每个 view：

    1. 如果 view 是辅助视图，则继续。

    2. 令 width 为 view 的推荐 运动向量纹理分辨率的宽度乘以 scaleFactor。

    3. 令 height 为 view 的推荐 运动向量纹理分辨率的高度乘以 scaleFactor。

    4. 令 texture 为在 context 的相关 Realm 中新建 的不透明纹理实例，该实例创建为一个 使用 context、RGBA16F、 width 和 height 的 TEXTURE_2D 纹理。

    5. 如果出于任何原因无法创建 texture，则抛出 OperationError 并中止这些步骤。

    6. 将 texture 追加到 array。

    返回 array 并中止这些步骤。

11. 如果会话视图列表中的视图（不包括辅助 视图）并非都具有相同的推荐运动向量纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

12. 如果 layer 的 layout 为 stereo-left-right， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context、RGBA16F、 numViews 乘以 width 和 height 的 textureType 纹理。

13. 如果 layer 的 layout 为 stereo-top-bottom， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context、RGBA16F、 width 和 numViews 乘以 height 的 textureType 纹理。

14. 如果出于任何原因无法创建该不透明 纹理，则抛出 OperationError 并中止这些步骤。

15. 返回 array。

要使用 XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat 和 float scaleFactor为辅助视图分配颜色纹理， 用户代理必须运行以下步骤：

1. 令 context 为 layer 的 context。

2. 令 session 为 layer 的 session。

3. 令 array 为在 context 的相关 Realm 中新建的数组。

4. 如果 textureFormat 不在投影层颜色格式列表中， 则抛出 NotSupportedError 并中止这些步骤。

5. 对 session 的视图列表中的每个 view：

   1. 如果 view 不是辅助视图，则继续。

   2. 令 width 为 view 的推荐 WebGL 颜色 纹理分辨率的宽度乘以 scaleFactor。

   3. 令 height 为 view 的推荐 WebGL 颜色 纹理分辨率的高度乘以 scaleFactor。

   4. 按如下方式初始化 texture：

      如果 textureType 为 "texture-array"：

      令 texture 为在 context 的相关 Realm 中新建的不透明纹理实例， 该实例创建为一个使用 context、textureFormat、width 和 height 的 TEXTURE_2D_ARRAY 纹理。

      否则

      令 texture 为在 context 的相关 Realm 中新建的不透明纹理实例， 该实例创建为一个使用 context、textureFormat、width 和 height 的 TEXTURE_2D 纹理。

   5. 如果出于任何原因无法创建 texture，则抛出 OperationError 并中止这些步骤。

   6. 将 texture 追加到 array。

6. 返回 array 并中止这些步骤。

要使用 XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat 和 float scaleFactor为辅助视图分配深度纹理， 用户代理必须运行以下步骤：

1. 令 context 为 layer 的 context。

2. 令 session 为 layer 的 session。

3. 如果 textureFormat 为 0，则返回 array 并中止这些步骤。

4. 如果 context 是 WebGLRenderingContext， 且 WEBGL_depth_texture 扩展未在 context 中启用，则返回 array 并中止这些步骤。

5. 如果 textureFormat 不在投影层深度格式列表中， 则抛出 NotSupportedError 并中止这些步骤。

6. 令 array 为在 context 的相关 Realm 中新建的数组。

7. 对 session 的视图列表中的每个 view：

   1. 如果 view 不是辅助视图，则继续。

   2. 令 width 为 view 的推荐 WebGL 深度 纹理分辨率的宽度乘以 scaleFactor。

   3. 令 height 为 view 的推荐 WebGL 深度 纹理分辨率的高度乘以 scaleFactor。

   4. 按如下方式初始化 texture：

      如果 textureType 为 "texture-array"：

      令 texture 为在 context 的相关 Realm 中新建的不透明纹理实例， 该实例创建为一个使用 context、textureFormat、stencil、 width 和 height 的 TEXTURE_2D_ARRAY 纹理。

      否则

      令 texture 为在 context 的相关 Realm 中新建的不透明纹理实例， 该实例创建为一个使用 context、textureFormat、stencil、 width 和 height 的 TEXTURE_2D 纹理。

   5. 将 texture 追加到 array。

8. 返回 array 并中止这些步骤。

要使用 XRCompositionLayer layer、XRTextureType textureType 和 XRLayerInit init分配颜色 纹理，用户代理必须运行以下步骤：

1. 令 array 为在 context 的相关 Realm 中新建的数组。

2. 令 context 为 layer 的 context。

3. 如果 init 的 colorFormat 不在非投影层颜色格式列表中， 则抛出 NotSupportedError 并中止这些步骤。

4. 如果 init 的 mipLevels 小于 1，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 init 的 mipLevels 大于 1，且 viewPixelWidth 和 viewPixelHeight 不是 2 的幂，则抛出 InvalidStateError 并中止这些步骤

6. 如果 layer 的 layout 为 "mono"：

   如果 textureType 为 "texture-array"：

   使用 1 个在 this context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 1 个内部纹理的 TEXTURE_2D_ARRAY 纹理。

   否则

   使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_2D 纹理。

7. 如果 layer 的 layout 为 "stereo"：

   如果 textureType 为 "texture-array"：

   使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 2 层的 TEXTURE_2D_ARRAY 纹理。

   返回 array 并中止这些步骤。

   否则

   使用 2 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_2D 纹理。

   返回 array 并中止这些步骤。

8. 如果 layer 的 layout 为 stereo-left-right， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 的两倍和 viewPixelHeight 值的 textureType 纹理。

9. 如果 layer 的 layout 为 stereo-top-bottom， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 的两倍值的 textureType 纹理。

10. 返回 array。

要使用 XRCompositionLayer layer、XRTextureType textureType 和 XRLayerInit init分配深度 纹理，用户代理必须运行以下步骤：

1. 令 array 为在 context 的相关 Realm 中新建的数组。

2. 令 context 为 layer 的 context。

3. 如果未设置 init 的 depthFormat， 则返回 array 并中止这些步骤。

4. 如果 init 的 depthFormat 不在非投影层深度格式列表中， 则抛出 NotSupportedError 并中止这些步骤。

5. 如果 init 的 mipLevels 小于 1，则抛出 InvalidStateError 并中止这些步骤。

6. 如果 init 的 mipLevels 大于 1，且 viewPixelWidth 和 viewPixelHeight 不是 2 的幂，则抛出 InvalidStateError 并中止这些步骤。

7. 如果 layer 的 layout 为 "mono"：

   如果 textureType 为 "texture-array"：

   使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 1 个内部纹理的 TEXTURE_2D_ARRAY 纹理。

   否则

   使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_2D 纹理。

8. 如果 layer 的 layout 为 "stereo"：

   如果 textureType 为 "texture-array"：

   使用 1 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 2 层的 TEXTURE_2D_ARRAY 纹理。

   返回 array 并中止这些步骤。

   否则

   使用 2 个在 context 的相关 Realm 中新建的不透明 纹理实例初始化 array， 该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_2D 纹理。

   返回 array 并中止这些步骤。

9. 如果 layer 的 layout 为 stereo-left-right， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 的两倍和 viewPixelHeight 值的 textureType 纹理。

10. 如果 layer 的 layout 为 stereo-top-bottom， 则使用 1 个在 context 的相关 Realm 中新建的不透明纹理 实例初始化 array，该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 的两倍值的 textureType 纹理。

11. 返回 array。

createProjectionLayer(optional XRProjectionLayerInit init) 方法创建一个新的 XRProjectionLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 令 context 为 this 的 context。

3. 令 layer 为在 this 的相关 Realm 中新建的 XRProjectionLayer。

4. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 context 已丢失，则抛出 InvalidStateError 并中止这些步骤。

6. 使用 session 和 context 在 layer 上运行初始化合成层。

7. 将 layer 的 isStatic 初始化为 false。

8. 按如下方式初始化 layer 的 ignoreDepthValues：

   如果 init 的 depthFormat 为 false，并且 XR Compositor 将使用深度值

   将 layer 的 ignoreDepthValues 初始化为 false

   否则

   将 layer 的 ignoreDepthValues 初始化为 true

9. 将 layer 的 fixedFoveation 初始化为 0。

10. 令 layout 为使用 init 的 textureType、 context 和 "default" 确定 layout 属性的结果。

11. 令 maximum scalefactor 为使用 session、context 和 layout 确定最大 scalefactor的结果。

12. 如果 scaleFactor 大于 maximum scalefactor，则将 scaleFactor 设置为 maximum scalefactor。

13. 将 layer 的 layout 初始化为 layout。

14. 将 layer 的 needsRedraw 初始化为 true。

15. 令 layer 的 colorTextures 为使用 layer、init 的 textureType、 init 的 colorFormat 和 init 的 scaleFactor 为投影层分配颜色纹理的结果。

16. 令 layer 的 depthStencilTextures 为使用 layer、init 的 textureType、 init 的 depthFormat 和 init 的 scaleFactor 为投影层分配深度纹理的结果。

17. 令 layer 的 motionVectorTextures 为使用 layer、init 的 depthFormat 和 init 的 scaleFactor 为投影层分配运动向量 纹理的结果。

18. 按如下方式初始化 辅助视图的 colortextures：

    如果 session 是在启用 "secondary-views" 的情况下创建的

    令辅助视图的 colortextures为使用 layer、init 的 textureType、 init 的 colorFormat 和 init 的 scaleFactor 为辅助视图分配颜色 纹理的结果。

    否则

    令辅助视图的 colortextures为 null。

19. 按如下方式初始化 辅助视图的 depthstenciltextures：

    如果 session 是在启用 "secondary-views" 的情况下创建的

    令辅助视图的 depthstenciltextures为使用 layer、init 的 textureType、 init 的 depthFormat 和 init 的 scaleFactor 为辅助视图分配深度 纹理的结果。

    否则

    令辅助视图的 depthstenciltextures为 null。

20. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

21. 返回 layer。

createQuadLayer(XRQuadLayerInit init) 方法创建一个新的 XRQuadLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下 创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为 this 的 context。

4. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 context 已丢失，则抛出 InvalidStateError 并中止这些步骤。

6. 如果 layout 为 "default"， 则抛出 TypeError 并中止这些步骤。

7. 令 layer 为在 this 的相关 Realm 中新建的 XRQuadLayer。

8. 使用 session 和 context 在 layer 上运行初始化合成层。

9. 使用 layer 和 init 运行初始化四边形层。

10. 令 layout 为使用 init 的 textureType、 context 和 init 的 layout 确定 layout 属性的结果。

11. 将 layer 的 layout 初始化为 layout。

12. 将 layer 的 needsRedraw 初始化为 true。

13. 令 layer 的 colorTextures 为使用 layer、init 的 textureType 和 init 分配颜色 纹理的结果。

14. 令 layer 的 depthStencilTextures 为使用 layer、 init 的 textureType 和 init 分配深度纹理的结果。

15. 令 layer 的 motionVectorTextures 为在 context 的相关 Realm 中新建的数组。

16. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

17. 返回 layer。

createCylinderLayer(XRCylinderLayerInit init) 方法创建一个新的 XRCylinderLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下 创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为 this 的 context。

4. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 context 已丢失，则抛出 InvalidStateError 并中止这些步骤。

6. 如果 layout 为 "default"， 则抛出 TypeError 并中止这些步骤。

7. 令 layer 为在 this 的相关 Realm 中新建的 XRCylinderLayer。

8. 使用 session 和 context 在 layer 上运行初始化合成层。

9. 使用 layer 和 init 运行初始化圆柱层。

10. 令 layout 为使用 init 的 textureType、 context 和 init 的 layout 确定 layout 属性的结果。

11. 将 layer 的 layout 初始化为 layout。

12. 将 layer 的 needsRedraw 初始化为 true。

13. 令 layer 的 colorTextures 为使用 layer、init 的 textureType 和 init 分配颜色 纹理的结果。

14. 令 layer 的 depthStencilTextures 为使用 layer、 init 的 textureType 和 init 分配深度纹理的结果。

15. 令 layer 的 motionVectorTextures 为在 context 的相关 Realm 中新建的数组。

16. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

17. 返回 layer。

createEquirectLayer(XREquirectLayerLayerInit init) 方法创建一个新的 XREquirectLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下 创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为 this 的 context。

4. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 context 已丢失，则抛出 InvalidStateError 并中止这些步骤。

6. 如果 layout 为 "default"， 则抛出 TypeError 并中止这些步骤。

7. 如果 init 的 space 不是 XRReferenceSpace 类型的实例， 则抛出 TypeError 并中止这些步骤。

8. 如果 init 的 space 具有 "viewer" 的type， 则抛出 TypeError 并中止这些步骤。

9. 令 layer 为在 this 的相关 Realm 中新建的 XREquirectLayer。

10. 使用 session 和 context 在 layer 上运行初始化合成层。

11. 使用 layer 和 init 运行初始化等矩形层。

12. 令 layout 为使用 init 的 textureType、 context 和 init 的 layout 确定 layout 属性的结果。

13. 将 layer 的 layout 初始化为 layout。

14. 将 layer 的 needsRedraw 初始化为 true。

15. 令 layer 的 colorTextures 为使用 layer、init 的 textureType 和 init 分配颜色 纹理的结果。

16. 令 layer 的 depthStencilTextures 为使用 layer、 init 的 textureType 和 init 分配深度纹理的结果。

17. 令 layer 的 motionVectorTextures 为在 context 的相关 Realm 中新建的数组。

18. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

19. 返回 layer。

createCubeLayer(XRCubeLayerInit init) 方法创建一个新的 XRCubeLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下 创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为 this 的 context。

4. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 context 不是 WebGL2RenderingContext 上下文，则抛出 InvalidStateError 并中止这些步骤。

6. 如果 context 已丢失，则抛出 InvalidStateError 并中止这些步骤。

7. 如果 init 的 space 不是 XRReferenceSpace 类型的实例， 则抛出 TypeError 并中止这些步骤。

8. 如果 init 的 space 具有 "viewer" 的type， 则抛出 TypeError 并中止这些步骤。

9. 令 layer 为在 this 的相关 Realm 中新建的 XRCubeLayer。

10. 使用 session 和 context 在 layer 上运行初始化合成层。

11. 令 layer 的 space 为 init 的 space。

12. 将 layer 的 isStatic 初始化为 init 的 isStatic

13. 按如下方式初始化 layer 的 orientation：

    如果设置了 init 的 orientation

    令 layer 的 orientation 为使用 init 的 orientation 运行 fromPoint 的结果。

    否则

    令 layer 的 orientation 为在 this 的相关 Realm 中新建的 DOMPointReadOnly。

14. 令 layout 为 init 的 layout。

15. 令 textureType 为 init 的 textureType。

16. 将 layer 的 needsRedraw 初始化为 true。

17. 如果 layout 为 "default" 或 "stereo-left-right" 或 "stereo-top-bottom"， 则抛出 TypeError 并中止这些步骤。

18. 令 layer 的 colorTextures 为在此 XRCubeLayer 的相关 Realm 中新建的数组。

19. 根据 layout 的值，按如下方式初始化 layer 的 colorTextures：

    1. 如果 layer 的 layout 为 "mono"：

       如果 textureType 为 "texture-array"：

       使用 1 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 colorTextures， 该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 6 层的 TEXTURE_2D_ARRAY 纹理。

       否则

       使用 1 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 colorTextures， 该实例创建为一个使用 context 和 init 的 colorFormat、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_CUBE_MAP 纹理。

    2. 否则，如果 layer 的 layout 为 "stereo"：

       如果 textureType 为 "texture-array"：

       使用 1 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 colorTextures， 该实例创建为一个使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 12 层的 TEXTURE_2D_ARRAY 纹理。

       否则

       使用 2 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 colorTextures， 该实例创建为一个使用 context 和 init 的 colorFormat、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_CUBE_MAP 纹理。

20. 令 layer 的 depthStencilTextures 为在此 XRCubeLayer 的相关 Realm 中新建的数组。

21. 令 layer 的 motionVectorTextures 为在此 XRCubeLayer 的相关 Realm 中新建的数组。

22. 如果设置了 init 的 depthFormat， 则按如下方式初始化 layer 的 depthStencilTextures：

    1. 如果 context 不是 WebGL2RenderingContext 且 WEBGL_depth_texture 扩展未在 context 中启用，则抛出 TypeError 并中止这些步骤。

    2. 如果 layer 的 layout 为 "mono"：

       如果 textureType 为 "texture-array"：

       使用 1 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 depthStencilTextures， 该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 6 层的 TEXTURE_2D_ARRAY 纹理。

       否则

       使用 1 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 depthStencilTextures， 该实例创建为一个使用 context 和 init 的 depthFormat、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_CUBE_MAP 纹理。

    3. 否则，如果 layer 的 layout 为 "stereo"：

       如果 textureType 为 "texture-array"：

       使用 1 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 depthStencilTextures， 该实例创建为一个使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值、具有 12 层的 TEXTURE_2D_ARRAY 纹理。

       否则

       使用 2 个在此 XRCubeLayer 的相关 Realm 中新建的不透明纹理实例初始化 depthStencilTextures， 该实例创建为一个使用 context 和 init 的 depthFormat、 viewPixelWidth 和 viewPixelHeight 值的 TEXTURE_CUBE_MAP 纹理。

23. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

24. 返回 layer。

要对一个带有 XRCompositionLayer layer 和 XRFrame frame 参数的 XRWebGLBinding binding 的 XRWebGLSubImage 创建函数的 状态进行验证，用户代理必须运行以下步骤：

1. 如果 frame 的 session 不等于 layer 的 session，则返回 false 并中止 这些步骤。

2. 如果 frame 的 active 布尔值为 false，则返回 false 并中止这些步骤。

3. 如果 frame 的 animationFrame 布尔值为 false，则返回 false 并中止这些步骤。

4. 如果 binding 的 session 不等于 layer 的 session，则返回 false 并中止 这些步骤。

5. 如果 binding 的 context 不等于 layer 的 context，则返回 false 并中止 这些步骤。

6. 如果 layer 的 colorTextures 数组为空或缺失，则返回 false 并中止这些步骤。

7. 如果 layer 的 isStatic 为 true 且 layer 的 needsRedraw 为 false，则返回 false 并中止这些步骤。

8. 返回 true。

要使用一个不透明纹理 texture、一个 XRLayerLayout layout、一个整数 offset 和一个整数 num 初始化 XRViewport viewport 的视口，用户代理必须运行 以下步骤：

1. 将 viewport 的 x 设置为 0。

2. 将 viewport 的 y 设置为 0。

3. 将 viewport 的 width 设置为 texture 的像素宽度。

4. 将 viewport 的 height 设置为 texture 的像素高度。

5. 按如下方式更新 viewport：

   如果 layout 为 "stereo-left-right"

   将 viewport 的 x 设置为 texture 的像素宽度乘以 offset 再除以 num。

   将 viewport 的 width 设置为 subimage 的 texture 的像素宽度除以 num。

   否则，如果 layout 为 "stereo-top-bottom"

   将 viewport 的 y 设置为 texture 的像素高度乘以 offset 再除以 num。

   将 viewport 的 height 设置为 subimage 的 texture 的像素高度除以 num。

getSubImage(XRCompositionLayer layer, XRFrame frame, optional XREye eye = "none") 方法创建一个新的 XRWebGLSubImage。

当此方法在 XRWebGLBinding binding 上调用时，它必须运行以下步骤：

1. 按如下方式初始化 subimage：

   如果之前曾使用相同的 binding、layer 和 eye 调用过 getSubImage()， 用户代理可以

   令 subimage 为先前使用相同实参调用时返回的同一个 XRWebGLSubImage 对象。

   否则

   令 subimage 为在 this 的相关 Realm 中新建的 XRWebGLSubImage。

   令 subimage 的 viewport 为在 this 的相关 Realm 中新建的 XRViewport。

2. 令 session 为 this 的 session。

3. 如果 layer 不在 session 的 layers 数组中，则抛出 TypeError 并中止这些步骤。

4. 如果 layer 的类型为 XRProjectionLayer， 则抛出 TypeError 并中止这些步骤。

5. 如果 layer 的 layout 属性为 "default"， 则抛出 TypeError 并中止这些步骤。

6. 令 index 为 0。

7. 如果 layer 的 layout 属性为 "stereo"：

   1. 如果 eye 为 "none"， 则抛出 TypeError 并中止这些步骤。

   2. 如果 eye 为 "right"：

      如果 layer 的类型为 XRCubeLayer

      将 index 设置为 6

      否则

      将 index 设置为 1

8. 如果使用 layer 和 frame 验证 XRWebGLSubImage 创建函数的状态的结果为 false，则抛出 InvalidStateError 并中止这些步骤。

9. 按如下方式初始化 subimage 的 imageIndex：

   如果 layer 是使用 "texture-array" textureType 创建的

   将 subimage 的 imageIndex 初始化为 index。

   否则

   将 subimage 的 imageIndex 初始化为 0。

10. 按如下方式初始化 subimage 的 colorTexture：

    如果 layer 是使用 "texture" textureType 创建的

    将 subimage 的 colorTexture 初始化为 layer 的 colorTextures 数组中偏移量为 index 的元素。

    否则

    将 subimage 的 colorTexture 初始化为 layer 的 colorTextures 数组的第一个元素。

11. 按如下方式初始化 subimage 的 depthStencilTexture：

    如果 layer 的 depthStencilTextures 是空数组

    将 subimage 的 depthStencilTexture 初始化为 null。

    否则，layer 是使用 "texture" textureType 创建的

    将 subimage 的 depthStencilTexture 初始化为 layer 的 depthStencilTextures 数组中偏移量为 index 的元素。

    否则

    将 subimage 的 depthStencilTexture 初始化为 layer 的 depthStencilTextures 数组的第一个元素。

12. 将 subimage 的 motionVectorTexture、 motionVectorTextureWidth 和 motionVectorTextureHeight 初始化为 null。

13. 将 subimage 的 colorTextureWidth 设置为 subimage 的 colorTexture 的像素宽度。

14. 将 subimage 的 colorTextureHeight 设置为 subimage 的 colorTexture 的像素高度。

15. 如果 subimage 的 depthStencilTexture 不是 null，则将 subimage 的 depthStencilTextureWidth 设置为 depthStencilTexture 数组中第一个纹理的像素宽度。

16. 如果 subimage 的 depthStencilTexture 不是 null，则将 subimage 的 depthStencilTextureHeight 设置为 depthStencilTexture 数组中第一个纹理的像素高度。

17. 令 viewsPerTexture 为 1。

18. 如果 layer 的 layout 属性为 "stereo-left-right" 或 "stereo-top-bottom"， 则将 viewsPerTexture 设置为 2。

19. 使用 subimage 的 colorTexture、 layer 的 layout、 index 和 viewsPerTexture，在 subimage 的 viewport 上运行初始化视口。

20. 排队一个任务，将 needsRedraw 设置为 false。

21. 返回 subimage。

getViewSubImage(XRProjectionLayer layer, XRView view) 方法创建一个新的 XRWebGLSubImage。

当此方法在 XRWebGLBinding binding 上调用时，它必须运行以下步骤：

1. 按如下方式初始化 subimage：

   如果之前曾使用相同的 binding、layer 和 view 调用过 getViewSubImage()， 用户代理可以

   令 subimage 为先前使用相同实参调用时返回的同一个 XRWebGLSubImage 对象。

   否则

   令 subimage 为在 this 的相关 Realm 中新建的 XRWebGLSubImage。

   令 subimage 的 viewport 为在 this 的相关 Realm 中新建的 XRViewport。

2. 令 frame 为 view 的 frame。

3. 令 session 为 this 的 session。

4. 如果使用 layer 和 frame 验证 XRWebGLSubImage 创建函数的状态的结果为 false，则抛出 InvalidStateError 并中止这些步骤。

5. 如果 layer 不在 session 的 layers 数组中，则抛出 TypeError 并中止这些步骤。

6. 如果 view 的 active 标志为 false，则抛出 InvalidStateError 并中止这些步骤。

7. 按如下方式初始化 index：

   如果 view 是来自 session 的视图列表的辅助视图

   令 index 为 view 的 view 在 session 的视图列表中排除主视图后的偏移量。

   否则

   令 index 为 view 的 view 在 session 的视图列表中排除辅助视图后的偏移量。

8. 按如下方式初始化 subimage 的 imageIndex：

   如果 layer 是使用 "texture-array" textureType 创建的：

   将 subimage 的 imageIndex 初始化为 index。

   否则

   将 subimage 的 imageIndex 初始化为 0。

9. 按如下方式初始化 subimage 的 colorTexture：

   如果 view 是来自 session 的视图列表的辅助视图

   将 subimage 的 colorTexture 初始化为 layer 的 辅助视图的 colorTextures 中偏移量为 index 的元素。

   否则，如果 layer 的 layout 为 "default" 且 layer 是使用 "texture" textureType 创建的

   将 subimage 的 colorTexture 初始化为 layer 的 colorTextures 数组中偏移量为 index 的元素。

   否则

   将 subimage 的 colorTexture 初始化为 layer 的 colorTextures 数组的第一个元素。

10. 按如下方式初始化 subimage 的 depthStencilTexture：

    如果 layer 的 depthStencilTextures 是空数组

    将 subimage 的 depthStencilTexture 初始化为 null。

    否则，如果 view 是来自 session 的视图列表的辅助视图

    将 subimage 的 colorTexture 初始化为 layer 的 辅助视图的 depthStencilTextures 中偏移量为 index 的元素。

    否则，如果 layer 的 layout 为 "default" 且 layer 是使用 "texture" textureType 创建的

    将 subimage 的 depthStencilTexture 初始化为 layer 的 depthStencilTextures 数组中偏移量为 index 的元素。

    否则

    将 subimage 的 depthStencilTexture 初始化为 layer 的 depthStencilTextures 数组的第一个元素。

11. 按如下方式初始化 subimage 的 motionVectorTexture：

    如果 layer 的 motionVectorTextures 是空数组，或 view 是来自 session 的视图列表的辅助视图

    将 subimage 的 motionVectorTexture 初始化为 null。

    否则，layer 是使用 "texture" textureType 创建的

    将 subimage 的 motionVectorTexture 初始化为 layer 的 motionVectorTextures 数组中偏移量为 index 的元素。

    否则

    将 subimage 的 motionVectorTexture 初始化为 layer 的 motionVectorTextures 数组的第一个元素。

12. 将 subimage 的 colorTextureWidth 设置为 subimage 的 colorTexture 的像素宽度。

13. 将 subimage 的 colorTextureHeight 设置为 subimage 的 colorTexture 的像素高度。

14. 如果 subimage 的 depthStencilTexture 不是 null，则将 subimage 的 depthStencilTextureWidth 设置为 depthStencilTexture 数组中第一个纹理的像素宽度。

15. 如果 subimage 的 depthStencilTexture 不是 null，则将 subimage 的 depthStencilTextureHeight 设置为 depthStencilTexture 数组中第一个纹理的像素高度。

16. 如果 subimage 的 motionVectorTexture 不是 null，则将 subimage 的 motionVectorTextureWidth 设置为 motionVectorTexture 数组中第一个纹理的像素宽度。

17. 如果 subimage 的 motionVectorTexture 不是 null，则将 subimage 的 motionVectorTextureHeight 设置为 motionVectorTexture 数组中第一个纹理的像素高度。

18. 使用 subimage 的 colorTexture、 layer 的 layout、 index 和 session 的视图列表的数量，在 subimage 的 viewport 上运行初始化视口。

19. 将 needsRedraw 设置为 false。

20. 返回 subimage

dictionary XRMediaLayerInit {
  required XRSpace space;
  XRLayerLayout layout = "mono";
  boolean invertStereo = false;
};

dictionary XRMediaQuadLayerInit : XRMediaLayerInit {
  XRRigidTransform? transform;
  float? width;
  float? height;
};

dictionary XRMediaCylinderLayerInit : XRMediaLayerInit {
  XRRigidTransform? transform;
  float radius = 2.0;
  float centralAngle = 0.78539;
  float? aspectRatio;
};

dictionary XRMediaEquirectLayerInit : XRMediaLayerInit {
  XRRigidTransform? transform;
  float radius = 0.0;
  float centralHorizontalAngle = 6.28318;
  float upperVerticalAngle = 1.570795;
  float lowerVerticalAngle = -1.570795;
};

[Exposed=Window] interface XRMediaBinding {
  constructor(XRSession session);

  XRQuadLayer createQuadLayer(HTMLVideoElement video, optional XRMediaQuadLayerInit init = {});
  XRCylinderLayer createCylinderLayer(HTMLVideoElement video, optional XRMediaCylinderLayerInit init = {});
  XREquirectLayer createEquirectLayer(HTMLVideoElement video, optional XRMediaEquirectLayerInit init = {});
};

当带有 XRCompositionLayer layer 和 HTMLVideoElement media 的层需要渲染时，用户代理 必须运行以下步骤：

1. 令 usability 为检查 media 可用性的结果。

2. 如果 usability 为 bad，则用透明黑色填充 layer， 并中止这些步骤。

3. 用 media 元素的内容填充 layer。

XRMediaBinding(XRSession session) 构造函数在被调用时 必须执行以下步骤：

1. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

2. 如果 session 不是沉浸式会话，则抛出 InvalidStateError 并中止这些步骤。

3. 令 binding 为在 session 的相关 Realm 中新建的 XRMediaBinding。

4. 将 binding 的 session 初始化为 session。

5. 返回 binding。

要计算一个 HTMLVideoElement video 和一个 XRLayerLayout layout 的宽高比， 运行以下步骤：

1. 令 width 为 video 的 videoWidth。

2. 令 height 为 video 的 videoHeight。

3. 如果 layout 为 "stereo-left-right"， 则将 width 除以 2。

4. 如果 layout 为 "stereo-top-bottom"， 则将 height 除以 2。

5. 返回 width 除以 height。

createQuadLayer(HTMLVideoElement video, XRMediaQuadLayerInit init) 方法创建一个新的 XRQuadLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

4. 如果 init 的 layout 为 "default"， 则抛出 TypeError 并中止这些步骤。

5. 令 layer 为在 this 的相关 Realm 中新建的 XRQuadLayer。

6. 使用 session 在 layer 上运行初始化合成层。

7. 将 layer 的 media 初始化为 video。

8. 将 layer 的 needsRedraw 初始化为 false。

9. 令 aspectRatio 为使用 video 和 init 的 layout 计算宽高比的结果。

10. 如果 init 的 width 和 height 为 undefined，则将 width 设置为 1。

11. 如果 init 的 height 为 undefined，则将 height 设置为 width 除以 aspectRatio。

12. 如果 init 的 width 为 undefined，则将 width 设置为 height 乘以 aspectRatio。

13. 使用 layer 和 init 运行初始化四边形层。

14. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

15. 返回 layer。

createCylinderLayer(HTMLVideoElement video, XRMediaCylinderLayerInit init) 方法创建一个新的 XRCylinderLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

4. 如果 init 的 layout 为 "default"， 则抛出 TypeError 并中止这些步骤。

5. 令 layer 为在 this 的相关 Realm 中新建的 XRCylinderLayer。

6. 使用 session 在 layer 上运行初始化合成层。

7. 将 layer 的 media 初始化为 video。

8. 将 layer 的 needsRedraw 初始化为 false。

9. 令 aspectRatio 为使用 video 和 init 的 layout 计算宽高比的结果。

10. 如果 init 的 aspectRatio 为 undefined，则将 aspectRatio 设置为 aspectRatio。

11. 使用 layer 和 init 运行初始化圆柱层。

12. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

13. 返回 layer。

createEquirectLayer(HTMLVideoElement video, XRMediaEquirectLayerInit init) 方法创建一个新的 XREquirectLayer layer。

调用此方法时，用户代理必须运行以下步骤：

1. 令 session 为 this 的 session。

2. 如果 session 不是在启用 "layers" 的情况下创建的，则抛出 NotSupportedError 并中止这些步骤。

3. 如果 session 的 ended 值为 true，则抛出 InvalidStateError 并中止这些步骤。

4. 如果 init 的 layout 为 "default"， 则抛出 TypeError 并中止这些步骤。

5. 如果 init 的 space 不是 XRReferenceSpace 类型的实例， 则抛出 InvalidStateError 并中止这些步骤。

6. 如果 init 的 space 具有 "viewer" 的type， 则抛出 InvalidStateError 并中止这些步骤。

7. 令 layer 为在 this 的相关 Realm 中新建的 XREquirectLayer。

8. 使用 session 在 layer 上运行初始化合成层。

9. 将 layer 的 media 初始化为 video。

10. 将 layer 的 needsRedraw 初始化为 false。

11. 使用 layer 和 init 运行初始化等矩形层。

12. 如果 XR Compositor 知道出于任何原因将无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

13. 返回 layer。

[SecureContext, Exposed=Window] interface XRLayerEvent : Event {
  constructor(DOMString type, XRLayerEventInit eventInitDict);
  [SameObject] readonly attribute XRLayer layer;
};

dictionary XRLayerEventInit : EventInit {
  required XRLayer layer;
};

[SecureContext, Exposed=Window] partial interface XRRenderState {
  readonly attribute FrozenArray<XRLayer> layers;
};

此模块替换初始化渲染状态给出的步骤。取而代之，当为 XRSession session 创建 XRRenderState 对象 state 时，用户代理必须通过运行以下步骤 初始化渲染状态：

1. 通过运行原始初始化渲染状态步骤来初始化 state。

2. 将 state 的 layers 初始化为在 session 的相关 Realm 中新建的空数组。

此模块替换 WebXR 规范中由 "更新待处理 layers 状态" 给出的步骤。取而代之，当用户代理将使用 XRSession session 和 XRRenderStateInit newState 更新待处理 layers 状态时，必须运行以下步骤：

1. 如果 newState 的 baseLayer 和 newState 的 layers 都已设置，则抛出 NotSupportedError 并中止这些步骤。

2. 令 activeState 为 session 的活动渲染状态。

3. 如果设置了 newState 的 baseLayer：

   1. 如果 session 的待处理渲染状态为 null，则将 其设置为 activeState 的副本。

   2. 将 session 的待处理渲染状态的 layers 设置为 null。

4. 如果设置了 newState 的 layers：

   1. 如果 session 不是在启用 "layers" 的情况下创建的，并且 newState 的 layers 包含超过 1 个实例，则抛出 NotSupportedError 并中止这些步骤。

   2. 如果 newState 的 layers 包含超过 maxRenderLayers 个条目，则抛出 NotSupportedError 并中止这些步骤。

   3. 如果 session 的待处理渲染状态为 null， 则将其设置为 activeState 的副本。

   4. 如果 newState 的 layers 包含重复实例，则抛出 TypeError 并中止这些步骤。

   5. 对于 newState 的 layers 中的每个 layer：

      1. 如果 layer 是 XRCompositionLayer 且 layer 的 session 不同于 session，则抛出 TypeError 并中止这些步骤。

      2. 如果 layer 是 XRWebGLLayer 且 layer 的 session 不同于 session，则抛出 TypeError 并中止这些步骤。

   6. 将 session 的待处理渲染状态的 baseLayer 设置为 null。

   7. 将 session 的待处理渲染状态的 layers 设置为 newState 的 layers。

此模块替换 WebXR 规范中由 "检查 layers 状态" 给出的步骤。取而代之，要使用 renderState state 检查 layers 状态， 用户代理必须运行以下步骤：

1. 如果 state 的 baseLayer 不是 null，则返回 true。

2. 如果 state 的 layers 不为空，则返回 true。

3. 返回 false。

11.6. XRSession 变更

此模块扩展并向 XRSession 接口添加以下内容：

[SecureContext, Exposed=Window] partial interface XRSession {
  readonly attribute unsigned long maxRenderLayers;
};

maxRenderLayers 表示 compositor 必须处理的 最大层数，因此也表示任何 XRRenderStateInit 的 layers 数组的最大大小。应该可以在给定时间创建超过该数量的层。

注： 此指导并非旨在对用户代理可分配的层数量 设置限制，如层的分配中所述。用户代理可以允许例如创建 20 个层， 同时只允许一次通过 updateRenderState() 设置 10 个。还值得注意的是，由于不同层可能需要不同数量的后端能力或 对象，用户代理在设置 `maxRenderLayers` 值时具有一定自由裁量权，以确保至少 这么多层可以被渲染。不过，当传入更多层时，用户代理仍然需要拒绝，并且不能在传入更少层时拒绝 updateRenderState。

每个 XRSession 都有一个内部 WeakSet bindings，其中保存 对使用该会话创建的每个 XRWebGLBinding 的弱引用。

此模块向 WebXR 规范中的 "关闭 会话" 添加一个步骤。 将以下内容添加到列表中：

1. 对于 session| 的 bindings 中的每个 binding：

   1. 对于 binding 的 foveatedTextures 中的每个 texture：

   2. 从 texture 移除凹区化。