KhronosGroup / KhronosGroup/OpenXR-Docs

Clarify `XrCompositionLayerPassthroughHTC::layerFlags`

Open
#187 1 comment 0 reactions 0 assignees View on GitHub
synced to gitlab vendor-extension
Dominant language
Python
Stars
181
Forks
74
PR merge metrics
No merged PRs in 30d

Description

Spec:

https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html#XrCompositionLayerPassthroughHTC

> `layerFlags` must not be 0

But it never explains why the author thinks it is impossible for no flags to apply. And this limitation doesn't appear for other composition layers.

I can always set `CORRECT_CHROMATIC_ABERRATION` because it's essentially no-op, but that's said to be on deprecation path.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the linked OpenXR specification section for XrCompositionLayerPassthroughHTC::layerFlags and compare its requirement with the other composition-layer definitions. Determine why zero flags are disallowed, then clarify the specification or document the intended alternative; done means the restriction has an explicit rationale or is resolved.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.