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. thisのセッションをsessionに設定する。

2. contextが定義されている場合、thisのコンテキストをcontextに設定する。

3. thisの破棄済みをfalseに設定する。

4. thisのblendTextureSourceAlpha をtrueに設定する。

5. thisのopacity を1.0に設定する。

destroy() をXRCompositionLayer layer上で呼び出すとき、ユーザーエージェントは次の手順を実行しなければならない:

1. layerの破棄済みがtrueの場合、返る。

2. layerの破棄済みを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;
};

XRQuadLayer layer を XRQuadLayerInit init で initializing an XRQuadLayer するとき、ユーザーエージェントは次の手順を実行しなければなりません:

1. layer の width を init の width に初期化します。

2. layer の height を init の height に初期化します。

3. layer の space を init の space とします。

4. layer の transform を次のように初期化します:

   init の transform が設定されている場合

   layer の transform を、layer の relevant realm 内の new XRRigidTransform とし、init の transform の position および orientation で初期化します。

   それ以外の場合

   layer の transform を、layer の relevant realm 内の new XRRigidTransform とし、{ x: 0.0, y: 0.0, z: 0.0, w: 1.0 } の DOMPointInit position で初期化します。

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;
};

XRCylinderLayer layer を XRCylinderLayerInit init で initializing an XRCylinderLayer するとき、ユーザーエージェントは次の手順を実行しなければなりません:

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 の relevant realm 内の new XRRigidTransform とし、init の transform の position および orientation で初期化します。

   それ以外の場合

   layer の transform を、layer の relevant realm 内の new XRRigidTransform とし、{ x: 0.0, y: 0.0, z: 0.0, w: 1.0 } の DOMPointInit position で初期化します。

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 で setting the space on an equirect layer するとき、ユーザーエージェントは space が有効かを検証するために次の手順を実行しなければなりません:

1. init の space が XRReferenceSpace 型のインスタンスでない場合、TypeError を投げ、これらの手順を中止します。

2. init の space が "viewer" の type を持つ場合、TypeError を投げ、これらの手順を中止します。

3. space および layer で setting the space on a layer を実行します。

XREquirectLayer layer を XREquirectLayerInit init で initializing an XREquirectLayer するとき、ユーザーエージェントは次の手順を実行しなければなりません:

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 の relevant realm 内の new XRRigidTransform とし、init の transform の position および orientation で初期化します。

   それ以外の場合

   layer の transform を、layer の relevant realm 内の new XRRigidTransform とします。

7. layer の isStatic を init の isStatic に初期化します。

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

  // イベント
  attribute EventHandler onredraw;
};

XRSpace space および XRCubeLayer layer で setting the space on an cube layer するとき、ユーザーエージェントは space が有効かを検証するために次の手順を実行しなければなりません:

1. init の space が XRReferenceSpace 型のインスタンスでない場合、TypeError を投げ、これらの手順を中止します。

2. init の space が "viewer" の type を持つ場合、TypeError を投げ、これらの手順を中止します。

3. space および layer で setting the space on a 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 をスローし、これらの手順を中止する。

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは 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 の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context、textureFormat、 numViews を乗算した width、および height を使用して textureType テクスチャとして作成される。

12. layer の layout が stereo-top-bottom の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 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" の場合:

    array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 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 の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context、textureFormat、 stencil、numViews を乗算した width、height を使用して textureType テクスチャとして作成される。

17. layer の layout が stereo-top-bottom の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 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" の場合:

    array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 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 の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context、RGBA16F、 numViews を乗算した width、height を使用して textureType テクスチャとして作成される。

13. layer の layout が stereo-top-bottom の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 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" の場合:

   array を、この context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の colorFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、内部テクスチャを 1 個持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

   それ以外の場合

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の colorFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_2D テクスチャとして作成される。

7. layer の layout が "stereo" の場合:

   textureType が "texture-array" の場合:

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の colorFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、2 レイヤーを持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

   array を返し、これらの手順を中止する。

   それ以外の場合

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 2 個で初期化する。これらのインスタンスは、 context と init の colorFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_2D テクスチャとして作成される。

   array を返し、これらの手順を中止する。

