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。

要使用一个 XRCompositionLayer layer 销毁层的资源，用户代理必须运行以下步骤：

1. 对于 layer 的 colorTextures、depthStencilTextures 或 motionVectorTextures 数组中存在的每个不透明 纹理，将该纹理标记为待删除，就像已经在 layer 的上下文上以该纹理为参数调用了 deleteTexture 一样。这是用户代理的内部操作，不得生成 INVALID_OPERATION 错误。

2. 如果 layer 是 XRProjectionLayer：

   1. 如果 layer 的辅助视图的 colorTextures 不是 null，则对于该 数组中的每个不透明纹理，以相同方式将该纹理标记为待删除。

   2. 如果 layer 的辅助视图的 depthStencilTextures 不是 null，则对于该 数组中的每个不透明纹理，以相同方式将该纹理标记为待删除。

3. 如果 layer 有一个 colorTextures 数组，则将其设置为空数组。

4. 如果 layer 有一个 depthStencilTextures 数组，则将其设置为空数组。

5. 如果 layer 有一个 motionVectorTextures 数组，则将其设置为空数组。

6. 如果 layer 是 XRProjectionLayer， 则将其辅助视图的 colorTextures 和辅助视图的 depthStencilTextures 设置为空数组。

7. 对于 layer 的每个底层资源，一旦在资源失效之前排队的所有 GPU 工作 均已完成，并且 XR 合成器不再访问该资源，用户代理就可以实际释放该资源。

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

1. 将此对象的会话设置为 session。

2. 如果定义了 context，则将此对象的上下文设置为 context。

3. 将此对象的destroyed 设置为 false。

4. 将此对象的 blendTextureSourceAlpha 设置为 true。

5. 将此对象的 opacity 设置为 1.0。

当在一个 XRCompositionLayer layer 上调用 destroy() 时，用户代理必须运行以下步骤：

1. 如果 layer 的destroyed 为 true，则返回。

2. 将 layer 的destroyed 设置为 true。

3. 使用 layer 运行销毁层的资源。

4. 令 session 为 layer 的会话。

5. 如果 session 的待处理渲染状态为 null：

   1. 如果 session 的活动渲染状态的 layers 不包含 layer，则返回。

   2. 将 session 的待处理渲染状态设置为 session 的活动渲染状态的副本。

6. 令 state 为 session 的待处理渲染状态。

7. 如果 state 的 layers 为 null 或不包含 layer，则返回。

8. 将 state 的 layers 设置为一个新的冻结数组，其中按顺序包含 state 的 layers 中除 layer 之外的每个条目。

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

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

2. 如果 space 的会话不等于 layer 的会话，则抛出 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;

  // 事件
  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;

  // 事件
  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;

  // 事件
  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;

  // 事件
  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;
};

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 的相关领域中的一个新 XRWebGLBinding。

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

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

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

5. 如果 context 的XR 兼容布尔值为 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 的相关领域中的一个新数组。

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 个新的不透明 纹理实例初始化 array，该实例位于 context 的相关领域中，并使用 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 的相关领域中的一个新 不透明纹理实例， 使用 context、textureFormat、width 和 height 创建为 TEXTURE_2D 纹理。

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

   6. 将 texture 追加到 array。

   返回 array 并中止这些步骤。

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

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

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

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

14. 返回 array。

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

1. 令 context 为 layer 的context。

2. 令 array 为 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. 令 recommendedDepthResolution 为 view 的推荐的 WebGL 深度纹理 分辨率。

10. 如果 session 创建时使用了“space-warp”特性描述符，则将 recommendedDepthResolution 设置为 view 的推荐的运动矢量纹理 分辨率。

11. 令 width 为 recommendedDepthResolution 的宽度乘以 scaleFactor。

12. 令 height 为 recommendedDepthResolution 的高度乘以 scaleFactor。

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

    如果 textureType 为 "texture-array"：

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

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

    返回 array 并中止这些步骤。

    否则

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

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

    2. 令 recommendedDepthResolution 为 view 的推荐的 WebGL 深度纹理分辨率。

    3. 如果 session 创建时使用了“space-warp”特性描述符，则将 recommendedDepthResolution 设置为 view 的推荐的 运动矢量纹理分辨率。

    4. 令 width 为 recommendedDepthResolution 的宽度乘以 scaleFactor。

    5. 令 height 为 recommendedDepthResolution 的高度乘以 scaleFactor。

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

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

    8. 将 texture 追加到 array。

    返回 array 并中止这些步骤。

14. 如果 session 创建时使用了“space-warp”特性描述符，并且会话视图列表中的视图 在排除辅助 视图后并非都具有相同的推荐的运动矢量纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

15. 如果 session 创建时未使用“space-warp”特性描述符，并且会话视图列表中的视图 在排除辅助 视图后并非都具有相同的推荐的 WebGL 深度纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

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

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

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

19. 返回 array。

要使用一个 XRProjectionLayer layer、一个 XRTextureType textureType 和一个 float scaleFactor 为投影层分配运动矢量纹理，用户代理必须运行以下步骤：

