Skip to content

Releases: KhronosGroup/OpenXR-Registry

OpenXR Specification 1.1.41

26 Sep 15:15
release-1.1.41
Compare
Choose a tag to compare

OpenXR Specification 1.1.41 (2024-09-25)

This release features several new vendor extensions, as well as several
clarifications and improvements to existing specifications.

  • Registry
    • Change: Allow structs that can extend multiple other structs in the RelaxNG
      schema, as already permitted by the Vulkan schema.
      (internal MR 2869)
    • New vendor extension: XR_HTC_body_tracking
      (internal MR 2549)
    • New vendor extension: XR_ML_spatial_anchors
      (internal MR 2803)
    • New vendor extension: XR_ML_spatial_anchors_storage
      (internal MR 2804)
    • New vendor extension: XR_ML_system_notifications
      (internal MR 2946)
    • New vendor extension: XR_ML_world_mesh_detection
      (internal MR 2950)
    • New vendor extension: XR_ML_view_configuration_depth_range_change
      (internal MR 3036)
  • Specification
    • New vendor extension specification: XR_HTC_body_tracking provides an
      interface for full-body joint tracking.
      (internal MR 2549)
    • New vendor extension specification: XR_ML_spatial_anchors introduces an API
      to interact with Magic Leap spatial anchors.
      (internal MR 2803)
    • New vendor extension specification: XR_ML_spatial_anchors_storage allows for
      storage and retrieval of Magic Leap spatial anchors in local or cloud storage
      (internal MR 2804)
    • New vendor extension specification: XR_ML_system_notifications provides
      control over suppressing system notifications.
      (internal MR 2946)
    • New vendor extension specification: XR_ML_world_mesh_detection provides
      access to a world mesh.
      (internal MR 2950)
    • New vendor extension specification:
      XR_ML_view_configuration_depth_range_change permits the clipping planes to be
      changed by the runtime during the lifetime of an instance.
      (internal MR 3036)
    • Fix: Corrected swapchain image layout requirements for XR_KHR_D3D12_enable,
      XR_KHR_vulkan_enable, and XR_KHR_vulkan_enable2 so that the runtime's
      guarantees are made after xrWaitSwapchainImage returns XR_SUCCESS, instead
      of after xrAcquireSwapchainImage. (Queue access rules are unchanged.)
      (internal MR 3353,
      internal issue 2269)
    • Fix: references to core specification from
      XR_EXT_composition_layer_inverted_alpha and
      XR_FB_composition_layer_alpha_blend.
      (internal MR 3470)
    • Fix: markup for internal anchors for revision history subsections.
      (internal MR 3470)
    • Fix: remove a normative keyword from XR_META_headset_id version history.
      (internal MR 3470)
    • Improvement: Clean up formatting of source adoc files.
      (internal MR 3461)

OpenXR Specification 1.1.40

22 Aug 16:41
release-1.1.40
Compare
Choose a tag to compare

OpenXR Specification 1.1.40 (2024-08-22)

This release features a new ratified graphics API binding extension,
XR_KHR_metal_enable, as well as an update to the wording about environments
and environment blend modes, making it clear they can be used for physical as
well as synthetic passthrough. There are also an assortment of smaller fixes and
clarifications.

  • Registry
    • Add: New ratified Khronos extension: XR_KHR_metal_enable.
      (internal MR 2721)
    • Chore: Reserve 15 extension id numbers for ByteDance.
      (internal MR 3409)
    • Fix: Clarified that views in XR_VARJO_quad_views needs to have identical
      poses for each eye.
      (internal MR 3396)
    • Fix: Add missing interaction profile extensions for OpenXR 1.1 promoted Meta
      interaction profiles.
      (internal MR 3398)
    • Fix: Correctly mark the Magic Leap home button as a system button in the XML.
      (internal MR 3405)
    • Fix: Add XR_ERROR_VALIDATION_FAILURE to all functions from
      XR_EXT_conformance_automation.
      (internal MR 3417)
  • Specification
    • Add: New ratified Khronos extension specification: XR_KHR_metal_enable.
      (internal MR 2721)
    • Clarify: Clarify the definition of "environment" in the context of "environment
      blend mode".
      (internal MR 3301)
    • Clarify: Devices may use environment blend mode to control passthrough and
      synthentic environments.
      (internal MR 3301)
    • Clarify: Clarified that views in XR_VARJO_quad_views needs to have identical
      poses for each eye.
      (internal MR 3396)
    • Fix: Correct the maximum extension number in the appendix.
      (internal MR 3397)
    • Fix: Add missing interaction profile extensions for OpenXR 1.1 promoted Meta
      interaction profiles.
      (internal MR 3398)
    • Fix: Remove incorrect implicit valid usage from loader interface APIs.
      (internal MR 3416)
    • Fix: Fix a typo in the spec for xrCreateApiLayerInstance.
      (internal MR 3416)

