OpenXR SDK 1.0.27 (2023-03-21)

This release contains a large list of improvements, including
interaction profile definitions in machine-readable format in the XML,
consistent tool-based formatting of the XML, a new list_json tool to
ease updates to OpenXR-Inventory, and a wide variety of new vendor and
multi-vendor extensions, in addition to a collection of smaller
improvements.

-   Registry
    -   Add interaction profile definitions to xr.xml (internal MR 2485)
    -   Chore: Format the full XML API registry with PrettyRegistryXML,
        making some small changes by hand to clean up. (internal MR
        2540, internal MR 2329, OpenXR-SDK-Source PR 373, OpenXR-Docs PR
        14, OpenXR-CTS PR 50, OpenXR-SDK PR 12)
    -   Document how to generate a standalone header file for an
        extension. (internal MR 2627)
    -   Extension reservation: Register author ID and reserve vendor
        extensions for Logitech. (internal MR 2504)
    -   Extension reservation: Reserve an extension number for a
        multi-vendor extension. (internal MR 2520)
    -   Extension reservation: Reserve an extension for
        XR_EXT_hand_tracking_usage (internal MR 2550)
    -   Extension reservation: Reserve extension id 430 for
        XR_EXT_plane_detection (internal MR 2565)
    -   Extension reservation: Reserve vendor extensions for Monado.
        (internal MR 2613)
    -   Extension reservation: Reserve vendor extensions for ACER.
        (OpenXR-Docs PR 142)
    -   Extension reservation: Reserve a vendor extension for OPPO.
        (OpenXR-Docs PR 145)
    -   New vendor extension: XR_FB_composition_layer_depth_test
        (internal MR 2208, internal issue 1657)
    -   New vendor extension: XR_META_foveation_eye_tracked (internal MR
        2239, internal MR 2273, internal MR 2332)
    -   New vendor extension: XR_QCOM_tracking_optimization_settings
        (internal MR 2261, internal issue 1703)
    -   New vendor extension: XR_META_local_dimming (internal MR 2267,
        internal MR 2595)
    -   New vendor extension: XR_FB_spatial_entity_sharing (internal MR
        2274)
    -   New vendor extension: XR_FB_scene_capture (internal MR 2286)
    -   New vendor extension: XR_FB_spatial_entity_storage_batch
        (internal MR 2312)
    -   New vendor extension: XR_FB_haptic_amplitude_envelope (internal
        MR 2326)
    -   New vendor extension: XR_FB_touch_controller_pro (internal MR
        2327, internal issue 1916)
    -   New vendor extension: XR_FB_haptic_pcm (internal MR 2329)
    -   New vendor extension: FB_face_tracking (internal MR 2334,
        internal MR 2539)
    -   New vendor extension: XR_FB_eye_tracking_social (internal MR
        2336, internal MR 2576)
    -   New vendor extension: XR_FB_body_tracking (internal MR 2339,
        internal MR 2575)
    -   New vendor extension: XR_OCULUS_external_camera (internal MR
        2397, internal MR 2344)
    -   New vendor extension: XR_FB_spatial_entity_user (internal MR
        2407)
    -   New vendor extension: XR_FB_touch_controller_proximity (internal
        MR 2412)
    -   New vendor extension: XR_ML_global_dimmer (internal MR 2461)
    -   New vendor extension: XR_ML_frame_end_info (internal MR 2462,
        internal MR 2536)
    -   New vendor extension: XR_ML_compat (internal MR 2473)
    -   New vendor extension: XR_EXT_local_floor (internal MR 2503,
        internal issue 746, internal issue 1606, OpenXR-Docs issue 103)
    -   New vendor extension: XR_BD_controller_interaction (internal MR
        2527)
    -   New vendor extension: XR_MNDX_force_feedback_curl (OpenXR-Docs
        PR 136)
    -   Register author ID for Matthieu Bucchianeri. (OpenXR-Docs PR
        143)
    -   Rename tag name to a short one for ByteDance. (internal MR 2502)
    -   Schema: Add initial tests for Schematron rules. (internal MR
        2512)
    -   Schema: Add author ID schematron checks and change duplicate
        name/number report to an assert (internal MR 2514)
    -   Schema: Fix Relax-NG checks of naming convention, and add naming
        convention checks to Schematron. (internal MR 2538)
    -   Schematron: Update extension naming rule to allow for vendor
        tags to be followed by an X for experimental and a version
        number (internal MR 2518)
    -   scripts: Let deprecated override provisional when choosing
        extension table of contents section. (internal MR 2547)
    -   scripts: Fix leftover exclusion of extensions/meta from
        checkMarkup now that it no longer generated files. (internal MR
        2560)