1. 令 context 为 layer 的context。

2. 令 array 为 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 个新的不透明 纹理实例初始化 array，该实例位于 context 的相关领域中，并使用 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 的相关领域中的一个新 不透明纹理实例， 使用 context、RGBA16F、 width 和 height 创建为 TEXTURE_2D 纹理。

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

    6. 将 texture 追加到 array。

    返回 array 并中止这些步骤。

11. 如果会话视图列表中的视图在排除辅助 视图后并非都具有相同的推荐的运动矢量纹理 分辨率，则抛出 NotSupportedError 并中止这些步骤。

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

13. 如果 layer 的 layout 为 stereo-top-bottom， 则使用位于 context 的相关领域中的 1 个新不透明纹理 实例初始化 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 的相关领域中的一个新数组。

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 的相关领域中的一个新 不透明纹理实例， 使用 context、textureFormat、width 和 height 创建为 TEXTURE_2D_ARRAY 纹理。

      否则

      令 texture 为 context 的相关领域中的一个新 不透明纹理实例， 使用 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 的相关领域中的一个新数组。

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

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

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

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

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

      如果 textureType 为 "texture-array"：

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

      否则

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

   5. 将 texture 追加到 array。

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

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

1. 令 array 为 context 的相关领域中的一个新数组。

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"：

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

   否则

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

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

   如果 textureType 为 "texture-array"：

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

   返回 array 并中止这些步骤。

   否则

   使用位于 context 的相关领域中的 2 个新不透明 纹理实例初始化 array，这些实例使用 context 和 init 的 colorFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值创建为 TEXTURE_2D 纹理。

   返回 array 并中止这些步骤。

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

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

10. 返回 array。

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

1. 令 array 为 context 的相关领域中的一个新数组。

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"：

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

   否则

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

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

   如果 textureType 为 "texture-array"：

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

   返回 array 并中止这些步骤。

   否则

   使用位于 context 的相关领域中的 2 个新不透明 纹理实例初始化 array，这些实例使用 context 和 init 的 depthFormat、 mipLevels、 viewPixelWidth 和 viewPixelHeight 值创建为 TEXTURE_2D 纹理。

   返回 array 并中止这些步骤。

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

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

11. 返回 array。

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

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

1. 令 session 为此对象的session。

2. 令 context 为此对象的context。

3. 令 layer 为此对象的相关领域中的一个新 XRProjectionLayer。

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

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

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

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

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

   如果 session 创建时使用了“space-warp”特性描述符

   将 layer 的 ignoreDepthValues 初始化为 false

   如果 init 的 depthFormat 为 false 且 XR 合成器将使用深度值

   将 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 的 textureType 和 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 合成器知道由于任何原因无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

21. 返回 layer。

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

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

1. 令 session 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为此对象的context。

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

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

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

7. 令 layer 为此对象的相关领域中的一个新 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 的相关领域中的一个新数组。

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

17. 返回 layer。

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

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

1. 令 session 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为此对象的context。

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

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

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

7. 令 layer 为此对象的相关领域中的一个新 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 的相关领域中的一个新数组。

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

17. 返回 layer。

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

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

1. 令 session 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为此对象的context。

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

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

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

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

8. 如果 init 的 space 的类型为 "viewer"， 则抛出 TypeError 并中止这些步骤。

9. 令 layer 为此对象的相关领域中的一个新 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 的相关领域中的一个新数组。

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

19. 返回 layer。

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

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

1. 令 session 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

3. 令 context 为此对象的context。

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

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

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

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

8. 如果 init 的 space 的类型为 "viewer"， 则抛出 TypeError 并中止这些步骤。

9. 令 layer 为此对象的相关领域中的一个新 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 为此对象的相关领域中的一个新 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 的相关领域中的一个新数组。

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

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

       如果 textureType 为 "texture-array"：

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

       否则

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

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

       如果 textureType 为 "texture-array"：

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

       否则

       使用位于此 XRCubeLayer 的相关领域中的 2 个新不透明纹理实例初始化colorTextures，这些实例使用 context 和 init 的 colorFormat、 viewPixelWidth 和 viewPixelHeight 值创建为 TEXTURE_CUBE_MAP 纹理。

20. 令 layer 的depthStencilTextures 为此 XRCubeLayer 的相关领域中的一个新数组。

21. 令 layer 的motionVectorTextures 为此 XRCubeLayer 的相关领域中的一个新数组。

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

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

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

       如果 textureType 为 "texture-array"：

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

       否则

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

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

       如果 textureType 为 "texture-array"：

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

       否则

       使用位于此 XRCubeLayer 的相关领域中的 2 个新不透明纹理实例初始化 depthStencilTextures，这些实例使用 context 和 init 的 depthFormat、 viewPixelWidth 和 viewPixelHeight 值创建为 TEXTURE_CUBE_MAP 纹理。

23. 如果 XR 合成器知道由于任何原因无法为 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 为此对象的相关领域中的一个新 XRWebGLSubImage。

   令 subimage 的 viewport 为此对象的相关领域中的一个新 XRViewport。

