WebXR 레이어 API 레벨 1

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

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

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

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

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

  readonly attribute boolean needsRedraw;

  undefined destroy();
};

XRCompositionLayer layer에 대해 레이어의 기본 리소스가 손실되면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. layer의 needsRedraw를 true로 설정합니다.

2. layer가 XRProjectionLayer가 아닌 경우, layer에서 XRLayerEvent를 사용하여 redraw라는 이름의 이벤트를 발생시키도록 태스크를 큐에 추가합니다.

XRSession session 및 WebGLRenderingContext 또는 WebGL2RenderingContext context의 선택적 인스턴스로 컴포지션 레이어를 초기화하려면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. this session을 session으로 설정합니다.

2. context가 정의되어 있으면, this context를 context로 설정합니다.

3. this blendTextureSourceAlpha를 true로 설정합니다.

4. this opacity를 1.0으로 설정합니다.

destroy()를 호출할 때, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. this colorTextures 배열을 빈 배열로 설정합니다.

2. this depthStencilTextures 배열을 빈 배열로 설정합니다.

3. 기본 GL attachment를 파기합니다.

XRSpace space 및 XRCompositionLayer layer로 레이어의 space를 설정할 때, 사용자 에이전트는 space가 유효한지 검증하기 위해 다음 단계를 실행해야 합니다.

1. space가 null이면, TypeError를 throw하고 이 단계를 중단합니다.

2. space의 session이 layer의 session과 같지 않으면, TypeError를 throw하고 이 단계를 중단합니다.

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

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

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

  attribute float width;
  attribute float height;

  // Events
  attribute EventHandler onredraw;
};

XRQuadLayerInit init으로 XRQuadLayer layer를 초기화할 때, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. layer의 width를 init의 width로 초기화합니다.

2. layer의 height를 init의 height로 초기화합니다.

3. layer의 space를 init의 space로 둡니다.

4. layer의 transform을 다음과 같이 초기화합니다.

   init의 transform이 설정된 경우

   layer의 transform을 layer의 relevant realm에서 new XRRigidTransform로 두고, init의 transform의 position 및 orientation으로 초기화합니다.

   그렇지 않은 경우

   layer의 transform을 layer의 relevant realm에서 new XRRigidTransform로 두고, DOMPointInit position { x: 0.0, y: 0.0, z: 0.0, w: 1.0 }로 초기화합니다.

5. layer의 isStatic을 init의 isStatic으로 초기화합니다.

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

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

  // Events
  attribute EventHandler onredraw;
};

XRCylinderLayerInit init으로 XRCylinderLayer layer를 초기화할 때, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. layer의 radius를 init의 radius로 초기화합니다.

2. layer의 centralAngle를 init의 centralAngle로 초기화합니다.

3. layer의 aspectRatio를 init의 aspectRatio로 초기화합니다.

4. layer의 space를 init의 space로 둡니다.

5. layer의 transform을 다음과 같이 초기화합니다.

   init의 transform이 설정된 경우

   layer의 transform을 layer의 relevant realm에서 new XRRigidTransform로 두고, init의 transform의 position 및 orientation으로 초기화합니다.

   그렇지 않은 경우

   layer의 transform을 layer의 relevant realm에서 new XRRigidTransform로 두고, DOMPointInit position { x: 0.0, y: 0.0, z: 0.0, w: 1.0 }로 초기화합니다.

6. layer의 isStatic을 init의 isStatic으로 초기화합니다.

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

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

  // Events
  attribute EventHandler onredraw;
};

XRSpace space 및 XREquirectLayer layer로 setting the space on an equirect layer를 수행할 때, 사용자 에이전트는 space가 유효한지 검증하기 위해 다음 단계를 실행해야 합니다.

1. init의 space가 XRReferenceSpace 유형의 인스턴스가 아니면, TypeError를 throw하고 이 단계를 중단합니다.

2. init의 space가 "viewer" type을 가지면, TypeError를 throw하고 이 단계를 중단합니다.

3. space 및 layer로 레이어의 space를 설정하는 단계를 실행합니다.

XREquirectLayerInit init으로 XREquirectLayer layer를 초기화할 때, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. layer의 radius를 init의 radius로 초기화합니다.

2. layer의 centralHorizontalAngle를 init의 centralHorizontalAngle로 초기화합니다.

3. layer의 upperVerticalAngle를 init의 upperVerticalAngle로 초기화합니다.

4. layer의 lowerVerticalAngle를 init의 lowerVerticalAngle로 초기화합니다.

5. layer의 space를 init의 space로 둡니다.

6. layer의 transform을 다음과 같이 초기화합니다.

   init의 transform이 설정된 경우

   layer의 transform을 layer의 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를 throw하고 이 단계를 중단합니다.