Note: There is no 1.1.39 release: it was skipped to keep the monthly patch
version increment cadence given the lack of a release in July.

OpenXR Specification 1.1.38

10 Jun 22:07
release-1.1.38
Compare
Choose a tag to compare

OpenXR Specification 1.1.38 (2024-06-09)

This is a fairly small release, with one new extension and a handful of fixes.

  • Registry
    • Addition: New multi-vendor extension: XR_EXT_composition_layer_inverted_alpha
      (internal MR 3085,
      internal MR 3385)
    • Chore: Reserve an extension for Logitech.
      (internal MR 3384)
    • Chore: Register author tag for Deep Mirror.
      (OpenXR-Docs PR 171)
    • Fix: XrCompositionLayerPassthroughFB has a "parentstruct" of
      XrCompositionLayerBaseHeader (it is based on this type), rather than
      "structextends" (in the next chain). Bump extension revision.
      (internal MR 3305)
    • Fix: XR_EXT_plane_detection: Fix extents description and plane axis to match
      CTS and implementations.
      (internal MR 3374,
      internal issue 2281)
    • Fix: Correct typo in XR_FB_keyboard_tracking flag description.
      (internal MR 3393)
  • Specification
    • Addition: New multi-vendor extension specification:
      XR_EXT_composition_layer_inverted_alpha
      (internal MR 3085)
    • Addition: Support emitting more comment attributes/elements from XML, and
      enable it for standalone headers.
      (internal MR 3377)
    • Fix: Note errata regarding third field name in
      XrCompositionLayerPassthroughFB. Bump extension revision due to XML fix.
      (internal MR 3305)
    • Fix: XR_EXT_plane_detection: Fix extents description and plane axis to match
      CTS and implementations.
      (internal MR 3374,
      internal issue 2281)
    • Fix: Correct typo in XR_FB_keyboard_tracking flag description.
      (internal MR 3393)
    • Fix: Correct typo in loader design document.
      (internal MR 3393)

OpenXR Specification 1.1.37

25 May 02:27
release-1.1.37
Compare
Choose a tag to compare

OpenXR Specification 1.1.37 (2024-05-23)

This release adds new defines for easier use of both OpenXR 1.0 and 1.1 with
up-to-date headers, as well as some minor fixes, cleanups, and clarifications.

OpenXR Specification 1.1.36

15 Apr 05:42
release-1.1.36
Compare
Choose a tag to compare

OpenXR Specification 1.1.36 (2024-04-15)

This is a substantial update to the OpenXR specification.

Read more

OpenXR Specification 1.0.34

17 Feb 20:59
release-1.0.34
Compare
Choose a tag to compare

OpenXR Specification 1.0.34 (2024-02-16)

