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 について、the underlying resources of a layer are lost 場合、 ユーザーエージェントは次の手順を実行しなければなりません:

1. layer の needsRedraw を true に設定します。

2. layer が XRProjectionLayer でない場合、タスクをキューに入れ、XRLayerEvent を使用して、layer 上で redraw という名前のイベントを発火します。

XRSession session および任意の WebGLRenderingContext または WebGL2RenderingContext context のインスタンスで initialize a composition layer するには、 ユーザーエージェントは次の手順を実行しなければなりません:

1. this の session を session に設定します。

2. context が定義されている場合、this の context を context に設定します。

3. this の blendTextureSourceAlpha を true に設定します。

4. this の opacity を 1.0 に設定します。

destroy() を呼び出すとき、ユーザーエージェントは次の手順を実行しなければなりません:

1. this の colorTextures 配列を空の配列に設定します。

2. this の depthStencilTextures 配列を空の配列に設定します。

3. 基礎となる GL アタッチメントを破棄します。

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

1. space が null の場合、TypeError を投げ、これらの手順を中止します。

2. space の session が layer の session と等しくない場合、TypeError を投げ、これらの手順を中止します。

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

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

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

  attribute float width;
  attribute float height;

  // Events
  attribute EventHandler onredraw;
};

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;

  // Events
  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;

  // Events
  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;

  // Events
  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;
  readonly attribute unsigned long? motionVectorTextureWidth;
  readonly attribute unsigned long? motionVectorTextureHeight;
};

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

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

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

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

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

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

dictionary XRCubeLayerInit : XRLayerInit {
  DOMPointReadOnly? orientation;
};

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

  readonly attribute double nativeProjectionScaleFactor;
  readonly attribute boolean usesDepthValues;

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

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

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

XRWebGLBinding(session, context) コンストラクターは、呼び出されたときに次の手順を実行しなければなりません:

1. binding を、session の relevant realm 内の new XRWebGLBinding とします。

2. session の ended 値が true の場合、InvalidStateError を投げ、これらの手順を中止します。

3. context が lost である場合、InvalidStateError を投げ、これらの手順を中止します。

4. session が immersive session でない場合、InvalidStateError を投げ、これらの手順を中止します。

5. context の XR compatible boolean が false の場合、InvalidStateError を投げ、これらの手順を中止します。

6. binding の context を context に初期化します。

7. binding の session を session に初期化します。

8. binding を session の bindings に追加します。

9. binding を返します。

XRTextureType textureType、XRWebGLRenderingContext context、および XRLayerLayout layout を用いて determine the layout attribute するには、ユーザーエージェントは 次の手順を実行しなければなりません:

1. context が WebGL2RenderingContext でなく、かつ textureType が "texture-array" である場合、TypeError を投げ、これらの手順を中止します。

2. textureType が "texture-array" であり、かつセッションの list of views 内のすべての views が同じ recommended WebGL color texture resolution を持たない場合、NotSupportedError を投げ、これらの手順を中止します。

3. layout が "mono" である場合、layout を返し、これらの手順を中止します。

4. layout が "default" である場合、次の手順を実行します:

   1. list of views のサイズが 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 を用いて determine the maximum scalefactor するには、ユーザーエージェントは 次の手順を実行しなければなりません:

1. largest width を、secondary views を除く、session の list of views からの recommended WebGL color texture resolution の最大幅とします。

2. largest height を、secondary views を除く、session の list of views からの recommended WebGL color texture resolution の最大高さとします。

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 を用いて allocate color textures for projection layers するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. array を、context の relevant realm 内の new array とします。

2. context を layer の context とします。

3. session を layer の session とします。

4. numViews を、secondary views を除く、session の list of views の数とします。

5. view を、session の list of views 内の、secondary views でない最初のエントリーとします。

6. width を、view の recommended WebGL color texture resolution の幅に scaleFactor を掛けたものとします。

7. height を、view の recommended WebGL color texture resolution の高さに scaleFactor を掛けたものとします。

8. textureFormat が list of color formats for projection layers に含まれない場合、NotSupportedError を投げ、これらの手順を中止します。

9. layer の layout が "mono" または "default" である場合:

   textureType が "texture-array" である場合:

   セッションの list of views 内の views が、secondary views を除いて、すべて同じ recommended WebGL color texture resolution を持たない場合、NotSupportedError を投げ、これらの手順を中止します。

   array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、textureFormat、 width、および height を使用して、numViews レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

   opaque texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

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

   それ以外の場合

   session の list of views 内の各 view について:

   1. view が secondary view である場合、継続します。

   2. width を、view の recommended WebGL color texture resolution の幅に scaleFactor を掛けたものとします。

   3. height を、view の recommended WebGL color texture resolution の高さに scaleFactor を掛けたものとします。

   4. texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、textureFormat、width および height を使用して、TEXTURE_2D texture として作成されます。

   5. texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

   6. texture を array に追加します。

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

