OpenXR SDK 1.1.52 (2025-09-19)

This release contains a new ratified Khronos extension, a new vendor
extension, fixes for issues in the XML registry, and API layer
improvements.

-   SDK
    -   Improvement: Adjust the enabled clang-tidy checks after
        resolving some minor identified warnings. (internal MR 3898)
    -   Layers: Fix: Skip checking members other than type and next on
        structs marked returnedonly="true" in core validation layer.
        (internal MR 3973)
    -   Layers: Fix: Rename KHR_best_practices_validation ->
        KHRONOS_best_practices_validation (internal MR 3984)
    -   Loader: Improvement: Further clean up defines related to
        XR_KHR_loader_init. (internal MR 3937, internal MR 3948)
-   Registry
    -   New ratified Khronos extension: XR_KHR_generic_controller
        (internal MR 3018)
    -   Update: Ratified XR_EXT_debug_utils (internal MR 3899)
    -   Update: Ratified XR_EXT_render_model (internal MR 3900)
    -   Update: Ratified XR_EXT_interaction_render_model (internal MR
        3901)
    -   New vendor extension: XR_META_spatial_entity_discovery.
        (internal MR 2880, internal MR 4001)
    -   Change: Revert XrTrackablePlaneANDROID::vertexCountOutput to a
        pointer, and increment extension version number. (internal MR
        3998)
    -   Chore: Reserve numbers for extensions. (internal MR 4004)
    -   Fix: Add XML for missing grip_surface paths for
        “/interaction_profiles/ext/hand_interaction_ext”. Note that
        these paths were already listed in the spec prose. Update
        XR_EXT_hand_interaction extension version to 2 for clarity.
        (internal MR 3963)
    -   Fix: Mark a few structure members that are bitmasks as optional,
        to match prose and/or usage intent. (internal MR 3973)
    -   Fix: Mark XrCompositionLayerPassthroughFB.space as optional to
        match spec prose. (internal MR 3973)
    -   Fix: Add XML for missing palm_ext/pose and grip_surface/pose
        paths for
        “/interaction_profiles/logitech/mx_ink_stylus_logitech”. Note
        that these paths were already listed in the spec prose.
        (internal MR 3996)

GitOrigin-RevId: eb32eb01dc51e194ed0e4d2626a5cd8b78cb2c9b

Author: rpavlik

.appveyor.yml

@@ -2,7 +2,7 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-version: 1.1.51.{build}
+version: 1.1.52.{build}
 image: Visual Studio 2017
 
 

CHANGELOG.SDK.md

@@ -21,6 +21,57 @@ along with any public pull requests that have been accepted.
 In this repository in particular, since it is primarily software,
 pull requests may be integrated as they are accepted even between periodic updates.
 