This release features clarifications to the specification, as well as a number
of new multi-vendor and vendor extensions, and additional functionality in the
reflection header.

  • Registry
  • Specification
    • Clarification: Change normative "should" statements to "may" for the
      interaction of user engagement sensors and the session lifecycle, in order to
      represent the intended and actual optionality of that behavior. Specifically,
      it is valid but completely optional for runtimes to use the user engagement
      sensor (if it exists) to move to XR_SESSION_STATE_STOPPING.
      (internal MR 3022)
    • Clarification: Swapchain usage flags errors should return
      XR_ERROR_FEATURE_UNSUPPORTED as well.
      (internal MR 3194)
    • New multi-vendor extension specification: XR_EXT_user_presence
      (internal MR 2706,
      internal issue 1585)
    • New vendor extension specification: XR_META_recommended_layer_resolution
      (internal MR 2570)
    • New vendor extension specification: XR_META_automatic_layer_filter
      (internal MR 2696)
    • New vendor extension specification: XR_META_spatial_entity_mesh
      (internal MR 2773)
    • New vendor extension specification: XR_FB_face_tracking2
      (internal MR 2811)
    • New vendor extension specification: XR_VARJO_xr4_controller_interaction
      (internal MR 3078)
    • Spec: Move originals of images to separate folder.
      (internal MR 3218)
    • Spec: Fix issue where some comments before defines were missing a newline.
      (internal MR 3227)
    • Style guide: Fix several leftover references to Vk/Vulkan.
      (internal MR 2967)
    • XR_FB_scene: Update to spec version 4.
      (internal MR 2774)
    • XR_META_headset_id and XR_FB_spatial_entity: Bump spec versions to drop
      XR_EXT_uuid dependency from spec.
      (internal MR 2577)
    • external: Update Jinja2 Python module shipped with repository (for spec/header
      generation) to 2.11.3.
      (internal MR 3221,
      internal MR 3237)

OpenXR Specification 1.0.33

04 Jan 23:31
release-1.0.33
Compare
Choose a tag to compare

OpenXR Specification 1.0.33 (2024-01-03)

This release primarily adds new ratified functionality to the specification
describing the loader interaction with runtimes and API layers. This
functionality was previously described in non-normative text in the loader
design document, but was universally adopted for compatibility. It is now part
of the normative, ratified core specification. This change only affects vendors
of runtimes and API layers as well as contributors to the OpenXR loader:
applications do not directly use this API, the loader uses it on their behalf. A
number of other small fixes are also included.

  • Registry
    • Extension reservation: Update author ID and reserve extensions for Varjo.
      (internal MR 3083)
    • Extension reservation: Reserve 10 extension ids each for ANDROIDX &
      ANDROIDSYS.
      (internal MR 3086)
    • Khronos ratified addition: Specify the existing loader negotiation functions
      (without modification) in the XML, moving from loader_interfaces.h to a new
      generated header openxr_loader_negotiation.h.
      (internal MR 2807,
      internal issue 1953)
    • XR_KHR_android_thread_settings: Fix the description of
      XrAndroidThreadTypeKHR enum values - they were swapped relative to their
      implicit meaning from their name.
      (internal MR 3077)
    • XR_MNDX_egl_enable: Update version to 2 to reflect function pointer type
      change released in 1.0.29.
      (OpenXR-Docs PR 159)
  • Specification
    • Khronos ratified specification addition: move loader negotiation functions into
      the specification proper (from the loader design doc), moving corresponding
      functions from loader_interfaces.h to openxr_loader_negotiation.h. (The
      exact ratified core specification text is 1.0.29 with these changes added,
      available internally. Non-substantive core specification updates/fixes have
      occurred since then.)
      (internal MR 2807,
      internal issue 1953,
      internal MR 3101)
    • Scripts: Adjust Makefile so we now error on any checkSpecLinks warning when
      running that target.
      (internal MR 3072)
    • XR_HTC_anchor: Fix parameter name error in prose description.
      (internal MR 3072)
    • XR_KHR_android_thread_settings: Fix the description of
      XrAndroidThreadTypeKHR enum values - they were swapped relative to their
      implicit meaning from their name.
      (internal MR 3077)
    • XR_MNDX_egl_enable: Update revision info and version to 2 to reflect function
      pointer type change released in 1.0.29.
      (OpenXR-Docs PR 159)
    • loader design doc: Fix minor typos.
      (internal MR 3065,
      internal MR 3103)
  • Misc
    • Update/correct names.
    • Ship a .mailmap file in the public repositories, maintained separately
      from the larger one used in the private monorepo, to correct names/emails
      and unify contributor identities.
    • Update Khronos Group copyright dates.

GitOrigin-RevId: a561c5898b72f59965790790a28bbc3b7e9bcf13

OpenXR Specification 1.0.32

29 Nov 22:01
release-1.0.32
Compare
Choose a tag to compare