10. セッションの list of views 内の views が、secondary views を除いて、すべて同じ recommended WebGL color texture resolution を持たない場合、NotSupportedError を投げ、これらの手順を中止します。

11. layer の layout が stereo-left-right である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、textureFormat、 numViews multiplied by width および height を使用して、 textureType texture として作成されます。

12. layer の layout が stereo-top-bottom である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、textureFormat、 width および numViews multiplied by height を使用して、 textureType texture として作成されます。

13. opaque texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

14. array を返します。

XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat、および float scaleFactor を用いて allocate depth textures for projection layers するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. array を、context の relevant realm 内の new array とします。

2. context を layer の context とします。

3. session を layer の session とします。

4. textureFormat が 0 の場合、array を返し、これらの手順を中止します。

5. context が WebGLRenderingContext であり、かつ WEBGL_depth_texture extension が context 内で有効化されていない場合、 array を返し、これらの手順を中止します。

6. textureFormat が list of depth formats for projection layers に含まれない場合、NotSupportedError を投げ、これらの手順を中止します。

7. numViews を、secondary views を除く、session の list of views の数とします。

8. view を、session の list of views 内の、secondary view でない最初のエントリーとします。

9. width を、view の recommended WebGL depth texture resolution の幅に scaleFactor を掛けたものとします。

10. height を、view の recommended WebGL depth texture resolution の高さに scaleFactor を掛けたものとします。

11. layer の layout が "mono" または "default" である場合:

    textureType が "texture-array" である場合:

    array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、textureFormat、 stencil、width および height を使用して、numViews レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

    opaque texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

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

    それ以外の場合

    session の list of views 内の各 view について:

    1. view が secondary view である場合、継続します。

    2. width を、view の recommended WebGL depth texture resolution の幅に scaleFactor を掛けたものとします。

    3. height を、view の recommended WebGL depth texture resolution の高さに scaleFactor を掛けたものとします。

    4. texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、textureFormat、stencil、 width および height を使用して、TEXTURE_2D texture として作成されます。

    5. texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

    6. texture を array に追加します。

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

12. セッションの list of views 内の views が、secondary views を除いて、すべて同じ recommended WebGL color texture resolution を持たない場合、NotSupportedError を投げ、これらの手順を中止します。

13. layer の layout が stereo-left-right である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、textureFormat、 stencil、numViews multiplied by width および height を使用して、 textureType texture として作成されます。

14. layer の layout が stereo-top-bottom である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、textureFormat、 stencil、width および numViews multiplied by height を使用して、 textureType texture として作成されます。

15. opaque texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

16. array を返します。

XRProjectionLayer layer を用いて allocate motion vector textures for projection layers するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. array を、context の new array とします。

2. context を layer の context とします。

3. session を layer の session とします。

4. session が "space-warp" feature descriptor とともに作成されていなかった場合、 array を返し、これらの手順を中止します。

5. context が WebGLRenderingContext であり、かつ WEBGL_depth_texture extension が context 内で有効化されていない場合、 array を返し、これらの手順を中止します。

6. numViews を、secondary views を除く、session の list of views の数とします。

7. view を、session の list of views 内の、secondary view でない最初のエントリーとします。

8. width を、view の recommended motion vector texture resolution の幅に scaleFactor を掛けたものとします。

9. height を、view の recommended motion vector texture resolution の高さに scaleFactor を掛けたものとします。

10. layer の layout が "mono" または "default" である場合:

    textureType が "texture-array" である場合:

    array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、RGBA16F、 width および height を使用して、numViews レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

    opaque texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

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

    それ以外の場合

    session の list of views 内の各 view について:

    1. view が secondary view である場合、継続します。

    2. width を、view の recommended motion vector texture resolution の幅に scaleFactor を掛けたものとします。

    3. height を、view の recommended motion vector texture resolution の高さに scaleFactor を掛けたものとします。

    4. texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、RGBA16F、 width および height を使用して、TEXTURE_2D texture として作成されます。

    5. texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

    6. texture を array に追加します。

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

11. セッションの list of views 内の views が、secondary views を除いて、すべて同じ recommended motion vector texture resolution を持たない場合、NotSupportedError を投げ、これらの手順を中止します。

12. layer の layout が stereo-left-right である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、RGBA16F、 numViews multiplied by width および height を使用して、 textureType texture として作成されます。