2. init의 space가 "viewer" type을 가지면, TypeError를 throw하고 이 단계를 중단합니다.

3. space 및 layer로 레이어의 space를 설정하는 단계를 실행합니다.

[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) constructor는 호출될 때 다음 단계를 수행해야 합니다.

1. binding을 session의 relevant realm 안의 new XRWebGLBinding으로 둡니다.

2. session의 ended 값이 true이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

3. context가 lost이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

4. session이 immersive session이 아니면, InvalidStateError를 throw하고 이 단계를 중단합니다.

5. context의 XR compatible boolean이 false이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

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를 throw하고 이 단계를 중단합니다.

2. textureType이 "texture-array"이고 session의 list of views 안의 모든 views가 동일한 recommended WebGL color texture resolution을 갖지 않으면, NotSupportedError를 throw하고 이 단계를 중단합니다.

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" layout을 선호하면, "stereo-left-right"를 반환하고 이 단계를 중단합니다.

   2. 사용자 에이전트가 "stereo-top-bottom" layout을 선호하면, "stereo-top-bottom"를 반환하고 이 단계를 중단합니다.

6. layout을 반환합니다.

XRSession session, XRWebGLRenderingContext context 및 XRLayerLayout layout을 사용하여 최대 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" layout이면, largest width에 2를 곱합니다.

4. layout이 "stereo-top-bottom" layout이면, 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를 사용하여 projection 레이어용 color texture를 할당하려면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

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이 projection 레이어용 color format 목록에 없으면, NotSupportedError를 throw하고 이 단계를 중단합니다.

9. layer의 layout이 "mono" 또는 "default"인 경우:

   textureType이 "texture-array"인 경우:

   secondary views를 제외하고 session의 list of views 안의 모든 views가 동일한 recommended WebGL color texture resolution을 갖지 않으면, NotSupportedError를 throw하고 이 단계를 중단합니다.

   array를 context의 relevant realm 안의 new opaque texture 인스턴스 1개로 초기화합니다. 이는 context, textureFormat, width 및 height를 사용하여 numViews 레이어를 가진 TEXTURE_2D_ARRAY texture로 생성됩니다.

   opaque texture가 어떤 이유로든 생성될 수 없으면, OperationError를 throw하고 이 단계를 중단합니다.

   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를 throw하고 이 단계를 중단합니다.

   6. texture를 array에 추가합니다.

   array를 반환하고 이 단계를 중단합니다.

10. secondary views를 제외하고 session의 list of views 안의 views가 모두 동일한 recommended WebGL color texture resolution을 갖지 않으면, NotSupportedError를 throw하고 이 단계를 중단합니다.

11. layer의 layout이 stereo-left-right이면, array를 context의 relevant realm 안의 new opaque texture 인스턴스 1개로 초기화합니다. 이는 context, textureFormat, numViews에 width를 곱한 값 및 height를 사용하여 textureType texture로 생성됩니다.

12. layer의 layout이 stereo-top-bottom이면, array를 context의 relevant realm 안의 new opaque texture 인스턴스 1개로 초기화합니다. 이는 context, textureFormat, width 및 numViews에 height를 곱한 값을 사용하여 textureType texture로 생성됩니다.

13. opaque texture가 어떤 이유로든 생성될 수 없으면, OperationError를 throw하고 이 단계를 중단합니다.

14. array를 반환합니다.

프로젝션 레이어의 깊이 텍스처를 할당하기 위해 XRProjectionLayer layer, XRTextureType textureType, GLenum textureFormat 및 float scaleFactor를 사용하여, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. context를 layer의 컨텍스트로 둔다.

2. array를 context의 관련 렐름 안의 새 배열로 둔다.

3. session을 layer의 세션으로 둔다.

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"인 경우:

    context, textureFormat, stencil, width 및 height를 사용해 numViews개 레이어가 있는 TEXTURE_2D_ARRAY 텍스처로 생성된, context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스 1개로 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, textureFormat, stencil, width 및 height를 사용해 TEXTURE_2D 텍스처로 생성된, context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스로 둔다.

    7. texture를 어떤 이유로든 생성할 수 없었던 경우, OperationError를 던지고 이 단계를 중단한다.

    8. texture를 array에 추가한다.

    array를 반환하고 이 단계를 중단한다.

14. session이 "space-warp" 기능 디스크립터와 함께 생성되었고, 보조 뷰를 제외한 뷰 목록 안의 세션의 뷰들이 모두 같은 권장 모션 벡터 텍스처 해상도를 가지지 않으면, NotSupportedError를 던지고 이 단계를 중단한다.

15. session이 "space-warp" 기능 디스크립터와 함께 생성되지 않았고, 보조 뷰를 제외한 뷰 목록 안의 세션의 뷰들이 모두 같은 권장 WebGL 깊이 텍스처 해상도를 가지지 않으면, NotSupportedError를 던지고 이 단계를 중단한다.

