Skip to content

Commit

Permalink
OpenXR Specification 1.0.22 (2022-01-12)
Browse files Browse the repository at this point in the history 
This release features a number of new vendor and multi-vendor
extensions, plus a few extension corrections. There are a few small core
specification fixes as well, including a clarification that going
forward, xrBeginFrame is not a blocking function (which was implied but
not explicitly stated).

-   Registry
    -   Add new XR_FB_render_model vendor extension. (internal MR 2117,
        internal MR 2169)
    -   Add new XR_HTC_facial_expression vendor extension. (internal MR
        2120)
    -   Add new XR_FB_keyboard_tracking vendor extension. (internal MR
        2128)
    -   Add new XR_EXT_uuid multi-vendor extension. (internal MR 2152)
    -   Add new XR_FB_passthrough_keyboard_hands vendor extension.
        (internal MR 2162)
    -   Add new XR_HTC_vive_focus3_controller_interaction vendor
        extension. (internal MR 2178)
    -   Add new XR_ALMALENCE_digital_lens_control vendor extension.
        (OpenXR-Docs PR 104, internal issue 1615)
    -   Correct winding order for XR_MSFT_hand_tracking_mesh extension
        to clockwise to match runtime behavior. (internal MR 2151)
    -   Fix typos/naming convention errors in
        XR_FB_hand_tracking_capsules: rename
        XR_FB_HAND_TRACKING_CAPSULE_POINT_COUNT to
        XR_HAND_TRACKING_CAPSULE_POINT_COUNT_FB and
        XR_FB_HAND_TRACKING_CAPSULE_COUNT to
        XR_HAND_TRACKING_CAPSULE_COUNT_FB, providing the old names as
        compatibility aliases. (internal MR 1547, internal issue 1519)
    -   Reserve vendor extensions 208 - 299 for Facebook. (internal MR
        2158)
    -   Reserve extension numbers for anticipated multi-vendor
        extensions. (internal MR 2173)
-   Specification
    -   Clarify that xrBeginFrame is not a blocking function for frame
        synchronization purposes. (internal MR 2145)
    -   Correct winding order for XR_MSFT_hand_tracking_mesh extension
        to clockwise to match runtime behavior. (internal MR 2151)
    -   Document new XR_FB_render_model vendor extension. (internal MR
        2117, internal MR 2169)
    -   Document new XR_HTC_facial_tracker vendor extension. (internal
        MR 2120)
    -   Document new XR_FB_keyboard_tracking vendor extension. (internal
        MR 2128)
    -   Document new XR_EXT_uuid multi-vendor extension. (internal MR
        2152)
    -   Document new XR_FB_passthrough_keyboard_hands vendor extension.
        (internal MR 2162)
    -   Document new XR_HTC_vive_focus3_controller_interaction vendor
        extension. (internal MR 2178)
    -   Document new XR_ALMALENCE_digital_lens_control vendor extension.
        (OpenXR-Docs PR 104, internal issue 1615)
    -   Fix typos/naming convention errors in
        XR_FB_hand_tracking_capsules: rename
        XR_FB_HAND_TRACKING_CAPSULE_POINT_COUNT to
        XR_HAND_TRACKING_CAPSULE_POINT_COUNT_FB and
        XR_FB_HAND_TRACKING_CAPSULE_COUNT to
        XR_HAND_TRACKING_CAPSULE_COUNT_FB, providing the old names as
        compatibility aliases. (internal MR 1547, internal issue 1519)
    -   Semantic paths: Note that “back” (as a button) is an acceptable
        standard identifier: the core specification already includes
        interaction profiles using it, but it was inadvertently omitted
        from the standard identifier list. (internal MR 2166)
    -   Update xml consistency script to verify correct application of
        vendor naming rules. (internal MR 1547, internal issue 1618)
    -   Update docs for XR_TYPE_EVENT_DATA_INSTANCE_LOSS_PENDING to
        specify that xrCreateInstance returns
        XR_ERROR_RUNTIME_UNAVAILABLE as long as it is unable to create
        the instance. (internal MR 2149)
    -   Update docs for XR_FB_color_space to correct preferred color
        space for Oculus HMDs. (internal MR 2155)

This release replaces 1.0.21.
  • Loading branch information
@rpavlik
rpavlik committed Jan 12, 2022
1 parent ea5b740 commit 1120eaf
Show file tree
Hide file tree
Showing 4 changed files with 20 additions and 11 deletions.
7 changes: 6 additions & 1 deletion CHANGELOG.Docs.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ any public pull requests that have been accepted.
This changelog only lists changes that affect the registry,
headers, and/or specification text.

## OpenXR Specification 1.0.21 (2022-01-10)
## OpenXR Specification 1.0.22 (2022-01-12)