13. layer の layout が stereo-top-bottom である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context、RGBA16F、 width および numViews multiplied by height を使用して、 textureType texture として作成されます。

14. opaque texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

15. array を返します。

XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat、および float scaleFactor を用いて allocate the color textures for the secondary views するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. context を layer の context とします。

2. session を layer の session とします。

3. array を、context の relevant realm 内の new array とします。

4. textureFormat が list of color formats for projection layers に含まれない場合、NotSupportedError を投げ、これらの手順を中止します。

5. session の list of views 内の各 view について:

   1. view が secondary view でない場合、継続します。

   2. width を、view の recommended WebGL color texture resolution の幅に scaleFactor を掛けたものとします。

   3. height を、view の recommended WebGL color texture resolution の高さに scaleFactor を掛けたものとします。

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

      textureType が "texture-array" である場合:

      texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、textureFormat、width および height を使用して、TEXTURE_2D_ARRAY texture として作成されます。

      それ以外の場合

      texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、textureFormat、width および height を使用して、TEXTURE_2D texture として作成されます。

   5. texture を何らかの理由で作成できなかった場合、OperationError を投げ、これらの手順を中止します。

   6. texture を array に追加します。

6. array を返し、これらの手順を中止します。

XRProjectionLayer layer、XRTextureType textureType、GLenum textureFormat、および float scaleFactor を用いて allocate the depth textures for the secondary views するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. context を layer の context とします。

2. session を layer の session とします。

3. textureFormat が 0 の場合、array を返し、これらの手順を中止します。

4. context が WebGLRenderingContext であり、かつ WEBGL_depth_texture extension が context 内で有効化されていない場合、 array を返し、これらの手順を中止します。

5. textureFormat が list of depth formats for projection layers に含まれない場合、NotSupportedError を投げ、これらの手順を中止します。

6. array を、context の relevant realm 内の new array とします。

7. session の list of views 内の各 view について:

   1. view が secondary view でない場合、継続します。

   2. width を、view の recommended WebGL depth texture resolution の幅に scaleFactor を掛けたものとします。

   3. height を、view の recommended WebGL depth texture resolution の高さに scaleFactor を掛けたものとします。

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

      textureType が "texture-array" である場合:

      texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、textureFormat、stencil、 width および height を使用して、TEXTURE_2D_ARRAY texture として作成されます。

      それ以外の場合

      texture を、context の relevant realm 内の new opaque texture のインスタンスとします。これは、 context、textureFormat、stencil、 width および height を使用して、TEXTURE_2D texture として作成されます。

   5. texture を array に追加します。

8. array を返し、これらの手順を中止します。

XRCompositionLayer layer、XRTextureType textureType、および XRLayerInit init を用いて allocate color textures するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. array を、context の new array とします。

2. context を layer の context とします。

3. init の colorFormat が list of color formats for non-projection layers に含まれない場合、NotSupportedError を投げ、これらの手順を中止します。

4. init の mipLevels が 1 より小さい場合、InvalidStateError を投げ、これらの手順を中止します。

5. init の mipLevels が 1 より大きく、かつ viewPixelWidth および viewPixelHeight が 2 の累乗でない場合、InvalidStateError を投げ、これらの手順を中止します

6. layer の layout が "mono" である場合:

   textureType が "texture-array" である場合:

   array を、この context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、1 つの内部 texture を持つ TEXTURE_2D_ARRAY texture として作成されます。

   それ以外の場合

   array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_2D texture として作成されます。

7. layer の layout が "stereo" である場合:

   textureType が "texture-array" である場合:

   array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、2 レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

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

   それ以外の場合

   array を、context の relevant realm 内の new opaque texture インスタンス 2 個で初期化します。これは、context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_2D texture として作成されます。

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

8. layer の layout が stereo-left-right である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の colorFormat、 mipLevels、 viewPixelWidth の 2 倍および viewPixelHeight 値を使用して、textureType texture として作成されます。

9. layer の layout が stereo-top-bottom である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight の 2 倍の値を使用して、textureType texture として作成されます。

10. array を返します。

XRCompositionLayer layer、XRTextureType textureType、および XRLayerInit init を用いて allocate depth textures するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. array を、context の new array とします。

2. context を layer の context とします。

3. init の depthFormat が設定されていない場合、array を返し、これらの手順を中止します。

4. init の depthFormat が list of depth formats for non-projection layers に含まれない場合、NotSupportedError を投げ、これらの手順を中止します。

5. init の mipLevels が 1 より小さい場合、InvalidStateError を投げ、これらの手順を中止します。

6. init の mipLevels が 1 より大きく、かつ viewPixelWidth および viewPixelHeight が 2 の累乗でない場合、InvalidStateError を投げ、これらの手順を中止します。