16. layer의 layout이 stereo-left-right이면, context, textureFormat, stencil, numViews에 width를 곱한 값 및 height를 사용해 textureType 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스 1개로 array를 초기화한다.

17. layer의 layout이 stereo-top-bottom이면, context, textureFormat, stencil, width 및 numViews에 height를 곱한 값을 사용해 textureType 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스 1개로 array를 초기화한다.

18. 불투명 텍스처를 어떤 이유로든 생성할 수 없었던 경우, OperationError를 던지고 이 단계를 중단한다.

19. array를 반환한다.

프로젝션 레이어의 모션 벡터 텍스처를 할당하기 위해 XRProjectionLayer layer, XRTextureType textureType 및 float scaleFactor를 사용하여, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. context를 layer의 컨텍스트로 둔다.

2. array를 context의 관련 렐름 안의 새 배열로 둔다.

3. session을 layer의 세션으로 둔다.

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"인 경우:

    context, RGBA16F, width 및 height를 사용해 numViews개 레이어가 있는 TEXTURE_2D_ARRAY 텍스처로 생성된, context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스 1개로 array를 초기화한다.

    불투명 텍스처를 어떤 이유로든 생성할 수 없었던 경우, OperationError를 던지고 이 단계를 중단한다.

    array를 반환하고 이 단계를 중단한다.

    그 밖의 경우

    session의 뷰 목록 안의 각 view에 대해:

    1. view가 보조 뷰이면, 계속한다.

    2. width를 view의 권장 모션 벡터 텍스처 해상도의 너비에 scaleFactor를 곱한 값으로 둔다.

    3. height를 view의 권장 모션 벡터 텍스처 해상도의 높이에 scaleFactor를 곱한 값으로 둔다.

    4. texture를 context, RGBA16F, width 및 height를 사용해 TEXTURE_2D 텍스처로 생성된, context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스로 둔다.

    5. texture를 어떤 이유로든 생성할 수 없었던 경우, OperationError를 던지고 이 단계를 중단한다.

    6. texture를 array에 추가한다.

    array를 반환하고 이 단계를 중단한다.

11. 보조 뷰를 제외한 뷰 목록 안의 세션의 뷰들이 모두 같은 권장 모션 벡터 텍스처 해상도를 가지지 않으면, NotSupportedError를 던지고 이 단계를 중단한다.

12. layer의 layout이 stereo-left-right이면, context, RGBA16F, numViews에 width를 곱한 값 및 height를 사용해 textureType 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스 1개로 array를 초기화한다.

13. layer의 layout이 stereo-top-bottom이면, context, RGBA16F, width 및 numViews에 height를 곱한 값을 사용해 textureType 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스 1개로 array를 초기화한다.

14. 불투명 텍스처를 어떤 이유로든 생성할 수 없었던 경우, OperationError를 던지고 이 단계를 중단한다.

15. array를 반환한다.

보조 뷰의 컬러 텍스처를 할당하기 위해 XRProjectionLayer layer, XRTextureType textureType, GLenum textureFormat 및 float scaleFactor를 사용하여, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. context를 layer의 컨텍스트로 둔다.

2. session을 layer의 세션으로 둔다.

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, textureFormat, width 및 height를 사용해 TEXTURE_2D_ARRAY 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스로 둔다.

      그 밖의 경우

      texture를 context, textureFormat, width 및 height를 사용해 TEXTURE_2D 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스로 둔다.

   5. texture를 어떤 이유로든 생성할 수 없었던 경우, OperationError를 던지고 이 단계를 중단한다.

   6. texture를 array에 추가한다.

6. array를 반환하고 이 단계를 중단한다.

보조 뷰의 깊이 텍스처를 할당하기 위해 XRProjectionLayer layer, XRTextureType textureType, GLenum textureFormat 및 float scaleFactor를 사용하여, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. context를 layer의 컨텍스트로 둔다.

2. session을 layer의 세션으로 둔다.

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, textureFormat, stencil, width 및 height를 사용해 TEXTURE_2D_ARRAY 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스로 둔다.

      그 밖의 경우

      texture를 context, textureFormat, stencil, width 및 height를 사용해 TEXTURE_2D 텍스처로 생성된 context의 관련 렐름 안의 불투명 텍스처의 새 인스턴스로 둔다.

   5. texture를 array에 추가한다.

8. array를 반환하고 이 단계를 중단한다.

XRCompositionLayer layer, XRTextureType textureType 및 XRLayerInit init을 사용하여 color texture를 할당하려면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. array를 context의 new array로 둡니다. 이 array는 relevant realm 안에 있습니다.

2. context를 layer의 context로 둡니다.

3. init의 colorFormat이 non-projection 레이어용 color format 목록에 없으면, NotSupportedError를 throw하고 이 단계를 중단합니다.

