immersive-web / immersive-web/layers

No place to reject layer creation in algorithms

Open
#313 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
96
Forks
19
PR merge metrics
No merged PRs in 30d

Description

There's a couple of bits of text that indicate that sessions may reject layers for various reasons[1][2], but there's no indication of a spot and/or type of exception that should be thrown in the creation algorithm.

[1] At the end of section 6.1:

Some layer types may not be supported by the XRSession. If a layer type isn’t supported the method will throw an exception. XRProjectionLayer MUST be supported by all XRSessions.

[2] Section 12.2:

The user agent MAY put limits on any resource allocation such as the maximum pixel size or the number of layers to reduce the identifiability of the GPU hardware.

Note that for [2], no prose is written for either restricting the size or due to the number of layers.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read sections 6.1 and 12.2 of the WebXR Layers specification, then trace the layer-creation algorithms referenced there. Determine where rejection for unsupported layers or resource limits should be specified and what completion criteria the surrounding specification requires; the issue does not identify a source file or test.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.