8. layer の layout が stereo-left-right の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の colorFormat、 mipLevels、 viewPixelWidth の 2 倍、および viewPixelHeight の値を使用して textureType テクスチャとして作成される。

9. layer の layout が stereo-top-bottom の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight の 2 倍の値を使用して 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" の場合:

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の depthFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、内部テクスチャを 1 個持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

   それ以外の場合

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の depthFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_2D テクスチャとして作成される。

8. layer の layout が "stereo" の場合:

   textureType が "texture-array" の場合:

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の depthFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、2 レイヤーを持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

   array を返し、これらの手順を中止する。

   それ以外の場合

   array を、context の 関連レルムにある 不透明 テクスチャの 新しいインスタンス 2 個で初期化する。これらのインスタンスは、 context と init の depthFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_2D テクスチャとして作成される。

   array を返し、これらの手順を中止する。

9. layer の layout が stereo-left-right の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の depthFormat、 mipLevels、 viewPixelWidth の 2 倍、および viewPixelHeight の値を使用して textureType テクスチャとして作成される。

10. layer の layout が stereo-top-bottom の場合、 array を、context の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは、 context と init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight の 2 倍の値を使用して textureType テクスチャとして作成される。

11. array を返す。

createProjectionLayer(optional XRProjectionLayerInit init) メソッドは、新しい XRProjectionLayer layer を作成する。

このメソッドが呼び出されたとき、ユーザーエージェントは次の手順を実行しなければならない:

1. session を this の session とする。

2. context を this の context とする。

3. layer を、this の 関連レルムにおける 新しい XRProjectionLayer とする。

4. session の ended 値が true の場合、InvalidStateError をスローし、これらの手順を中止する。

5. context が失われている場合、InvalidStateError をスローし、これらの手順を中止する。

6. layer 上で session および context を使用して コンポジションレイヤーを初期化するを実行する。

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 を 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 の 関連レルムにおける 新しい XRQuadLayer とする。

8. layer 上で session および context を使用して コンポジションレイヤーを初期化するを実行する。

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 を 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 の 関連レルムにおける 新しい XRCylinderLayer とする。

8. layer 上で session および context を使用して コンポジションレイヤーを初期化するを実行する。

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 を 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 の type が "viewer" の場合、 TypeError をスローし、これらの手順を中止する。

9. layer を、this の 関連レルムにおける 新しい XREquirectLayer とする。

10. layer 上で session および context を使用して コンポジションレイヤーを初期化するを実行する。

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 を 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 の type が "viewer" の場合、 TypeError をスローし、これらの手順を中止する。

9. layer を、this の 関連レルムにおける 新しい XRCubeLayer とする。

10. layer 上で session および context を使用して コンポジションレイヤーを初期化するを実行する。

11. layer の space を init の space とする。

12. layer の isStatic を init の isStatic に初期化する

13. layer の orientation を次のように初期化する:

    init の orientation が設定されている場合

    layer の orientation を、init の orientation を使用して fromPoint を実行した結果とする。

    それ以外の場合

    layer の orientation を、this の 関連レルムにおける 新しい 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" の場合:

       colorTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは context と init の colorFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、6 レイヤーを持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

       それ以外の場合

       colorTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは context と init の colorFormat、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_CUBE_MAP テクスチャとして作成される。

    2. それ以外で、layer の layout が "stereo" の場合:

       textureType が "texture-array" の場合:

       colorTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは context と init の colorFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、12 レイヤーを持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

       それ以外の場合

       colorTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 2 個で初期化する。これらのインスタンスは 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" の場合:

       depthStencilTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは context と init の depthFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、6 レイヤーを持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

       それ以外の場合

       depthStencilTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは context と init の depthFormat、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_CUBE_MAP テクスチャとして作成される。

    3. それ以外で、layer の layout が "stereo" の場合:

       textureType が "texture-array" の場合:

       depthStencilTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 1 個で初期化する。このインスタンスは context と init の depthFormat、 mipLevels、 viewPixelWidth、 viewPixelHeight の値を使用し、12 レイヤーを持つ TEXTURE_2D_ARRAY テクスチャとして作成される。

       それ以外の場合

       depthStencilTextures を、この XRCubeLayer の 関連レルムにある 不透明テクスチャの 新しいインスタンス 2 個で初期化する。これらのインスタンスは context と init の depthFormat、 viewPixelWidth、 viewPixelHeight の値を使用して TEXTURE_CUBE_MAP テクスチャとして作成される。