4. init의 mipLevels가 1보다 작으면, InvalidStateError를 throw하고 이 단계를 중단합니다.

5. init의 mipLevels가 1보다 크고 viewPixelWidth 및 viewPixelHeight가 2의 거듭제곱이 아니면, InvalidStateError를 throw하고 이 단계를 중단합니다

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의 두 배 및 viewPixelHeight 값을 사용하여 textureType texture로 생성됩니다.

9. layer의 layout이 stereo-top-bottom이면, array를 context의 relevant realm 안의 new opaque texture 인스턴스 1개로 초기화합니다. 이는 context 및 init의 colorFormat, mipLevels, viewPixelWidth 및 viewPixelHeight의 두 배 값을 사용하여 textureType texture로 생성됩니다.

10. array를 반환합니다.

XRCompositionLayer layer, XRTextureType textureType 및 XRLayerInit init을 사용하여 depth texture를 할당하려면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. array를 context의 new array로 둡니다. 이 array는 relevant realm 안에 있습니다.

2. context를 layer의 context로 둡니다.

3. init의 depthFormat이 설정되어 있지 않으면, array를 반환하고 이 단계를 중단합니다.

4. init의 depthFormat이 non-projection 레이어용 depth format 목록에 없으면, NotSupportedError를 throw하고 이 단계를 중단합니다.

5. init의 mipLevels가 1보다 작으면, InvalidStateError를 throw하고 이 단계를 중단합니다.

6. init의 mipLevels가 1보다 크고 viewPixelWidth 및 viewPixelHeight가 2의 거듭제곱이 아니면, InvalidStateError를 throw하고 이 단계를 중단합니다.

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의 두 배 및 viewPixelHeight 값을 사용하여 textureType texture로 생성됩니다.

10. layer의 layout이 stereo-top-bottom이면, array를 context의 relevant realm 안의 new opaque texture 인스턴스 1개로 초기화합니다. 이는 context 및 init의 depthFormat, mipLevels, viewPixelWidth 및 viewPixelHeight의 두 배 값을 사용하여 textureType texture로 생성됩니다.

11. array를 반환합니다.

createProjectionLayer(optional XRProjectionLayerInit init) 메서드는 새 XRProjectionLayer layer를 생성한다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. session을 this의 session으로 둔다.

2. context를 this의 context로 둔다.

3. layer를 새 XRProjectionLayer로 두며, 이는 관련 realm에서 생성되고, 그 realm은 this의 것이다.

4. session의 ended 값이 true이면, InvalidStateError를 던지고 이 단계를 중단한다.

5. context가 손실된 경우, InvalidStateError를 던지고 이 단계를 중단한다.

6. layer에 대해 session 및 context와 함께 composition layer 초기화를 실행한다.

7. layer의 isStatic을 false로 초기화한다.

8. layer의 ignoreDepthValues를 다음과 같이 초기화한다:

   session이 "space-warp" 기능 설명자로 생성된 경우

   layer의 ignoreDepthValues를 false로 초기화한다

   init의 depthFormat이 false이고 XR Compositor가 깊이 값을 사용할 경우

   layer의 ignoreDepthValues를 false로 초기화한다

   그 외의 경우

   layer의 ignoreDepthValues를 true로 초기화한다

9. layer의 fixedFoveation을 0으로 초기화한다.

10. layout을 init의 textureType, context 및 "default"와 함께 layout 특성 결정을 실행한 결과로 둔다.

11. maximum scalefactor를 session, context 및 layout와 함께 최대 scalefactor 결정을 실행한 결과로 둔다.

12. scaleFactor가 maximum scalefactor보다 크면, scaleFactor를 maximum scalefactor로 설정한다.

13. layer의 layout을 layout로 초기화한다.

14. layer의 needsRedraw를 true로 초기화한다.

15. layer의 colorTextures를 layer, init의 textureType, init의 colorFormat 및 init의 scaleFactor와 함께 projection layer용 색상 텍스처 할당을 실행한 결과로 둔다.

16. layer의 depthStencilTextures를 layer, init의 textureType, init의 depthFormat 및 init의 scaleFactor와 함께 projection layer용 깊이 텍스처 할당을 실행한 결과로 둔다.

17. layer의 motionVectorTextures를 layer, init의 textureType 및 init의 scaleFactor와 함께 projection layer용 motion vector 텍스처 할당을 실행한 결과로 둔다.

18. secondary view용 colortextures를 다음과 같이 초기화한다:

    session이 "secondary-views"가 활성화된 상태로 생성된 경우

    secondary view용 colortextures를 layer, init의 textureType, init의 colorFormat 및 init의 scaleFactor와 함께 secondary view용 색상 텍스처 할당을 실행한 결과로 둔다.

    그 외의 경우

    secondary view용 colortextures를 null로 둔다.