7. layer の layout が "mono" である場合:

   textureType が "texture-array" である場合:

   array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、1 つの内部 texture を持つ TEXTURE_2D_ARRAY texture として作成されます。

   それ以外の場合

   array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_2D texture として作成されます。

8. layer の layout が "stereo" である場合:

   textureType が "texture-array" である場合:

   array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、2 レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

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

   それ以外の場合

   array を、context の relevant realm 内の new opaque texture インスタンス 2 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_2D texture として作成されます。

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

9. layer の layout が stereo-left-right である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth の 2 倍および viewPixelHeight 値を使用して、textureType texture として作成されます。

10. layer の layout が stereo-top-bottom である場合、array を、context の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight の 2 倍の値を使用して、textureType texture として作成されます。

11. array を返します。

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

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

1. session を、this の session とします。

2. context を、this の context とします。

3. layer を、this の relevant realm 内の new XRProjectionLayer とします。

4. session の ended 値が true の場合、InvalidStateError を投げ、これらの手順を中止します。

5. context が lost である場合、InvalidStateError を投げ、これらの手順を中止します。

6. layer に対して、session および context を指定して initialize a composition layer を実行します。

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

8. layer の ignoreDepthValues を次のように初期化します:

   init の depthFormat が false であり、かつ XR Compositor が depth values を使用する場合

   layer の ignoreDepthValues を false に初期化します

   それ以外の場合

   layer の ignoreDepthValues を true に初期化します

9. layer の fixedFoveation を 0 に初期化します。

10. layout を、init の textureType、 context および "default" を指定して determining the layout attribute した結果とします。

11. maximum scalefactor を、session、context および layout を指定して determining the maximum 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 を指定して allocating color textures for projection layers した結果とします。

16. layer の depthStencilTextures を、layer、 init の textureType、 init の depthFormat および init の scaleFactor を指定して allocating depth textures for projection layers した結果とします。

17. layer の motionVectorTextures を、layer、 init の depthFormat および init の scaleFactor を指定して allocating motion vector textures for projection layers した結果とします。

18. colortextures for secondary views を次のように初期化します:

    session が "secondary-views" を有効にして作成された場合

    colortextures for secondary views を、layer、init の textureType、 init の colorFormat および init の scaleFactor を指定して allocate the color textures for the secondary views した結果とします。

    それ以外の場合

    colortextures for secondary views を null とします。

19. depthstenciltextures for secondary views を次のように初期化します:

    session が "secondary-views" を有効にして作成された場合

    depthstenciltextures for secondary views を、layer、init の textureType、 init の depthFormat および init の scaleFactor を指定して allocate the depth textures for the secondary views した結果とします。

    それ以外の場合

    depthstenciltextures for secondary views を null とします。

20. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

21. layer を返します。

createQuadLayer(XRQuadLayerInit init) メソッドは、新しい XRQuadLayer layer を作成します。

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

1. session を、this の session とします。

2. session が "layers" を有効にして作成されていなかった場合、NotSupportedError を投げ、これらの手順を中止します。

3. context を、this の context とします。

4. session の ended 値が true の場合、InvalidStateError を投げ、これらの手順を中止します。

5. context が lost である場合、InvalidStateError を投げ、これらの手順を中止します。

6. layout が "default" である場合、TypeError を投げ、これらの手順を中止します。

7. layer を、this の relevant realm 内の new XRQuadLayer とします。

8. layer に対して、session および context を指定して initialize a composition layer を実行します。

9. layer および init を指定して initialize a quad layer を実行します。

10. layout を、init の textureType、 context および init の layout を指定して determining the layout attribute した結果とします。

11. layer の layout を layout に初期化します。

12. layer の needsRedraw を true に初期化します。

13. layer の colorTextures を、layer、init の textureType および init を指定して allocating color textures した結果とします。

14. layer の depthStencilTextures を、layer、 init の textureType および init を指定して allocating depth textures した結果とします。

15. layer の motionVectorTextures を、context の relevant realm 内の new array とします。

16. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

17. layer を返します。

createCylinderLayer(XRCylinderLayerInit init) メソッドは、新しい XRCylinderLayer layer を作成します。

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

1. session を、this の session とします。

2. session が "layers" を有効にして作成されていなかった場合、NotSupportedError を投げ、これらの手順を中止します。

3. context を、this の context とします。

4. session の ended 値が true の場合、InvalidStateError を投げ、これらの手順を中止します。

5. context が lost である場合、InvalidStateError を投げ、これらの手順を中止します。

6. layout が "default" である場合、TypeError を投げ、これらの手順を中止します。

7. layer を、this の relevant realm 内の new XRCylinderLayer とします。