2. 令 session 为此对象的session。

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

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

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

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

7. 令 index 为 0。

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

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

   2. 如果 eye 为 "right"：

      如果 layer 的类型为 XRCubeLayer

      将 index 设置为 6

      否则

      将 index 设置为 1

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

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

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

    使用 index 初始化 subimage 的 imageIndex。

    否则

    使用 0 初始化 subimage 的 imageIndex。

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

    如果 layer 创建时使用的 textureType 为 "texture"

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

    否则

    使用 layer 的colorTextures 数组中的第一个元素 初始化 subimage 的 colorTexture。

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

    如果 layer 的depthStencilTextures 是空数组

    使用 null 初始化 subimage 的 depthStencilTexture。

    否则，如果 layer 创建时使用的 textureType 为 "texture"

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

    否则

    使用 layer 的depthStencilTextures 数组中的第一个元素 初始化 subimage 的 depthStencilTexture。

13. 使用 null 初始化 subimage 的 depthStencilTextureWidth、 depthStencilTextureHeight 和 motionVectorTexture。

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

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

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

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

18. 令 viewsPerTexture 为 1。

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

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

21. 排入一个任务，将 needsRedraw 设置为 false。

22. 返回 subimage。

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

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

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

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

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

   否则

   令 subimage 为此对象的相关领域中的一个新 XRWebGLSubImage。

   令 subimage 的 viewport 为此对象的相关领域中的一个新 XRViewport。

2. 令 frame 为 view 的 frame。

3. 令 session 为此对象的session。

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

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

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

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

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

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

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

   否则

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

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

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

   使用 index 初始化 subimage 的 imageIndex。

   否则

   将 subimage 的 imageIndex 初始化为 0。

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

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

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

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

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

    否则

    使用 layer 的colorTextures 数组中的第一个元素 初始化 subimage 的 colorTexture。

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

    如果 layer 的depthStencilTextures 是空数组

    使用 null 初始化 subimage 的 depthStencilTexture。

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

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

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

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

    否则

    使用 layer 的depthStencilTextures 数组中的第一个元素 初始化 subimage 的 depthStencilTexture。

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

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

    使用 null 初始化 subimage 的 motionVectorTexture。

    否则，如果 layer 创建时使用的 textureType 为 "texture"

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

    否则

    使用 layer 的motionVectorTextures 数组中的第一个元素初始化 subimage 的 motionVectorTexture。

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

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

15. 使用 null 初始化 subimage 的 depthStencilTextureWidth 和 depthStencilTextureHeight。

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

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

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 = {});
};

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

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

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

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

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

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

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

3. 令 binding 为 session 的相关领域中的一个新 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 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

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

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

5. 令 layer 为此对象的相关领域中的一个新 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 合成器知道由于任何原因无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

15. 返回 layer。

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

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

1. 令 session 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

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

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

5. 令 layer 为此对象的相关领域中的一个新 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 合成器知道由于任何原因无法为 layer 创建资源，则抛出 OperationError 并中止这些步骤。

13. 返回 layer。

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

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

1. 令 session 为此对象的session。

2. 如果 session 创建时未启用“layers”， 则抛出 NotSupportedError 并中止这些步骤。

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

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

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

6. 如果 init 的 space 的类型为 "viewer"， 则抛出 InvalidStateError 并中止这些步骤。

7. 令 layer 为此对象的相关领域中的一个新 XREquirectLayer。

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

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

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

11. 使用 layer 和 init 运行初始化等距柱状投影层。

12. 如果 XR 合成器知道由于任何原因无法为 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. 使用位于 session 的相关领域中的一个新空数组初始化 state 的 layers。

此模块替换了 WebXR 规范中“更新待处理的层状态”给出的步骤。相反，当用户代理要使用 XRSession session 和 XRRenderStateInit newState 更新待处理的层状态时，必须运行以下步骤：

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

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

3. 如果设置了 newState 的 baseLayer：

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

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

4. 如果设置了 newState 的 layers：

   1. 如果 newState 的 layers 包含一个其destroyed 布尔值为 true 的 XRCompositionLayer， 则抛出 InvalidStateError 并中止这些步骤。

   2. 如果 session 创建时未启用“layers”，且 newState 的 layers 包含多于 1 个实例，则抛出 NotSupportedError 并中止这些步骤。

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

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

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

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

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

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

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

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

此模块替换了 WebXR 规范中“检查层状态”给出的步骤。相反，要使用 renderState state 检查层 状态，用户代理必须运行以下步骤：

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

2. 对于 state 的 layers 中的每个 layer：

   1. 如果 layer 不是 XRCompositionLayer 或 layer 的destroyed 布尔值为 false，则返回 true。

3. 返回 false。

11.6. XRSession 更改

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

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

maxRenderLayers 表示 合成器必须处理的最大层数，因此也是任何 XRRenderStateInit 的 layers 数组的最大大小。在给定时间内，应当能够创建超过此数量的层。

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

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

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

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

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

   2. 移除 texture 的注视点渲染。