19. secondary view용 depthstenciltextures를 다음과 같이 초기화한다:

    session이 "secondary-views"가 활성화된 상태로 생성된 경우

    secondary view용 depthstenciltextures를 layer, init의 textureType, init의 depthFormat 및 init의 scaleFactor와 함께 secondary view용 깊이 텍스처 할당을 실행한 결과로 둔다.

    그 외의 경우

    secondary view용 depthstenciltextures를 null로 둔다.

20. XR Compositor가 어떤 이유로든 layer에 대한 리소스를 생성할 수 없다는 것을 알고 있는 경우, OperationError를 던지고 이 단계를 중단한다.

21. layer를 반환한다.

createQuadLayer(XRQuadLayerInit init) 메서드는 새 XRQuadLayer layer를 생성한다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. session을 this의 session으로 둔다.

2. session이 "layers"가 활성화된 상태로 생성되지 않았으면, NotSupportedError를 던지고 이 단계를 중단한다.

3. context를 this의 context로 둔다.

4. session의 ended 값이 true이면, InvalidStateError를 던지고 이 단계를 중단한다.

5. context가 손실된 경우, InvalidStateError를 던지고 이 단계를 중단한다.

6. layout이 "default"이면, TypeError를 던지고 이 단계를 중단한다.

7. layer를 관련 렐름 안의 새 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가 "viewer"의 type을 가지면, TypeError를 던지고 이 단계를 중단한다.

9. layer를 this의 관련 렐름 안의 새 XREquirectLayer로 둔다.

10. layer에 대해 session 및 context와 함께 컴포지션 레이어 초기화를 실행한다.

11. layer 및 init과 함께 equirect 레이어 초기화를 실행한다.

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) method는 새 XRCubeLayer layer를 생성합니다.

이 method가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. session을 this session으로 둡니다.

2. session이 "layers"가 활성화된 상태로 생성되지 않았다면, NotSupportedError를 throw하고 이 단계를 중단합니다.

3. context를 this context로 둡니다.

4. session의 ended 값이 true이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

5. context가 WebGL2RenderingContext context가 아니면, InvalidStateError를 throw하고 이 단계를 중단합니다.

6. context가 lost이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

7. init의 space가 XRReferenceSpace 유형의 인스턴스가 아니면, TypeError를 throw하고 이 단계를 중단합니다.

8. init의 space가 "viewer" type을 가지면, TypeError를 throw하고 이 단계를 중단합니다.

9. layer를 this의 relevant realm 안의 new XRCubeLayer로 둡니다.

10. session 및 context로 layer에 대해 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를 throw하고 이 단계를 중단합니다.

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를 throw하고 이 단계를 중단합니다.

    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를 throw하고 이 단계를 중단합니다.

24. layer를 반환합니다.

XRCompositionLayer layer 및 XRFrame frame 매개변수로 XRWebGLBinding binding의 XRWebGLSubImage 생성 함수의 상태를 검증하려면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

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의 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를 새 XRWebGLSubImage로 두며, 이는 관련 realm에서 생성되고, 그 realm은 this의 것이다.

   subimage의 viewport를 새 XRViewport로 두며, 이는 관련 realm에서 생성되고, 그 realm은 this의 것이다.

2. session을 this의 session으로 둔다.

3. layer가 session의 layers 배열에 없으면, TypeError를 던지고 이 단계를 중단한다.

4. layer의 타입이 XRProjectionLayer이면, TypeError를 던지고 이 단계를 중단한다.

5. layer의 layout 특성이 "default"이면, TypeError를 던지고 이 단계를 중단한다.

6. index를 0으로 둔다.

7. layer의 layout 특성이 "stereo"인 경우:

   1. eye가 "none"이면, TypeError를 던지고 이 단계를 중단한다.

   2. eye가 "right"인 경우:

      layer의 타입이 XRCubeLayer인 경우

      index를 6으로 설정한다

      그 외의 경우

      index를 1로 설정한다

8. layer 및 frame와 함께 XRWebGLSubImage 생성 함수의 상태 검증을 실행한 결과가 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

9. subimage의 imageIndex를 다음과 같이 초기화한다:

   layer가 "texture-array"의 textureType으로 생성된 경우

   subimage의 imageIndex를 index로 초기화한다.

   그 외의 경우

   subimage의 imageIndex를 0으로 초기화한다.

10. subimage의 colorTexture를 다음과 같이 초기화한다:

    layer가 "texture"의 textureType으로 생성된 경우

    subimage의 colorTexture를 layer의 colorTextures 배열에서 오프셋 index의 요소로 초기화한다.

    그 외의 경우

    subimage의 colorTexture를 layer의 colorTextures 배열의 첫 번째 요소로 초기화한다.