-   SDK
    -   Experimental Extension Naming: Allow vendor tags to be followed
        by an “X” for experimental and an optional version number
        (e.g. XR_EXTX2_hand_tracking). Update source generator vendor
        checks accordingly (internal MR 2518)
    -   Fix typo in API Dump generation script (internal MR 2608)
    -   Loader: Fix dynamic build on MinGW. (OpenXR-SDK-Source PR 362,
        OpenXR-SDK-Source issue 367)
    -   Loader and layers: In debug builds, log when non-empty
        environment variables are being ignored due to executing with
        elevated privilege. (OpenXR-SDK-Source PR 336)
    -   Loader doc: Minor cleanups to API layer section. (internal MR
        2581)
    -   Loader doc: Fix incorrect markup/dead links. (internal MR 2598)
    -   Remove third-party dependencies in external/include/utils.
        (internal MR 2528)
    -   Update all XrStructureType initialization to use standard OpenXR
        style. (internal MR 2557)
    -   Update URLs with branch names in manpages. (internal MR 2648)
    -   Validation layer: Fix function signature for
        xrNegotiateLoaderApiLayerInterface in core validation api layer
        (internal MR 2607, OpenXR-SDK-Source issue 378, internal issue
        1929)
    -   clang-format: Add clang-format-15 as acceptable clang formats
        (OpenXR-SDK-Source PR 359)
    -   doc: Add VS 2022 version code to BUILDING.md (OpenXR-SDK-Source
        PR 381)
    -   headers: Remove spurious space in preprocessor conditional, that
        was causing defined to be treated as an operator. (internal MR
        2491)
    -   hello_xr: Correct domain in Android package identifier.
        (internal MR 2513)
    -   hello_xr: Update Vulkan plugin to use the newer
        VK_EXT_debug_utils extension, and provide names for most Vulkan
        objects used by the app to aid in debugging. (Utility code
        shared with CTS.) (internal MR 2524, internal MR 2579, internal
        MR 2637)
    -   hello_xr: Zero initialize XrSwapchainImage* structs (internal MR
        2551)
    -   hello_xr: Export built-in NativeActivity (OpenXR-SDK-Source PR
        358)
    -   hello_xr: Use correct lost event count (OpenXR-SDK-Source PR
        359)
    -   loader: Prefer cstdio and cstdlib for c++ files
        (OpenXR-SDK-Source PR 357)
    -   loader,api_layers: Fix finding wayland-client.h on linux
        (OpenXR-SDK-Source PR 346)
    -   sdk-source: Add list_json, a small app to print json similar to
        the schema used by OpenXR-Inventory. (internal MR 2541, internal
        MR 2658)
    -   xr_linear.h: Add some extra linear algebra functions (internal
        MR 2532)

.appveyor.yml

@@ -1,8 +1,8 @@
-# Copyright (c) 2017-2021 The Khronos Group Inc.
+# Copyright (c) 2017-2023 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
-version: 1.0.26.{build}
+version: 1.0.27.{build}
 image: Visual Studio 2017
 
 

.azure-pipelines/nuget/NugetTemplate/OpenXR.Loader.nuspec

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
   <!--
-  Copyright (c) 2020-2022, The Khronos Group Inc.
+  Copyright (c) 2020-2023, The Khronos Group Inc.
   SPDX-License-Identifier: CC-BY-4.0
   -->
   <metadata>

.azure-pipelines/openxr-sdk-source.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Main azure-pipelines configuration for the OpenXR-SDK-Sources repo.
@@ -21,7 +21,7 @@ stages:
       - job: loader_docs
         pool:
           vmImage: "ubuntu-latest"
-        container: khronosgroup/docker-images:openxr-base.202110
+        container: khronosgroup/docker-images:openxr.20230209.1
         steps:
           - script: make loader
             workingDirectory: specification
@@ -34,7 +34,7 @@ stages:
       - job: archive
         pool:
           vmImage: "ubuntu-latest"
-        container: khronosgroup/docker-images:openxr-base.202110
+        container: khronosgroup/docker-images:openxr.20230209.1
         steps:
           - script: make loader
             workingDirectory: specification
@@ -62,7 +62,7 @@ stages:
               presentationBackend: wayland
         pool:
           vmImage: "ubuntu-latest"
-        container: khronosgroup/docker-images:openxr-sdk.202110
+        container: khronosgroup/docker-images:openxr-sdk.20230209
         steps:
           - task: DownloadPipelineArtifact@2
             displayName: Download archived OpenXR-SDK

.azure-pipelines/openxr-sdk.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Main azure-pipelines configuration for the OpenXR-SDK repo.

.azure-pipelines/shared/build_jobs.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 parameters:
@@ -26,7 +26,7 @@ jobs:
           presentationBackend: wayland
     pool:
       vmImage: "ubuntu-latest"