+## OpenXR SDK 1.1.52 (2025-09-19)
+
+This release contains a new ratified Khronos extension, a new vendor extension,
+fixes for issues in the XML registry, and API layer improvements.
+
+- SDK
+  - Improvement: Adjust the enabled clang-tidy checks after resolving some minor
+    identified warnings.
+    ([internal MR 3898](https://gitlab.khronos.org/openxr/openxr/merge_requests/3898))
+  - Layers: Fix: Skip checking members other than `type` and `next` on structs
+    marked `returnedonly="true"` in core validation layer.
+    ([internal MR 3973](https://gitlab.khronos.org/openxr/openxr/merge_requests/3973))
+  - Layers: Fix: Rename `KHR_best_practices_validation` ->
+    `KHRONOS_best_practices_validation`
+    ([internal MR 3984](https://gitlab.khronos.org/openxr/openxr/merge_requests/3984))
+  - Loader: Improvement: Further clean up defines related to XR_KHR_loader_init.
+    ([internal MR 3937](https://gitlab.khronos.org/openxr/openxr/merge_requests/3937),
+    [internal MR 3948](https://gitlab.khronos.org/openxr/openxr/merge_requests/3948))
+- Registry
+  - New ratified Khronos extension: `XR_KHR_generic_controller`
+    ([internal MR 3018](https://gitlab.khronos.org/openxr/openxr/merge_requests/3018))
+  - Update: Ratified `XR_EXT_debug_utils`
+    ([internal MR 3899](https://gitlab.khronos.org/openxr/openxr/merge_requests/3899))
+  - Update: Ratified `XR_EXT_render_model`
+    ([internal MR 3900](https://gitlab.khronos.org/openxr/openxr/merge_requests/3900))
+  - Update: Ratified `XR_EXT_interaction_render_model`
+    ([internal MR 3901](https://gitlab.khronos.org/openxr/openxr/merge_requests/3901))
+  - New vendor extension: `XR_META_spatial_entity_discovery`.
+    ([internal MR 2880](https://gitlab.khronos.org/openxr/openxr/merge_requests/2880),
+    [internal MR 4001](https://gitlab.khronos.org/openxr/openxr/merge_requests/4001))
+  - Change: Revert `XrTrackablePlaneANDROID::vertexCountOutput` to a pointer, and
+    increment extension version number.
+    ([internal MR 3998](https://gitlab.khronos.org/openxr/openxr/merge_requests/3998))
+  - Chore: Reserve numbers for extensions.
+    ([internal MR 4004](https://gitlab.khronos.org/openxr/openxr/merge_requests/4004))
+  - Fix: Add XML for missing `grip_surface` paths for
+    "/interaction_profiles/ext/hand_interaction_ext". Note that these paths were
+    already listed in the spec prose. Update `XR_EXT_hand_interaction` extension
+    version to `2` for clarity.
+    ([internal MR 3963](https://gitlab.khronos.org/openxr/openxr/merge_requests/3963))
+  - Fix: Mark a few structure members that are bitmasks as optional, to match prose
+    and/or usage intent.
+    ([internal MR 3973](https://gitlab.khronos.org/openxr/openxr/merge_requests/3973))
+  - Fix: Mark `XrCompositionLayerPassthroughFB.space` as optional to match spec
+    prose.
+    ([internal MR 3973](https://gitlab.khronos.org/openxr/openxr/merge_requests/3973))
+  - Fix: Add XML for missing `palm_ext/pose` and `grip_surface/pose` paths for
+    "/interaction_profiles/logitech/mx_ink_stylus_logitech".  Note that these paths
+    were already listed in the spec prose.
+    ([internal MR 3996](https://gitlab.khronos.org/openxr/openxr/merge_requests/3996))
+
 ## OpenXR SDK 1.1.51 (2025-08-28)
 
 This release adds a new API layer to assist developers in making an OpenXR

specification/Makefile

@@ -39,7 +39,7 @@ endif
 VERSIONS := XR_VERSION_1_0 XR_VERSION_1_1 XR_LOADER_VERSION_1_0
 VERSIONOPTIONS := $(foreach version,$(VERSIONS),-feature $(version))
 
-SPECREVISION = 1.1.51
+SPECREVISION = 1.1.52
 REVISION_COMPONENTS = $(subst ., ,$(SPECREVISION))
 MAJORMINORVER = $(word 1,$(REVISION_COMPONENTS)).$(word 2,$(REVISION_COMPONENTS))
 

specification/registry/xr.xml

@@ -23,7 +23,7 @@ configure_file(
 
 gen_xr_layer_json(
     "${CMAKE_CURRENT_BINARY_DIR}/../XrApiLayer_best_practices_validation.json"
-    KHR_best_practices_validation
+    KHRONOS_best_practices_validation
     "$<TARGET_FILE_NAME:XrApiLayer_best_practices_validation>"
     1
     "API Layer to modify runtime behavior in conformant but perhaps unexpected ways"

src/api_layers/best_practices/CMakeLists.txt

@@ -385,7 +385,6 @@ XRAPI_ATTR XrResult XRAPI_CALL BestPracticesLayerXrLocateViews(XrSession session
 XRAPI_ATTR XrResult XRAPI_CALL BestPracticesValidationLayerXrGetInstanceProcAddr(XrInstance instance, const char *name,
                                                                                  PFN_xrVoidFunction *function) {
     try {
-        std::string func_name = name;
         *function = BestPracticesLayerInnerGetInstanceProcAddr(name);
 
         if (*function != nullptr) {
@@ -417,7 +416,7 @@ XRAPI_ATTR XrResult XRAPI_CALL BestPracticesXrCreateApiLayerInstance(const XrIns
             XR_LOADER_INTERFACE_STRUCT_API_LAYER_NEXT_INFO != apiLayerInfo->nextInfo->structType ||
             XR_API_LAYER_NEXT_INFO_STRUCT_VERSION > apiLayerInfo->nextInfo->structVersion ||
             sizeof(XrApiLayerNextInfo) > apiLayerInfo->nextInfo->structSize ||
-            0 != strcmp("XR_APILAYER_KHR_best_practices_validation", apiLayerInfo->nextInfo->layerName) ||
+            0 != strcmp("XR_APILAYER_KHRONOS_best_practices_validation", apiLayerInfo->nextInfo->layerName) ||
             nullptr == apiLayerInfo->nextInfo->nextGetInstanceProcAddr ||
             nullptr == apiLayerInfo->nextInfo->nextCreateApiLayerInstance) {
             return XR_ERROR_INITIALIZATION_FAILED;

src/api_layers/best_practices/best_practices_validation.cpp

@@ -37,7 +37,12 @@ inline std::string to_hex(const uint8_t* const data, size_t bytes) {
 
 template <typename T>
 inline std::string to_hex(const T& data) {
-    return to_hex(reinterpret_cast<const uint8_t* const>(&data), sizeof(data));
+    return to_hex(reinterpret_cast<const uint8_t* const>(&data), sizeof(T));
+}
+
+template <typename T>
+inline std::string to_hex(T* const data) {
+    return to_hex(reinterpret_cast<const uint8_t* const>(&data), sizeof(T*));
 }
 
 #if XR_PTR_SIZE == 8

src/common/hex_and_handles.h

@@ -97,9 +97,6 @@ set_target_properties(
     openxr_loader PROPERTIES DEBUG_POSTFIX "${OPENXR_DEBUG_POSTFIX}"
 )
 
-# All platforms can now do something with the XR_KHR_loader_init extension.
-target_compile_definitions(openxr_loader PRIVATE XR_KHR_LOADER_INIT_SUPPORT=1)
-
 # TODO remove once we get rid of add_definitions()
 if(Vulkan_FOUND)
     target_include_directories(openxr_loader PRIVATE ${Vulkan_INCLUDE_DIR})

src/loader/CMakeLists.txt

@@ -288,7 +288,7 @@ XrResult ApiLayerInterface::LoadApiLayers(const std::string& openxr_command, uin
             LoaderLogger::LogWarningMessage(openxr_command, warning_message);
             continue;
         }
-#ifdef XR_HAS_REQUIRED_PLATFORM_LOADER_INIT_STRUCT  // _platform_info is only available on some platforms.
+#if defined(XR_HAS_REQUIRED_PLATFORM_LOADER_INIT_STRUCT)  // Cannot proceed without mandatory xrInitializeLoaderKHR call.
         if (!LoaderInitData::instance().initialized()) {
             LoaderLogger::LogErrorMessage(openxr_command, "ApiLayerInterface::LoadApiLayers skipping manifest file " +
                                                               manifest_file->Filename() +

src/loader/api_layer_interface.cpp

@@ -75,7 +75,6 @@ inline bool IsMissingNullTerminator(const char (&str)[max_length]) {
 }
 
 // ---- Core 1.0 manual loader trampoline functions
-#ifdef XR_KHR_LOADER_INIT_SUPPORT  // platforms that support XR_KHR_loader_init.
 static XRAPI_ATTR XrResult XRAPI_CALL LoaderXrInitializeLoaderKHR(const XrLoaderInitInfoBaseHeaderKHR *);
 
 static XRAPI_ATTR XrResult XRAPI_CALL LoaderXrInitializeLoaderKHR(const XrLoaderInitInfoBaseHeaderKHR *loaderInitInfo)
@@ -84,7 +83,6 @@ static XRAPI_ATTR XrResult XRAPI_CALL LoaderXrInitializeLoaderKHR(const XrLoader
     return InitializeLoaderInitData(loaderInitInfo);
 }
 XRLOADER_ABI_CATCH_FALLBACK
-#endif
 
 static XRAPI_ATTR XrResult XRAPI_CALL LoaderXrEnumerateApiLayerProperties(uint32_t propertyCapacityInput,
                                                                           uint32_t *propertyCountOutput,
@@ -761,12 +759,8 @@ XRAPI_ATTR XrResult XRAPI_CALL LoaderXrGetInstanceProcAddr(XrInstance instance,
         *function = reinterpret_cast<PFN_xrVoidFunction>(LoaderXrGetInstanceProcAddr);
         return XR_SUCCESS;
     } else if (strcmp(name, "xrInitializeLoaderKHR") == 0) {
-#ifdef XR_KHR_LOADER_INIT_SUPPORT
         *function = reinterpret_cast<PFN_xrVoidFunction>(LoaderXrInitializeLoaderKHR);
         return XR_SUCCESS;
-#else
-        return XR_ERROR_FUNCTION_UNSUPPORTED;
-#endif
     } else if (strcmp(name, "xrEnumerateApiLayerProperties") == 0) {
         *function = reinterpret_cast<PFN_xrVoidFunction>(LoaderXrEnumerateApiLayerProperties);
         return XR_SUCCESS;
@@ -845,3 +839,7 @@ LOADER_EXPORT XRAPI_ATTR XrResult XRAPI_CALL xrGetInstanceProcAddr(XrInstance in
                                                                    PFN_xrVoidFunction *function) {
     return LoaderXrGetInstanceProcAddr(instance, name, function);
 }
+
+LOADER_EXPORT XRAPI_ATTR XrResult XRAPI_CALL xrInitializeLoaderKHR(const XrLoaderInitInfoBaseHeaderKHR *loaderInitInfo) {
+    return LoaderXrInitializeLoaderKHR(loaderInitInfo);
+}