OpenXR Specification 1.0.32 (2023-11-29)

This release contains a number of vendor extensions, plus a new ratified
revision to the XR_KHR_loader_init extension that specifies forwarding the
init calls to API layers. Vendors of API layers, primarily on Android, must
verify they can handle being passed XR_NULL_HANDLE for the instance parameter
of xrGetInstanceProcAddr, to avoid bugs when using the updated loader. This
release also features the remaining "checkSpecLinks" consistency warning fixes
in the manually-written specification text in extensions.

  • Registry
  • Specification
    • XR_KHR_loader_init: New Khronos ratified revision, now additionally specifies
      forwarding loader init calls to API layers
      (internal MR 2703)
    • Fix "checkSpecLinks" warnings about member and parameter references in
      extensions to the specification. This has changed the documentation of a number
      of structures and functions across several extensions, although the C
      prototypes/definitions in the spec as well as the header file contents have
      stayed constant.
      (internal MR 2970)
    • New vendor extension specification: XR_HTC_anchor
      (internal MR 2667)
    • New vendor extension specification: XR_META_touch_controller_plus
      (internal MR 2702)
    • New vendor extension specification: XR_ML_marker_understanding
      (internal MR 2750)
    • New vendor extension specification: XR_ML_localization_map
      (internal MR 2802,
      internal MR 3045,
      internal MR 3047)

GitOrigin-RevId: 0a6bbc30cf10fdec436dfa81abf27747251a0821

OpenXR Specification 1.0.31

19 Oct 16:18
release-1.0.31
Compare
Choose a tag to compare

OpenXR Specification 1.0.31 (2023-10-18)

This release features two new vendor extensions, some XML revisions to other
vendor extensions, and a substantial amount of fixes to the prose of the core
specification and some extensions. All specially-formatted mentions of a
parameter or field name (that is, names marked up with the pname macro in the
AsciiDoctor source) are now being checked by a script to be sure they are known.
With the fixes in this release, nearly all such name mentions now either (1)
match the function or structure in whose description they are mentioned, or (2)
have been qualified with the function or structure to which they do belong.
Misspellings, missing fields/parameters, and extraneous parameters have been
fixed as well. (Some fixes of this type to vendor extensions are still pending
and will be in an upcoming patch release.) While this has changed the prose, it
has not resulted in substantive changes to the XML, and therefore the code
snippets in the specification as well as the header files remain accurate and
unaffected by these fixes.

GitOrigin-RevId: 38114c3ba8eb46d6fafe1761ed08e263ce132237

OpenXR Specification 1.0.30

20 Sep 16:35
release-1.0.30
Compare
Choose a tag to compare

OpenXR Specification 1.0.30 (2023-09-20)

This release is primarily a quality improvement release, fixing a range of
issues in the registry and specification, in addition to a new vendor extension
and an updated vendor extension.

  • Registry
  • Specification
    • Clarify how prior frame state is reset when a session starts running.
      (internal MR 2759,
      internal issue 2029)
    • Clean up normative language in FB vendor extensions.
      (internal MR 2563)
    • Clean up normative language in the Rendering chapter.
      (internal MR 2801)
    • Fix formatting and markup errors in the loader design document.
      (internal MR 2866)
    • Fix generated broken links from valid usage in ref pages to the next chain
      fundamentals.
      (internal MR 2931,
      internal issue 1369)
    • Fix broken links and update URLs in specification, extension process, style
      guide, and loader doc.
      (internal MR 2935)
    • New vendor extension specification: XR_YVR_controller_interaction
      (internal MR 2841)
    • XR_BD_controller_interaction: Add support for G3 devices
      (internal MR 2872)
    • XR_EXT_debug_utils: Fix XML to reflect that
      XrDebugUtilsMessengerCallbackDataEXT parameters messageId and
      functionName are optional.
      (internal MR 2864)
    • scripts: Fix member name lookups in entity_db, enabling numerous spec
      warnings that had been hidden.
      (internal MR 2923)
    • Fix specification errors (core and extension) highlighted by fixed tooling.
      (internal MR 2923)

GitOrigin-RevId: f7a0c0f3691f0c7b0a239cb34e41d01042d5a02a