-    container: khronosgroup/docker-images:openxr-sdk.202110
+    container: khronosgroup/docker-images:openxr-sdk.20230209
     steps:
       # First build as debug
       - template: build_linux.yml

.azure-pipelines/shared/build_linux.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 parameters:

.azure-pipelines/shared/build_mingw.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 parameters:

.azure-pipelines/shared/build_msvc.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 parameters:

.azure-pipelines/shared/check_clang_format.yml

@@ -1,12 +1,12 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 jobs:
   - job: check_clang_format
     displayName: "clang-format"
     pool:
       vmImage: "ubuntu-latest"
-    container: khronosgroup/docker-images:openxr-sdk.202110
+    container: khronosgroup/docker-images:openxr-sdk.20230209
     steps:
       - script: ./runClangFormat.sh
         displayName: Run clang-format

.azure-pipelines/shared/check_file_format.yml

@@ -1,11 +1,11 @@
-# Copyright (c) 2020-2022, The Khronos Group Inc.
+# Copyright (c) 2020-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 jobs:
 - job: check_file_format
   displayName: 'Check file formatting'
   pool:
     vmImage: 'ubuntu-latest'
-  container: khronosgroup/docker-images:openxr-sdk.202110
+  container: khronosgroup/docker-images:openxr-sdk.20230209
   steps:
     - script: ./file_format.sh
       displayName: File formatting checks (file_format.sh)

.azure-pipelines/shared/codespell.yml

@@ -1,12 +1,12 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 jobs:
   - job: check_codespell
     displayName: "codespell"
     pool:
       vmImage: "ubuntu-latest"
-    container: khronosgroup/docker-images:openxr-sdk.202110
+    container: khronosgroup/docker-images:openxr-sdk.20230209
     steps:
       - script: ./checkCodespell
         displayName: Run Codespell script

.editorconfig

@@ -1,4 +1,4 @@
-# Copyright (c) 2017-2022, The Khronos Group Inc.
+# Copyright (c) 2017-2023, The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

.git-blame-ignore-revs

@@ -1,4 +1,4 @@
-# Copyright 2021-2022, The Khronos Group Inc. Inc.
+# Copyright 2021-2023, The Khronos Group Inc. Inc.
 #
 # SPDX-License-Identifier: CC-BY-4.0
 
@@ -40,3 +40,24 @@ bd1f05a6f5da8662c6969996177063a5a98bf0ea
 
 # OpenXR-CTS
 1224c0ba88b6f000a5f00f56c0dbb8265a6c6350
+
+
+## 1.0.27 - Bulk-apply PrettyRegistryXML
+
+# Khronos GitLab (commit also includes adding an extension)
+ff2037bc6aa951610f4e21d133056d3f547d2374
+
+# Khronos GitLab (finishing formatting)
+4bb0766ec6d7101b17b0bc02ba04c86c4159bd16
+
+# OpenXR-Docs
+09b6b4bae7d691e1406ee6951e5ab8ed4e620ff3
+
+# OpenXR-SDK-Source
+2c1b77dcdc6ace701e4b08477e5fae5312a866b4
+
+# OpenXR-CTS
+e774b36cfc7bfc721e97de6c8435fcb14866e6fa
+
+# OpenXR-SDK
+db11d03216666f2b574da46a39c4b565dbe90124

.gitattributes

@@ -1,4 +1,4 @@
-# Copyright (c) 2017-2022, The Khronos Group Inc.
+# Copyright (c) 2017-2023, The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

.github/scripts/install_vulkan.ps1

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022 The Khronos Group Inc.
+# Copyright (c) 2019-2023 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 $ErrorActionPreference = 'Stop'

.github/scripts/organize_windows_artifacts.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# Copyright (c) 2019-2022 The Khronos Group Inc.
+# Copyright (c) 2019-2023 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 from pathlib import Path

.github/workflows/check_clang_format_and_codespell.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, The Khronos Group Inc.
+# Copyright (c) 2019-2023, The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 name: Check code formatting and spelling
@@ -10,7 +10,7 @@ jobs:
   clang-format:
     runs-on: ubuntu-latest
     container:
-      image: khronosgroup/docker-images:openxr-sdk.202110
+      image: khronosgroup/docker-images:openxr-sdk.20230209
     steps:
       - uses: actions/checkout@v3
       - run: ./runClangFormat.sh

.gitignore

@@ -1,17 +1,23 @@
-# Copyright (c) 2017-2022, The Khronos Group Inc.
+# Copyright (c) 2017-2023, The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
 /build/
 build*/
 CMakeLists.txt.user