23. XR コンポジターが、何らかの理由で layer 用の リソースを作成できないことを認識している場合、OperationError をスローし、これらの手順を中止する。

24. layer を返す。

XRWebGLBinding binding の XRCompositionLayer layer および XRFrame frame というパラメーターを持つ 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 を次のように初期化する:

   getSubImage() が以前に同じ binding、layer、および eye で呼び出されていた場合、 ユーザーエージェントは次のようにしてもよい

   subimage を、同じ引数による以前の呼び出しで返されたものと同じ XRWebGLSubImage オブジェクトとする。

   それ以外の場合

   subimage を、this の 関連レルムにおける 新しい XRWebGLSubImage とする。

   subimage の viewport を、this の 関連レルムにおける 新しい XRViewport とする。

2. session を this の 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" で作成された場合

    subimage の imageIndex を index で初期化する。

    それ以外の場合

    subimage の imageIndex を 0 で初期化する。

11. subimage の colorTexture を次のように初期化する:

    layer が textureType "texture" で作成された場合

    subimage の colorTexture を、layer の colorTextures 配列のオフセット index にある要素で初期化する。

    それ以外の場合

    subimage の colorTexture を、layer の colorTextures 配列の最初の要素で初期化する。

12. subimage の depthStencilTexture を次のように初期化する:

    layer の depthStencilTextures が空の配列である場合

    subimage の depthStencilTexture を null で初期化する。

    それ以外で layer が textureType "texture" で作成された場合

    subimage の depthStencilTexture を、layer の depthStencilTextures 配列のオフセット index にある要素で初期化する。

    それ以外の場合

    subimage の depthStencilTexture を、layer の depthStencilTextures 配列の最初の要素で初期化する。

13. subimage の depthStencilTextureWidth、 depthStencilTextureHeight、 および motionVectorTexture を null で初期化する。

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 の viewport 上で、 subimage の colorTexture、 layer の layout、 index および viewsPerTexture を使用して ビューポートを初期化するを実行する。

21. needsRedraw を false に設定するための タスクをキューに入れる。

22. subimage を返す。

getViewSubImage(XRProjectionLayer layer, XRView view) メソッドは、新しい XRWebGLSubImage を作成する。

このメソッドが XRWebGLBinding binding 上で呼び出されたとき、次の手順を実行しなければならない:

1. subimage を次のように初期化する:

   getViewSubImage() が以前に同じ binding、layer、および view で呼び出されていた場合、ユーザーエージェントは次のようにしてもよい

   subimage を、同じ引数による以前の呼び出しで返されたものと同じ XRWebGLSubImage オブジェクトとする。

   それ以外の場合

   subimage を、this の 関連レルムにおける 新しい XRWebGLSubImage とする。

   subimage の viewport を、this の 関連レルムにおける 新しい XRViewport とする。

2. frame を view の frame とする。

3. session を this の 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 の view のオフセットとする。

   それ以外の場合

   index を、セカンダリビューを除いた session の ビューのリスト内における view の view のオフセットとする。

9. subimage の imageIndex を次のように初期化する:

   layer が textureType "texture-array" で作成された場合:

   subimage の imageIndex を index で初期化する。

   それ以外の場合

   subimage の imageIndex を 0 に初期化する。

10. subimage の colorTexture を次のように初期化する:

    view が session の ビューのリストに由来する セカンダリビューである場合

    subimage の colorTexture を、layer の セカンダリビュー用の colorTextures のオフセット index にある要素で初期化する。

    それ以外で、layer の layout が "default" であり、layer が textureType "texture" で作成された場合

    subimage の colorTexture を、layer の colorTextures 配列のオフセット index にある要素で初期化する。

    それ以外の場合

    subimage の colorTexture を、layer の colorTextures 配列の最初の要素で初期化する。