8. layer に対して、session および context を指定して initialize a composition layer を実行します。

9. layer および init を指定して initialize a cylinder layer を実行します。

10. layout を、init の textureType、 context および init の layout を指定して determining the layout attribute した結果とします。

11. layer の layout を layout に初期化します。

12. layer の needsRedraw を true に初期化します。

13. layer の colorTextures を、layer、init の textureType および init を指定して allocating color textures した結果とします。

14. layer の depthStencilTextures を、layer、 init の textureType および init を指定して allocating depth textures した結果とします。

15. layer の motionVectorTextures を、context の relevant realm 内の new array とします。

16. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

17. layer を返します。

createEquirectLayer(XREquirectLayerLayerInit init) メソッドは、新しい XREquirectLayer layer を作成します。

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

1. session を、this の session とします。

2. session が "layers" を有効にして作成されていなかった場合、NotSupportedError を投げ、これらの手順を中止します。

3. context を、this の context とします。

4. session の ended 値が true の場合、InvalidStateError を投げ、これらの手順を中止します。

5. context が lost である場合、InvalidStateError を投げ、これらの手順を中止します。

6. layout が "default" である場合、TypeError を投げ、これらの手順を中止します。

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

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

9. layer を、this の relevant realm 内の new XREquirectLayer とします。

10. layer に対して、session および context を指定して initialize a composition layer を実行します。

11. layer および init を指定して initialize a equirect layer を実行します。

12. layout を、init の textureType、 context および init の layout を指定して determining the layout attribute した結果とします。

13. layer の layout を layout に初期化します。

14. layer の needsRedraw を true に初期化します。

15. layer の colorTextures を、layer、init の textureType および init を指定して allocating color textures した結果とします。

16. layer の depthStencilTextures を、layer、 init の textureType および init を指定して allocating depth textures した結果とします。

17. layer の motionVectorTextures を、context の relevant realm 内の new array とします。

18. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

19. layer を返します。

createCubeLayer(XRCubeLayerInit init) メソッドは、新しい XRCubeLayer layer を作成します。

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

1. session を、this の session とします。

2. session が "layers" を有効にして作成されていなかった場合、NotSupportedError を投げ、これらの手順を中止します。

3. context を、this の context とします。

4. session の ended 値が true の場合、InvalidStateError を投げ、これらの手順を中止します。

5. context が WebGL2RenderingContext context でない場合、InvalidStateError を投げ、これらの手順を中止します。

6. context が lost である場合、InvalidStateError を投げ、これらの手順を中止します。

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

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

9. layer を、this の relevant realm 内の new XRCubeLayer とします。

10. layer に対して、session および context を指定して initialize a composition layer を実行します。

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

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

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

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

    layer の orientation を、init の orientation を指定して fromPoint を実行した結果とします。

    それ以外の場合

    layer の orientation を、this の relevant realm 内の new 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 の relevant realm 内の new array とします。

19. layout の値に基づき、layer の colorTextures を次のように初期化します:

    1. layer の layout が "mono" である場合:

       textureType が "texture-array" である場合:

       colorTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、 context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、6 レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

       それ以外の場合

       colorTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、 context および init の colorFormat、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_CUBE_MAP texture として作成されます。

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

       textureType が "texture-array" である場合:

       colorTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、 context および init の colorFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、12 レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

       それ以外の場合

       colorTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 2 個で初期化します。これは、 context および init の colorFormat、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_CUBE_MAP texture として作成されます。

20. layer の depthStencilTextures を、この XRCubeLayer の relevant realm 内の new array とします。

21. layer の motionVectorTextures を、この XRCubeLayer の relevant realm 内の new array とします。

22. init の depthFormat が設定されている場合、layer の depthStencilTextures を次のように初期化します:

    1. context が WebGL2RenderingContext でなく、かつ WEBGL_depth_texture extension が context 内で有効化されていない場合、 TypeError を投げ、これらの手順を中止します。

    2. layer の layout が "mono" である場合:

       textureType が "texture-array" である場合:

       depthStencilTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、6 レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

       それ以外の場合

       depthStencilTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_CUBE_MAP texture として作成されます。

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

       textureType が "texture-array" である場合:

       depthStencilTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 1 個で初期化します。これは、context および init の depthFormat、 mipLevels、 viewPixelWidth および viewPixelHeight 値を使用して、12 レイヤーを持つ TEXTURE_2D_ARRAY texture として作成されます。

       それ以外の場合

       depthStencilTextures を、この XRCubeLayer の relevant realm 内の new opaque texture インスタンス 2 個で初期化します。これは、context および init の depthFormat、 viewPixelWidth および viewPixelHeight 値を使用して、TEXTURE_CUBE_MAP texture として作成されます。

23. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

24. layer を返します。

XRCompositionLayer layer および XRFrame frame のパラメーターを持つ XRWebGLBinding binding の validate the state of the XRWebGLSubImage creation function を実行するには、ユーザーエージェントは次の手順を 実行しなければなりません:

1. frame の session が layer の session と等しくない場合、false を返し、これらの手順を中止します。

2. frame の active boolean が false の場合、 false を返し、これらの手順を中止します。

3. frame の animationFrame boolean が false の場合、 false を返し、これらの手順を中止します。

4. binding の session が layer の session と等しくない場合、false を返し、これらの手順を中止します。

5. binding の context が layer の context と等しくない場合、false を返し、これらの手順を中止します。

6. layer の colorTextures array が空または存在しない場合、 false を返し、これらの手順を中止します。

7. layer の isStatic が true であり、かつ layer の needsRedraw が false である場合、false を返し、これらの手順を中止します。

8. true を返します。

opaque texture texture、XRLayerLayout layout、integer offset および integer num を用いて、XRViewport viewport の initialize the 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 の relevant realm 内の new XRWebGLSubImage とします。

   subimage の viewport を、this の relevant realm 内の new XRViewport とします。

2. session を、this の session とします。

3. layer が session の layers array 内にない場合、TypeError を投げ、これらの手順を中止します。

4. layer の型が XRProjectionLayer である場合、TypeError を投げ、これらの手順を中止します。

5. layer の layout 属性が "default" である場合、TypeError を投げ、これらの手順を中止します。

6. index を 0 とします。

7. layer の layout 属性が "stereo" である場合:

   1. eye が "none" である場合、TypeError を投げ、これらの手順を中止します。

   2. eye が "right" である場合:

      layer が XRCubeLayer 型である場合

      index を 6 に設定します

      それ以外の場合

      index を 1 に設定します

8. layer および frame を指定して validate the state of the XRWebGLSubImage creation function した結果が false である場合、InvalidStateError を投げ、これらの手順を中止します。

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

   layer が "texture-array" の textureType で作成されていた場合

   subimage の imageIndex を index で初期化します。

   それ以外の場合

   subimage の imageIndex を 0 で初期化します。

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

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

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

    それ以外の場合

    subimage の colorTexture を、layer の colorTextures array の最初の要素で 初期化します。

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

    layer の depthStencilTextures が空の array である場合

    subimage の depthStencilTexture を null で初期化します。

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

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

    それ以外の場合

    subimage の depthStencilTexture を、layer の depthStencilTextures array の最初の要素で初期化します。

12. subimage の motionVectorTexture、 motionVectorTextureWidth および motionVectorTextureHeight を null で初期化します。

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

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

15. subimage の depthStencilTexture が null でない場合、subimage の depthStencilTextureWidth を、depthStencilTexture array 内の最初の texture のピクセル幅に設定します。

16. subimage の depthStencilTexture が null でない場合、subimage の depthStencilTextureHeight を、depthStencilTexture array 内の最初の texture のピクセル高さに設定します。

17. viewsPerTexture を 1 とします。

18. layer の layout 属性が "stereo-left-right" または "stereo-top-bottom" である場合、viewsPerTexture を 2 に設定します。

19. subimage の viewport に対して、subimage の colorTexture、 layer の layout、 index および viewsPerTexture を指定して initialize the viewport を実行します。

20. needsRedraw を false に設定するために、task をキューに入れます。

21. subimage を返します。

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

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

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

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

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

   それ以外の場合

   subimage を、this の relevant realm 内の new XRWebGLSubImage とします。

   subimage の viewport を、this の relevant realm 内の new XRViewport とします。

2. frame を view の frame とします。

3. session を、this の session とします。

4. layer および frame を指定して validate the state of the XRWebGLSubImage creation function した結果が false である場合、InvalidStateError を投げ、これらの手順を中止します。

5. layer が session の layers array 内にない場合、TypeError を投げ、これらの手順を中止します。

6. view の active flag が false である場合、InvalidStateError を投げ、これらの手順を中止します。

7. index を次のように初期化します:

   view が、session の list of views からの secondary view である場合

   index を、primary views を除いた session の list of views 内における view の view のオフセットとします。

   それ以外の場合

   index を、secondary views を除いた session の list of views 内における view の view のオフセットとします。

8. subimage の imageIndex を次のように初期化します:

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

   subimage の imageIndex を index で初期化します。

   それ以外の場合

   subimage の imageIndex を 0 に初期化します。