11. subimage의 depthStencilTexture를 다음과 같이 초기화한다:

    layer의 depthStencilTextures가 빈 배열인 경우

    subimage의 depthStencilTexture를 null로 초기화한다.

    아니면 layer가 "texture"의 textureType으로 생성된 경우

    subimage의 depthStencilTexture를 layer의 depthStencilTextures 배열에서 오프셋 index의 요소로 초기화한다.

    그 외의 경우

    subimage의 depthStencilTexture를 layer의 depthStencilTextures 배열의 첫 번째 요소로 초기화한다.

12. subimage의 depthStencilTextureWidth, depthStencilTextureHeight, 및 motionVectorTexture를 null로 초기화한다.

13. subimage의 colorTextureWidth를 subimage의 colorTexture의 픽셀 너비로 설정한다.

14. subimage의 colorTextureHeight를 subimage의 colorTexture의 픽셀 높이로 설정한다.

15. subimage의 depthStencilTexture가 null이 아니면, subimage의 depthStencilTextureWidth를 depthStencilTexture 배열의 첫 번째 텍스처의 픽셀 너비로 설정한다.

16. subimage의 depthStencilTexture가 null이 아니면, subimage의 depthStencilTextureHeight를 depthStencilTexture 배열의 첫 번째 텍스처의 픽셀 높이로 설정한다.

17. viewsPerTexture를 1로 둔다.

18. layer의 layout 특성이 "stereo-left-right" 또는 "stereo-top-bottom"이면, viewsPerTexture를 2로 설정한다.

19. subimage의 viewport에 대해 subimage의 colorTexture, layer의 layout, index 및 viewsPerTexture와 함께 viewport 초기화를 실행한다.

20. needsRedraw를 false로 설정하도록 태스크를 큐에 넣는다.

21. subimage를 반환한다.

getViewSubImage(XRProjectionLayer layer, XRView view) 메서드는 새 XRWebGLSubImage를 생성한다.

이 메서드가 XRWebGLBinding binding에서 호출되면, 다음 단계를 반드시 실행해야 한다:

1. subimage를 다음과 같이 초기화한다:

   getViewSubImage()가 같은 binding, layer 및 view로 이전에 호출된 경우, 사용자 에이전트는 다음을 할 수 있다

   subimage를 같은 인수로 이루어진 이전 호출에서 반환된 것과 동일한 XRWebGLSubImage 객체로 둔다.

   그 외의 경우

   subimage를 새 XRWebGLSubImage로 두며, 이는 관련 realm에서 생성되고, 그 realm은 this의 것이다.

   subimage의 viewport를 새 XRViewport로 두며, 이는 관련 realm에서 생성되고, 그 realm은 this의 것이다.

2. frame을 view의 frame으로 둔다.

3. session을 this의 session으로 둔다.

4. layer 및 frame와 함께 XRWebGLSubImage 생성 함수의 상태 검증을 실행한 결과가 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

5. layer가 session의 layers 배열에 없으면, TypeError를 던지고 이 단계를 중단한다.

6. view의 active 플래그가 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

7. index를 다음과 같이 초기화한다:

   view가 session의 view 목록에 있는 secondary view인 경우

   index를 session의 view 목록에서 primary view를 제외한 것 중 view의 view의 오프셋으로 둔다.

   그 외의 경우

   index를 session의 view 목록에서 secondary view를 제외한 것 중 view의 view의 오프셋으로 둔다.

8. subimage의 imageIndex를 다음과 같이 초기화한다:

   layer가 "texture-array"의 textureType으로 생성된 경우:

   subimage의 imageIndex를 index로 초기화한다.

   그 외의 경우

   subimage의 imageIndex를 0으로 초기화한다.

9. subimage의 colorTexture를 다음과 같이 초기화한다:

   view가 session의 view 목록에 있는 secondary view인 경우

   subimage의 colorTexture를 layer의 secondary view용 colorTextures에서 오프셋 index의 요소로 초기화한다.

   아니면 layer의 layout이 "default"이고 layer가 "texture"의 textureType으로 생성된 경우

   subimage의 colorTexture를 layer의 colorTextures 배열에서 오프셋 index의 요소로 초기화한다.

   그 외의 경우

   subimage의 colorTexture를 layer의 colorTextures 배열의 첫 번째 요소로 초기화한다.

10. subimage의 depthStencilTexture를 다음과 같이 초기화한다:

    layer의 depthStencilTextures가 빈 배열인 경우

    subimage의 depthStencilTexture를 null로 초기화한다.

    아니면 view가 session의 view 목록에 있는 secondary view인 경우

    subimage의 colorTexture를 layer의 secondary view용 depthStencilTextures에서 오프셋 index의 요소로 초기화한다.

    아니면 layer의 layout이 "default"이고 layer가 "texture"의 textureType으로 생성된 경우

    subimage의 depthStencilTexture를 layer의 depthStencilTextures 배열에서 오프셋 index의 요소로 초기화한다.

    그 외의 경우

    subimage의 depthStencilTexture를 layer의 depthStencilTextures 배열의 첫 번째 요소로 초기화한다.