11. subimage の depthStencilTexture を次のように初期化する:

    layer の depthStencilTextures が空の配列である場合

    subimage の depthStencilTexture を null で初期化する。

    それ以外で、view が session の ビューのリストに由来する セカンダリビューである場合

    subimage の colorTexture を、layer の セカンダリビュー用の depthStencilTextures のオフセット index にある要素で初期化する。

    それ以外で、layer の layout が "default" であり、layer が textureType "texture" で作成された場合

    subimage の depthStencilTexture を、layer の depthStencilTextures 配列のオフセット index にある要素で初期化する。

    それ以外の場合

    subimage の depthStencilTexture を、layer の depthStencilTextures 配列の最初の要素で初期化する。

12. subimage の motionVectorTexture を次のように初期化する:

    layer の motionVectorTextures が空の配列であるか、view が session の ビューのリストに由来する セカンダリビューである場合

    subimage の motionVectorTexture を null で初期化する。

    それ以外で layer が textureType "texture" で作成された場合

    subimage の motionVectorTexture を、layer の motionVectorTextures 配列のオフセット index にある要素で初期化する。

    それ以外の場合

    subimage の motionVectorTexture を、layer の motionVectorTextures 配列の最初の要素で初期化する。

13. subimage の colorTextureWidth を subimage の colorTexture のピクセル幅に設定する。

14. subimage の colorTextureHeight を subimage の colorTexture のピクセル高さに設定する。

15. subimage の depthStencilTextureWidth および depthStencilTextureHeight を null で初期化する。

16. subimage の depthStencilTexture が null でない場合、subimage の depthStencilTextureWidth を depthStencilTexture 配列内の最初のテクスチャのピクセル幅に設定する。

17. subimage の depthStencilTexture が null でない場合、subimage の depthStencilTextureHeight を depthStencilTexture 配列内の最初のテクスチャのピクセル高さに設定する。

18. subimage の viewport 上で、 subimage の colorTexture、 layer の layout、 index、および session の ビューのリストの数を使用して ビューポートを初期化するを実行する。

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. layer を media 要素の内容で塗りつぶす。

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 を this の session とする。

2. session が「layers」 を有効にして作成されていない場合、NotSupportedError をスローし、これらの手順を中止する。

3. session の ended 値が true の場合、InvalidStateError をスローし、これらの手順を中止する。

4. init の layout が "default" の場合、 TypeError をスローし、これらの手順を中止する。

5. layer を、this の 関連レルムにおける 新しい XRQuadLayer とする。

6. layer 上で session を使用して コンポジションレイヤーを初期化するを実行する。

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 を this の session とする。

2. session が「layers」 を有効にして作成されていない場合、NotSupportedError をスローし、これらの手順を中止する。

3. session の ended 値が true の場合、InvalidStateError をスローし、これらの手順を中止する。

4. init の layout が "default" の場合、 TypeError をスローし、これらの手順を中止する。

5. layer を、this の 関連レルムにおける 新しい XRCylinderLayer とする。

6. layer 上で session を使用して コンポジションレイヤーを初期化するを実行する。

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 を this の session とする。

2. session が「layers」 を有効にして作成されていない場合、NotSupportedError をスローし、これらの手順を中止する。

3. session の ended 値が true の場合、InvalidStateError をスローし、これらの手順を中止する。

4. init の layout が "default" の場合、 TypeError をスローし、これらの手順を中止する。

5. init の space が型 XRReferenceSpace のインスタンスでない場合、InvalidStateError をスローし、これらの手順を中止する。

6. init の space の type が "viewer" の場合、 InvalidStateError をスローし、これらの手順を中止する。

7. layer を、this の 関連レルムにおける 新しい XREquirectLayer とする。

8. layer 上で session を使用して コンポジションレイヤーを初期化するを実行する。

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. state の layers を、session の 関連レルムにある 新しい空の配列で初期化する。

このモジュールは、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 は、そのセッションを使用して作成された各 XRWebGLBinding への弱参照を保持する内部 WeakSet bindings を持つ。

このモジュールは、WebXR 仕様の「セッションを シャットダウンする」に手順を追加する。 次をリストに追加する:

1. session| の bindings 内の各 binding について:

   1. binding の foveatedTextures 内の各 texture について:

   2. texture からフォービエーションを削除する。