9. subimage の colorTexture を次のように初期化します:

   view が、session の list of views からの secondary view である場合

   subimage の colorTexture を、layer の colorTextures for secondary views のオフセット index にある要素で初期化します。

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

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

   それ以外の場合

   subimage の colorTexture を、layer の colorTextures array の最初の要素で 初期化します。

10. subimage の depthStencilTexture を次のように初期化します:

    layer の depthStencilTextures が空の array である場合

    subimage の depthStencilTexture を null で初期化します。

    それ以外の場合で、view が、session の list of views からの secondary view である場合

    subimage の colorTexture を、layer の depthStencilTextures for secondary views のオフセット index にある要素で初期化します。

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

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

    それ以外の場合

    subimage の depthStencilTexture を、layer の depthStencilTextures array の最初の要素で 初期化します。

11. subimage の motionVectorTexture を次のように初期化します:

    layer の motionVectorTextures が空の array であるか、または view が session の list of views からの secondary view である場合

    subimage の motionVectorTexture を null で初期化します。

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

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

    それ以外の場合

    subimage の motionVectorTexture を、layer の motionVectorTextures array の最初の要素で初期化します。

12. subimage の colorTextureWidth を、subimage の colorTexture のピクセル幅に設定します。

13. subimage の colorTextureHeight を、subimage の colorTexture のピクセル高さに設定します。

14. subimage の depthStencilTexture が null でない場合、subimage の depthStencilTextureWidth を、depthStencilTexture array 内の最初の texture のピクセル幅に設定します。

15. subimage の depthStencilTexture が null でない場合、subimage の depthStencilTextureHeight を、depthStencilTexture array 内の最初の texture のピクセル高さに設定します。

16. subimage の motionVectorTexture が null でない場合、subimage の motionVectorTextureWidth を、motionVectorTexture array 内の最初の texture のピクセル幅に設定します。

17. subimage の motionVectorTexture が null でない場合、subimage の motionVectorTextureHeight を、motionVectorTexture array 内の最初の texture のピクセル高さに設定します。

18. subimage の viewport に対して、subimage の colorTexture、 layer の layout、 index および session の list of views の数を指定して、initialize the viewport を実行します。

19. needsRedraw を false に設定します。

20. subimage を返します

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

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

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

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

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

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

XRCompositionLayer layer が、HTMLVideoElement media とともにレンダリングされる必要がある場合、ユーザーエージェントは次の手順を 実行しなければなりません:

1. usability を、media の usability を確認した結果とします。

2. usability が bad である場合、layer を transparent black で塗りつぶし、これらの手順を中止します。

3. layer を media 要素のコンテンツで塗りつぶします。

XRMediaBinding(XRSession session) コンストラクターは、呼び出されたときに次の手順を実行しなければなりません:

1. session の ended 値が true である場合、InvalidStateError を投げ、これらの手順を中止します。

2. session が immersive session でない場合、InvalidStateError を投げ、これらの手順を中止します。

3. binding を、session の relevant realm 内の new XRMediaBinding とします。

4. binding の session を session に初期化します。

5. binding を返します。

HTMLVideoElement video と XRLayerLayout layout の calculate the aspect ratio を実行するには、次の手順を実行します:

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 の relevant realm 内の new XRQuadLayer とします。

6. layer に対して、session を指定して initialize a composition layer を実行します。

7. layer の media を video に初期化します。

8. layer の needsRedraw を false に初期化します。

9. aspectRatio を、video および init の layout を指定して calculate the aspect ratio した結果とします。

10. init の width および height が undefined である場合、width を 1 に設定します。

11. init の height が undefined である場合、height を width を aspectRatio で割った値に設定します。

12. init の width が undefined である場合、width を height に aspectRatio を掛けた値に設定します。

13. layer および init を指定して initialize a quad layer を実行します。

14. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

15. layer を返します。

createCylinderLayer(HTMLVideoElement video, XRMediaCylinderLayerInit init) メソッドは、新しい XRCylinderLayer layer を作成します。

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

1. session を、this の session とします。

2. session が "layers" を有効にして作成されていなかった場合、NotSupportedError を投げ、これらの手順を中止します。

3. session の ended 値が true である場合、InvalidStateError を投げ、これらの手順を中止します。

4. init の layout が "default" である場合、TypeError を投げ、これらの手順を中止します。

5. layer を、this の relevant realm 内の new XRCylinderLayer とします。

6. layer に対して、session を指定して initialize a composition layer を実行します。

7. layer の media を video に初期化します。

8. layer の needsRedraw を false に初期化します。

9. aspectRatio を、video および init の layout を指定して calculate the aspect ratio した結果とします。

10. init の aspectRatio が undefined である場合、aspectRatio を aspectRatio に設定します。

11. layer および init を指定して initialize a cylinder layer を実行します。

12. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

13. layer を返します。

createEquirectLayer(HTMLVideoElement video, XRMediaEquirectLayerInit init) メソッドは、新しい XREquirectLayer layer を作成します。

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

1. session を、this の session とします。

2. session が "layers" を有効にして作成されていなかった場合、NotSupportedError を投げ、これらの手順を中止します。

3. session の ended 値が true である場合、InvalidStateError を投げ、これらの手順を中止します。

4. init の layout が "default" である場合、TypeError を投げ、これらの手順を中止します。

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

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

7. layer を、this の relevant realm 内の new XREquirectLayer とします。

8. layer に対して、session を指定して initialize a composition layer を実行します。

9. layer の media を video に初期化します。

10. layer の needsRedraw を false に初期化します。

11. layer および init を指定して initialize a equirect layer を実行します。

12. XR Compositor が、何らかの理由で layer 用の リソースを作成できないことを知っている場合、OperationError を投げ、これらの手順を中止します。

13. layer を返します。

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

dictionary XRLayerEventInit : EventInit {
  required XRLayer layer;
};

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

このモジュールは、initialize the render state によって与えられる手順を 置き換えます。代わりに、XRRenderState オブジェクト state が XRSession session のために作成されるとき、ユーザーエージェントは次の手順を実行することによって initialize the render state しなければなりません:

1. initialize the render state するための元の手順を 実行することにより、state を初期化します。

2. state の layers を、session の relevant realm 内の new empty array で初期化します。

このモジュールは、WebXR 仕様の "update the pending layers state" によって与えられる手順を 置き換えます。代わりに、ユーザーエージェントが XRSession session および XRRenderStateInit newState を用いて update the pending layers state するとき、次の手順を 実行しなければなりません:

1. newState の baseLayer と newState の layers の両方が設定されている場合、NotSupportedError を投げ、これらの手順を中止します。

2. activeState を、session の active render state とします。

3. newState の baseLayer が設定されている場合:

   1. session の pending render state が null である場合、 それを activeState のコピーに設定します。

   2. session の pending render state の layers を null に設定します。

4. newState の layers が設定されている場合:

   1. session が "layers" を有効にして作成されておらず、かつ newState の layers が 1 個を超える instance を含む場合、NotSupportedError を投げ、これらの手順を中止します。

   2. newState の layers が maxRenderLayers entries を超えて含む場合、NotSupportedError を投げ、これらの手順を中止します。

   3. session の pending render state が null である場合、 それを activeState のコピーに設定します。

   4. newState の layers が重複する instances を含む場合、TypeError を投げ、これらの手順を中止します。

   5. newState の layers 内の各 layer について:

      1. layer が XRCompositionLayer であり、かつ layer の session が session と異なる場合、TypeError を投げ、これらの手順を中止します。

      2. layer が XRWebGLLayer であり、かつ layer の session が session と異なる場合、TypeError を投げ、これらの手順を中止します。

   6. session の pending render state の baseLayer を null に設定します。

   7. session の pending render state の layers を newState の layers に設定します。

このモジュールは、WebXR 仕様の "check the layers state" によって与えられる手順を置き換えます。 代わりに、renderState state を用いて check the layers state するには、ユーザーエージェントは次の手順を実行しなければなりません:

1. state の baseLayer が null でない場合、true を返します。

2. state の layers が空でない場合、true を返します。

3. false を返します。

11.6. XRSession の変更

このモジュールは、XRSession interface に対して次を拡張および追加します:

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

maxRenderLayers は、compositor が処理しなければ ならない layers の最大数、したがって任意の XRRenderStateInit の layers array の最大サイズを表します。ある時点でこの数を超える layers を作成できるべきです。

注: このガイダンスは、Allocation of layers で説明されているような、ユーザーエージェントが割り当て可能な layers 数の制限を提供することを意図していません。User Agents は、たとえば 20 個の layers を作成できるようにしつつ、 updateRenderState() を通じて一度に設定できるのは 10 個だけにすることができます。また、異なる layers は異なる量の backend power または objects を必要とする可能性があるため、ユーザーエージェントには、少なくともその数の layers をレンダリング できることを保証するために `maxRenderLayers` 値を設定する裁量があることにも注意してください。ただし、ユーザーエージェントは、 より多くの layers が渡された場合は常に拒否する必要があり、より少ない layers が updateRenderState に渡された場合は 拒否できません。

各 XRSession は、その session で作成された各 XRWebGLBinding への弱参照を保持する内部 WeakSet bindings を持ちます。

このモジュールは、WebXR 仕様の "shut down the session" に手順を追加します。 次をリストに追加します:

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

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

   2. texture から foveation を削除します。