11. subimage의 motionVectorTexture를 다음과 같이 초기화한다:

    layer의 motionVectorTextures가 빈 배열이거나 view가 session의 view 목록에 있는 secondary view인 경우

    subimage의 motionVectorTexture를 null로 초기화한다.

    아니면 layer가 "texture"의 textureType으로 생성된 경우

    subimage의 motionVectorTexture를 layer의 motionVectorTextures 배열에서 오프셋 index의 요소로 초기화한다.

    그 외의 경우

    subimage의 motionVectorTexture를 layer의 motionVectorTextures 배열의 첫 번째 요소로 초기화한다.

12. subimage의 colorTextureWidth를 subimage의 colorTexture의 픽셀 너비로 설정한다.

13. subimage의 colorTextureHeight를 subimage의 colorTexture의 픽셀 높이로 설정한다.

14. subimage의 depthStencilTextureWidth 및 depthStencilTextureHeight를 null로 초기화한다.

15. subimage의 depthStencilTexture가 null이 아니면, subimage의 depthStencilTextureWidth를 depthStencilTexture 배열의 첫 번째 텍스처의 픽셀 너비로 설정한다.

16. subimage의 depthStencilTexture가 null이 아니면, subimage의 depthStencilTextureHeight를 depthStencilTexture 배열의 첫 번째 텍스처의 픽셀 높이로 설정한다.

17. subimage의 viewport에 대해 subimage의 colorTexture, layer의 layout, index 및 session의 view 목록의 수와 함께 viewport 초기화를 실행한다.

18. needsRedraw를 false로 설정한다.

19. 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를 rendering해야 하는 경우, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. usability를 media에 대해 usability를 확인한 결과로 둡니다.

2. usability가 bad이면, layer를 투명한 검정으로 채우고 이 단계를 중단합니다.

3. layer를 media 요소의 콘텐츠로 채웁니다.

XRMediaBinding(XRSession session) constructor는 호출될 때 다음 단계를 수행해야 합니다.

1. session의 ended 값이 true이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

2. session이 immersive session이 아니면, InvalidStateError를 throw하고 이 단계를 중단합니다.

3. binding을 session의 relevant realm 안의 new XRMediaBinding으로 둡니다.

4. binding의 session을 session으로 초기화합니다.

5. binding을 반환합니다.

HTMLVideoElement video와 XRLayerLayout layout의 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) method는 새 XRQuadLayer layer를 생성합니다.

이 method가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. session을 this session으로 둡니다.

2. session이 "layers"가 활성화된 상태로 생성되지 않았다면, NotSupportedError를 throw하고 이 단계를 중단합니다.

3. session의 ended 값이 true이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

4. init의 layout이 "default"이면, TypeError를 throw하고 이 단계를 중단합니다.

5. layer를 this의 relevant realm 안의 new XRQuadLayer로 둡니다.

6. session으로 layer에 대해 initialize a composition layer를 실행합니다.

7. layer의 media를 video로 초기화합니다.

8. layer의 needsRedraw를 false로 초기화합니다.

9. aspectRatio를 video 및 init의 layout으로 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를 throw하고 이 단계를 중단합니다.

15. layer를 반환합니다.

createCylinderLayer(HTMLVideoElement video, XRMediaCylinderLayerInit init) method는 새 XRCylinderLayer layer를 생성합니다.

이 method가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. session을 this session으로 둡니다.

2. session이 "layers"가 활성화된 상태로 생성되지 않았다면, NotSupportedError를 throw하고 이 단계를 중단합니다.

3. session의 ended 값이 true이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

4. init의 layout이 "default"이면, TypeError를 throw하고 이 단계를 중단합니다.

5. layer를 this의 relevant realm 안의 new XRCylinderLayer로 둡니다.

6. session으로 layer에 대해 initialize a composition layer를 실행합니다.

7. layer의 media를 video로 초기화합니다.

8. layer의 needsRedraw를 false로 초기화합니다.

9. aspectRatio를 video 및 init의 layout으로 aspect ratio를 계산한 결과로 둡니다.

10. init의 aspectRatio가 undefined이면, aspectRatio를 aspectRatio로 설정합니다.

11. layer 및 init으로 initialize a cylinder layer를 실행합니다.

12. XR Compositor가 어떤 이유로든 layer용 리소스를 생성할 수 없다는 것을 알고 있으면, OperationError를 throw하고 이 단계를 중단합니다.

13. layer를 반환합니다.