This release features a number of new vendor and multi-vendor extensions, plus a
few extension corrections. There are a few small core specification fixes as
Expand Down Expand Up @@ -101,6 +101,11 @@ blocking function (which was implied but not explicitly stated).
HMDs.
([internal MR 2155](https://gitlab.khronos.org/openxr/openxr/merge_requests/2155))

## OpenXR Specification 1.0.21 (2022-01-10)

This release was withdrawn due to a typo noticed after initial publication.
All changes are now listed under 1.0.22.

## OpenXR Specification 1.0.20 (2021-10-04)

This release includes a number of new vendor extensions and a few minor clarifications.
Expand Down
16 changes: 10 additions & 6 deletions specification/Makefile
View file
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ ifneq (,$(strip $(VERY_STRICT)))
ASCIIDOC := $(ASCIIDOC) --failure-level WARN
endif

SPECREVISION = 1.0.21
SPECREVISION = 1.0.22
REVISION_COMPONENTS = $(subst ., ,$(SPECREVISION))
MAJORMINORVER = $(word 1,$(REVISION_COMPONENTS)).$(word 2,$(REVISION_COMPONENTS))

Expand Down Expand Up @@ -101,7 +101,6 @@ default:
echo "release-htmlpdf: build html pdf and copy output to an OpenXR-Registry-like layout"; \
echo "release: build html pdf manhtmlpages loader styleguide extprocess and copy output to an OpenXR-Registry-like layout"; \
fi

$(ECHO) "reflow: reflow AsciiDoctor source files in-place"
$(ECHO) "clean_dirt: remove intermediate files"
$(ECHO) "clean: remove targets and intermediate files"
Expand Down Expand Up @@ -536,20 +535,25 @@ all:


################################################
# Meta build for releases. Also copies into approximately the right layout for the OpenXR-Registry repo.
# Meta builds for releases. Also copies into approximately the right layout for the OpenXR-Registry repo.
REGISTRYOUTDIR = $(OUTDIR)/../registry-release/specs/$(MAJORMINORVER)$(RELEASE_SPECS_SUFFIX)

$(REGISTRYOUTDIR):
$(QUIET)$(MKDIR) $@

$(REGISTRYOUTDIR)/pdf $(REGISTRYOUTDIR)/html $(REGISTRYOUTDIR)/man: $(REGISTRYOUTDIR)
$(REGISTRYOUTDIR)/pdf $(REGISTRYOUTDIR)/html $(REGISTRYOUTDIR)/man $(REGISTRYOUTDIR)/headers: $(REGISTRYOUTDIR)
$(QUIET)$(MKDIR) $@

$(REGISTRYOUTDIR)/headers/openxr: $(REGISTRYOUTDIR)/headers
$(QUIET)$(MKDIR) $@

release-htmlpdf: html pdf $(REGISTRYOUTDIR)/pdf $(REGISTRYOUTDIR)/html
-asciidoctor-pdf-optimize $(PDFSPEC)
$(QUIET)$(CP) $(PDFSPEC) $(REGISTRYOUTDIR)/pdf/xrspec.pdf
$(QUIET)$(CP) $(HTMLSPEC) $(REGISTRYOUTDIR)/html/xrspec.html
$(QUIET)$(CP) $(PDFSPEC) $(REGISTRYOUTDIR)/pdf/$(SPEC_FILENAME_STEM).pdf
$(QUIET)$(CP) $(HTMLSPEC) $(REGISTRYOUTDIR)/html/$(SPEC_FILENAME_STEM).html
.PHONY: release-htmlpdf


release: release-htmlpdf manhtmlpages loader styleguide extprocess $(REGISTRYOUTDIR) $(REGISTRYOUTDIR)/man
$(QUIET)$(CP) $(OUTDIR)/styleguide.html $(OUTDIR)/extprocess.html $(OUTDIR)/loader.html $(REGISTRYOUTDIR)
$(QUIET)$(CP) -R $(MANHTMLDIR) $(REGISTRYOUTDIR)/man/html
Expand Down
2 changes: 1 addition & 1 deletion specification/current_version.ini
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@
# Similarly, update specification/scripts/extensionmetadocgenerator.py as well.
MAJOR=1
MINOR=0
PATCH=21
PATCH=22
6 changes: 3 additions & 3 deletions specification/registry/xr.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ maintained in the default branch of the Khronos OpenXR GitHub project.
updates them automatically by processing a line at a time.
-->
<type category="define">// OpenXR current version number.
#define <name>XR_CURRENT_API_VERSION</name> <type>XR_MAKE_VERSION</type>(1, 0, 21)</type>
#define <name>XR_CURRENT_API_VERSION</name> <type>XR_MAKE_VERSION</type>(1, 0, 22)</type>

<!--
NOTE: For avoidance of ambiguity, there should only be 1 <name> tag immediately in
Expand Down Expand Up @@ -2694,8 +2694,8 @@ maintained in the default branch of the Khronos OpenXR GitHub project.

<!-- flags for XR_FB_keyboard_tracking query -->
<enums name="XrKeyboardTrackingQueryFlagBitsFB" type="bitmask">
<enum bitpos="0" name="XR_KEYBOARD_TRACKING_QUERY_LOCAL_BIT_FB" comment="indicates the query is for the physically tracked keyboard that is intended to be used in a local pairing with the System. Mutally exclusive with XR_KEYBOARD_TRACKING_QUERY_REMOTE_BIT_FB."/>
<enum bitpos="1" name="XR_KEYBOARD_TRACKING_QUERY_REMOTE_BIT_FB" comment="indicates the query is for the physically tracked keyboard that may be connected to a separate remote computing device. Mutally exclusive with XR_KEYBOARD_TRACKING_QUERY_LOCAL_BIT_FB."/>
<enum bitpos="1" name="XR_KEYBOARD_TRACKING_QUERY_LOCAL_BIT_FB" comment="indicates the query is for the physically tracked keyboard that is intended to be used in a local pairing with the System. Mutally exclusive with XR_KEYBOARD_TRACKING_QUERY_REMOTE_BIT_FB."/>
<enum bitpos="2" name="XR_KEYBOARD_TRACKING_QUERY_REMOTE_BIT_FB" comment="indicates the query is for the physically tracked keyboard that may be connected to a separate remote computing device. Mutally exclusive with XR_KEYBOARD_TRACKING_QUERY_LOCAL_BIT_FB."/>
</enums>

<!-- flags for XR_FB_space_warp -->
Expand Down

0 comments on commit 1120eaf

Please sign in to comment.