+CMakeCache.txt
+CMakeFiles
+*/CMakeFiles
 *.orig
 .*
 *~
 *.tar
 *.tar.gz
 *.log
 pregen/
+generated-includes
+cmake_install.cmake
+cmake_uninstall.cmake
 
 # Marker file for a snapshot build
 SNAPSHOT
@@ -35,6 +41,8 @@ out/build/
 # VS misc
 *.sln
 *.pyproj
+*.vcxproj
+*.vcxproj.filters
 CMakeSettings.json
 CppProperties.json
 

.proclamation.json.license

@@ -1,4 +1,4 @@
 Copyright (c) 2020 Collabora, Ltd. and the Proclamation contributors
-Copyright (c) 2020-2022, The Khronos Group Inc.
+Copyright (c) 2020-2023, The Khronos Group Inc.
 
 SPDX-License-Identifier: CC0-1.0

.reuse/dep5

@@ -4,9 +4,13 @@ Upstream-Contact: Ryan Pavlik <openxr-speceditor AT khronos DOT org>
 Source: https://khronos.org/registry/OpenXR/
 
 Files: changes/*
-Copyright: 2019-2022, The Khronos Group Inc.
+Copyright: 2019-2023, The Khronos Group Inc.
 License: CC-BY-4.0
 
+Files: specification/config/copyright-spec.adoc
+Copyright: 2014-2023 The Khronos Group Inc
+License: LicenseRef-KhronosSpecCopyright-WithNormativeWording-v10
+
 Files: src/tests/hello_xr/android_resources/vulkan/mipmap-xxhdpi/ic_helloxr_launcher.png
        src/tests/hello_xr/android_resources/vulkan/mipmap-mdpi/ic_helloxr_launcher.png
        src/tests/hello_xr/android_resources/vulkan/mipmap-xhdpi/ic_helloxr_launcher.png
@@ -17,13 +21,18 @@ Files: src/tests/hello_xr/android_resources/vulkan/mipmap-xxhdpi/ic_helloxr_laun
        src/tests/hello_xr/android_resources/opengles/mipmap-xhdpi/ic_helloxr_launcher.png
        src/tests/hello_xr/android_resources/opengles/mipmap-hdpi/ic_helloxr_launcher.png
        src/tests/hello_xr/android_resources/opengles/mipmap-xxxhdpi/ic_helloxr_launcher.png
-Copyright: Copyright (c) 2020-2022, The Khronos Group Inc.
+Copyright: Copyright (c) 2020-2023, The Khronos Group Inc.
   Copyright (c) 2020, Google
 License: Apache-2.0
 Comment: Based on a Material Icons asset ("emoji-people") with added text
   in "Miriam Libre" Bold, converted to path, and manually simplified.
   Rasterized with Android Studio.
 
+Files: src/external/catch2/*
+Copyright: Copyright (c) 2022 Two Blue Cubes Ltd.
+License: BSL-1.0
+Comment: Unmodified, vendored copy of Catch2 3.1.1
+
 Files: src/external/jsoncpp/*
 Copyright: 2007-2010 Baptiste Lepilleur and The JsonCpp Authors
 License: MIT OR LicenseRef-jsoncpp-public-domain
@@ -33,7 +42,7 @@ Files: src/external/jnipp/*
 Copyright: 2016-2020, Mitchell Dowd
   2020, Collabora, Ltd.
 License: MIT
-Comment: Ryan Pavlik at Collabora's fork
+Comment: Unmodified, vendored copy of commit e6c415837c5a487809fdbb2f71f1080d454eb99a
 
 Files: external/python/jinja2/*
   external/python/Jinja2-2.10.3.dist-info/*
@@ -74,6 +83,6 @@ Comment: Generated .png versions of an icon, created in Android Studio
   based on a Material Icons asset.
 
 Files: specification/scripts/vuidCounts.py
-Copyright: 2022 The Khronos Group Inc.
+Copyright: 2022-2023, The Khronos Group Inc.
 License: Apache-2.0
 Comment: File automatically rewritten by VUID assignment.

BUILDING.md

@@ -1,7 +1,7 @@
 # How to Build and Run
 
 <!--
-Copyright (c) 2014-2022, The Khronos Group Inc.
+Copyright (c) 2014-2023, The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->
@@ -10,7 +10,7 @@ SPDX-License-Identifier: CC-BY-4.0
 
 ### Python v3.6+ may be required
 
-**If you are building from most repostories:** (specifically, the
+**If you are building from most repositories:** (specifically, the
 OpenXR-SDK-Source repository, the OpenXR-CTS repository, or the internal Khronos
 GitLab OpenXR repository) Certain source files are generated at build time from
 the `xr.xml` file, utilizing Python scripts. The scripts make use of the Python