createEquirectLayer(HTMLVideoElement video, XRMediaEquirectLayerInit init) method는 새 XREquirectLayer layer를 생성합니다.

이 method가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. session을 this session으로 둡니다.

2. session이 "layers"가 활성화된 상태로 생성되지 않았다면, NotSupportedError를 throw하고 이 단계를 중단합니다.

3. session의 ended 값이 true이면, InvalidStateError를 throw하고 이 단계를 중단합니다.

4. init의 layout이 "default"이면, TypeError를 throw하고 이 단계를 중단합니다.

5. init의 space가 XRReferenceSpace type의 인스턴스가 아니면, InvalidStateError를 throw하고 이 단계를 중단합니다.

6. init의 space가 "viewer" type을 가지면, InvalidStateError를 throw하고 이 단계를 중단합니다.

7. layer를 this의 relevant realm 안의 new XREquirectLayer로 둡니다.

8. session으로 layer에 대해 initialize a composition layer를 실행합니다.

9. layer의 media를 video로 초기화합니다.

10. layer의 needsRedraw를 false로 초기화합니다.

11. layer 및 init으로 initialize a equirect layer를 실행합니다.

12. XR Compositor가 어떤 이유로든 layer용 리소스를 생성할 수 없다는 것을 알고 있으면, OperationError를 throw하고 이 단계를 중단합니다.

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

이 모듈은 렌더 상태 초기화에서 주어진 단계를 대체한다. 대신 XRRenderState 객체 state가 XRSession session을 위해 생성될 때, 사용자 에이전트는 다음 단계를 실행하여 렌더 상태를 초기화해야 한다:

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. session이 "layers"가 활성화된 상태로 생성되지 않았고 newState의 layers가 1개보다 많은 인스턴스를 포함하면, NotSupportedError를 던지고 이 단계를 중단한다.

   2. newState의 layers가 maxRenderLayers보다 많은 항목을 포함하면, NotSupportedError를 던지고 이 단계를 중단한다.

   3. session의 보류 중인 렌더 상태가 null이면, 이를 activeState의 사본으로 설정한다.

   4. newState의 layers가 중복 인스턴스를 포함하면, TypeError를 던지고 이 단계를 중단한다.

   5. newState의 layers 안의 각 layer에 대해:

      1. layer가 XRCompositionLayer이고 layer의 session이 session과 다르면, TypeError를 던지고 이 단계를 중단한다.

      2. layer가 XRWebGLLayer이고 layer의 session이 session과 다르면, TypeError를 던지고 이 단계를 중단한다.

   6. session의 보류 중인 렌더 상태의 baseLayer를 null로 설정한다.

   7. session의 보류 중인 렌더 상태의 layers를 newState의 layers로 설정한다.

이 module은 WebXR specification의 "check the layers state"에 주어진 단계를 대체합니다. 대신 renderState state로 layers state를 check하려면, 사용자 에이전트는 다음 단계를 실행해야 합니다.

1. state의 baseLayer가 null이 아니면, true를 반환합니다.

2. state의 layers가 비어 있지 않으면, true를 반환합니다.

3. false를 반환합니다.

11.6. XRSession 변경 사항

이 module은 XRSession interface에 다음을 확장 및 추가합니다.

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

maxRenderLayers는 compositor가 처리해야 하는 최대 layer 수, 따라서 모든 XRRenderStateInit의 layers array의 최대 크기를 나타냅니다. 주어진 시점에 이 수보다 많은 layer를 생성할 수 있어야 합니다.

NOTE: 이 guidance는 Allocation of layers에 설명된 것처럼 사용자 에이전트가 할당할 수 있는 layer 수에 대한 제한을 제공하려는 것이 아닙니다. User Agents는 예를 들어 20개의 layer 생성을 허용하면서도, updateRenderState()를 통해 한 번에 설정할 수 있는 수는 10개로 제한할 수 있습니다. 또한 서로 다른 layer가 서로 다른 양의 backend power 또는 objects를 요구할 수 있기 때문에, user agents는 적어도 그만큼 많은 layer가 render될 수 있도록 `maxRenderLayers` 값을 설정하는 데 일정한 재량을 가진다는 점도 주목할 만합니다. 그러나 user agents는 여전히 더 많은 layer가 전달될 때는 reject해야 하며, updateRenderState에 더 적은 layer가 전달될 때는 reject할 수 없습니다.

각 XRSession에는 그 session으로 생성된 각 XRWebGLBinding에 대한 약한 참조를 보관하는 내부 WeakSet bindings가 있습니다.

이 module은 WebXR specification의 "shut down the session"에 단계를 추가합니다. 목록에 다음을 추가하세요:

1. session|의 bindings 안의 각 binding에 대해:

   1. binding의 foveatedTextures 안의 각 texture에 대해:

   2. texture에서 foveation을 제거합니다.