OpenXR Specification (Source) 1.0.27

OpenXR Specification 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, several spec cleanups and clarifications, and a wide
variety of new vendor and multi-vendor extensions.

• 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)
• Specification
  • Add missing "IP Status" data to XR_FB_display_refresh_rate.
    (internal MR 2439)
  • Added the function call for xrPollEvent to the typical XR app sample.
    (internal MR 2605)
  • Clarify that passing 0 for elementCapacityInput in two-call idiom functions
    is explicitly valid usage, but there may be other reasons that an error is
    returned.
    (internal MR 2492)
  • Clarify that system vendor ids match USB vendor ids.
    (internal MR 2634)
  • Clean up markup of various two-call idiom mentions in the core.
    (internal MR 2619)
  • Fix use of normatives in paragraph introducing the concept of extensions.
    (internal MR 2466)
  • Fix a language error in xrDestroySpace description language: it destroys a
    space, not creates one.
    (internal MR 2516)
  • Fix broken internal links in XR_FB_triangle_mesh specification.
    (internal MR 2593)
  • Fix typo in description of function pointer naming in Appendix.
    (internal MR 2599)
  • Fix typos in Fundamentals chapter
    (internal MR 2608)
  • Fixed sample code which was missing specifying the view configuration type to
    locate with xrLocateViews
    ([internal MR 2624](https://gitlab.khronos.org/openxr/openxr/merge_requests...

OpenXR Specification (Source) 1.0.26

OpenXR Specification 1.0.26 (2022-11-18)

This release contains some spec clarifications, improvements to tooling, and a
variety of new vendor and multi-vendor extensions.

• Registry
  • Add a warning to XR_COMPOSITION_LAYER_CORRECT_CHROMATIC_ABERRATION_BIT saying
    that it is not in use and planned for deprecation
    (internal MR 2378,
    internal issue 1751)
  • Add new XR_EXT_active_action_set_priority vendor extension.
    (internal MR 2288,
    internal issue 1699)
  • Add new XR_HTC_passthrough vendor extension.
    (internal MR 2349)
  • Add new XR_HTC_foveation vendor extension.
    (internal MR 2377)
  • Add new XR_META_headset_id vendor extension.
    (internal MR 2410)
  • Improve Schematron rules for the registry XML and update the tool version used.
    (internal MR 2418,
    internal MR 2426,
    internal MR 2457,
    internal MR 2460,
    internal MR 2465)
  • Register author ID and reserve vendor extensions for ByteDance.
    (internal MR 2482,
    OpenXR-Docs PR 137)
  • Register author ID for danwillm and reserve vendor extensions.
    (OpenXR-Docs PR 138)
  • Reserve vendor extensions for Microsoft.
    (internal MR 2478)
  • XR_EXTX_overlay: Fix XML markup to correct generated valid usage for the
    event structure.
    (internal MR 2307)
  • XR_EXT_performance_settings: Fix XML markup to correct generated valid usage,
    bump revision.
    (internal MR 2306)
  • XR_HTCX_vive_tracker_interaction: Fix XML markup to correct generated valid
    usage for the event structure.
    (internal MR 2310)
  • XR_HTC_facial_tracking: Update vendor extension to version 2.
    (internal MR 2416)
  • specification/scripts: Added new functionality in codegen scripts to support
    creating single extension headers. Usage: python3 scripts/genxr.py -registry registry/xr.xml -standaloneExtension XR_FB_color_space standalone_header
    (internal MR 2417)
• Specification
  • Clarify the valid swapchain face count values for layer types.
    (internal MR 2354,
    internal issue 1750)
  • Clarify error codes returned in vendor extension XR_META_performance_metrics.
    (internal MR 2422)
  • Clarify function xrEnumerateInstanceExtensionProperties by removing
    conflicting and redundant language about two-call idiom.
    (internal MR 2441)
  • Clarify language around swapchain creation format matching usage.
    (internal MR 2446)
  • Document new XR_EXT_active_action_set_priority vendor extension.
    (internal MR 2288,
    internal issue 1699)
  • Document new XR_HTC_passthrough vendor extension.
    (internal MR 2349)
  • Document new XR_HTC_foveation vendor extension.
    (internal MR 2377)
  • Document new XR_META_headset_id vendor extension.
    (internal MR 2410)
  • Fix naming of member descriptions for XrInputSourceLocalizedNameGetInfo.
    (internal MR 2419,
    internal issue 1614,
    OpenXR-Docs issue 106)
  • Loader spec: Update to note that the Android installable broker no longer checks for
    permission. The permission, normally auto-granted, was removed due to causing
    conflicts with installation order.
    (internal MR 2452,
    internal issue 1836)
  • Move the documentation of XrSwapchainUsageFlags/XrSwapchainUsageFlagBits to
    its usage, next to XrSwapchainCreateFlags, and mark up normative language.
    (internal MR 2435)
  • Move flag bit documentation to the FlagBit type ref pages, and move the
    typedefs for the Flags types into new corresponding flag ref pages. This
    resolves an unneeded inconsistency between core and extensions as well as
    between core and other related specifications like Vulkan.
    (internal MR 2435)
  • Optimize images included in the specification.
    (internal MR 2493)
  • XR_EXT_performance_settings: Updated generated valid usage through XML
    change, bump revision accordingly.
    (internal MR 2306)
  • XR_HTC_facial_tracking: Update vendor extension to fix an error in the blink
    blend shape ranges, increasing its revision to 2.
    (internal MR 2416)
  • XR_KHR_vulkan_enable2 - Add missing member documentation for type, next,
    and createFlags in XrVulkanInstanceCreateInfoKHR
    (internal MR 2435)

OpenXR Specification (Source) 1.0.25

OpenXR Specification 1.0.25 (2022-09-02)

This release contains a few specification clarifications and consistency improvements,
as well as some new vendor extensions. The spec generation toolchain scripts have
been synchronized with Vulkan, which adds some additional detail to the generated
spec document. The loader design document has also been updated to correct an error
and document the loader's API layer functionality now available on Android.

• Registry
  • Add new XR_ML_ml2_controller_interaction vendor extension.
    (internal MR 2344)
  • Clarification: Note that all specialized swapchain image structures are
    "returnedonly", which removes some unneeded generated implicit valid usage.
    (internal MR 2303)
  • Clarification: Note that all event structs are "returnedonly", which removes
    some unneeded generated implicit valid usage.
    (internal MR 2305)
  • Register author ID for Oppo.
    (OpenXR-Docs PR 129)
  • Register author ID for Fred Emmott.
    (OpenXR-Docs PR 131)
  • Register author ID for Acer.
    (OpenXR-Docs PR 132)
  • Reserve extension numbers for anticipated cross-vendor and Khronos extensions.
    (internal MR 2337,
    internal MR 2338,
    internal MR 2389)
  • Reserve a vendor extension for Huawei.
    (internal MR 2356)
  • Reserve vendor extensions for MNDX.
    (OpenXR-Docs PR 133)
  • Update XR_MSFT_scene_understanding and
    XR_MSFT_scene_understanding_serialization vendor extensions to list error
    codes that may be returned by functions.
    (internal MR 2316)
  • XR_FB_color_space: Mark XrSystemColorSpacePropertiesFB as "returned-only"
    for consistency and to correct the implicit valid usage.
    (internal MR 2304)
  • XR_FB_display_refresh_rate: Mark XrEventDataDisplayRefreshRateChangedFB as
    "returned only" for consistency.
    (internal MR 2308)
  • XR_FB_hand_tracking_mesh: Fix two-call-idiom markup for
    XrHandTrackingMeshFB, affecting implicit valid usage, and increment the
    revision.
    (internal MR 2311)
  • XR_FB_passthrough: Add XrSystemPassthroughProperties2FB and
    XR_PASSTHROUGH_LAYER_DEPTH_BIT_FB, update spec version to 3.
    (internal MR 2333)
  • XR_FB_render_model: Mark XrRenderModelCapabilitiesRequestFB as "returned-
    only" for consistency and to correct the implicit valid usage.
    (internal MR 2309)
• Specification
  • Clarify that orientation behaves the same as position when tracking loss occurs
    for static spaces.
    (internal MR 2235)
  • Clarify the interaction of xrGetInputSourceLocalizedName and
    xrEnumerateBoundSourcesForAction, the paths they operate on, and details of a
    "bound source" for an action.
    (internal MR 2251,
    internal issue 1671)
  • Clarify when pose actions with multiple bindings may change source
    (internal MR 2277)
  • Clarify: Add language to OpenXR patch versions to clarify that it may be used
    to gate runtime implementation changes
    (internal MR 2290,
    internal issue 1713)
  • Document new XR_ML_ml2_controller_interaction vendor extension with the Magic
    Leap 2 controller interaction profile.
    (internal MR 2344)
  • Loader design doc: Correct a wrong description of extension implementation
    chosen by the loader when duplicates.
    (internal MR 2324,
    internal issue 1731)
  • Loader design doc: Add Android support for API Layers in the application APK.
    (internal MR 2350)
  • XR_FB_color_space: Mark XrSystemColorSpacePropertiesFB as "returned-only"
    for consistency and to correct the implicit valid usage, bumping the revision
    number.
    (internal MR 2304)
  • XR_FB_hand_tracking_mesh: Fix XrHandTrackingMeshFB two-call-idiom implicit
    valid usage, and increment the revision.
    (internal MR 2311)
  • XR_FB_passthrough: Add XrSystemPassthroughProperties2FB and
    XR_PASSTHROUGH_LAYER_DEPTH_BIT_FB.
    (internal MR 2333,
    internal MR 2393)
  • XR_FB_render_model: Mark XrRenderModelCapabilitiesRequestFB, as "returned-
    only" for consistency and to correct the implicit valid usage, incrementing the
    revision number.
    (internal MR 2309)
  • XR_MSFT_scene_understanding_serialization: Update vendor extension to
    document when xrDeserializeSceneMSFT must return
    XR_ERROR_COMPUTE_NEW_SCENE_NOT_COMPLETED_MSFT.
    (internal MR 2316)
  • scripts: Synchronize scripts with Vulkan, and move all generated files into a
    single target directory.
    (internal MR 2335,
    internal issue 1693,
    internal MR 2393,
    internal MR 2400)

OpenXR Specification (Source) 1.0.24

OpenXR Specification 1.0.24 (2022-06-23)

• Registry
  • Add new XR_EXT_palm_pose multi-vendor extension.
    (internal MR 2112)
  • Add new XR_FB_scene vendor extension.
    (internal MR 2237)
  • Fix structure definition in XR_FB_spatial_entity_container.
    (internal MR 2278)
  • scripts: Teach xr_conventions that 2D, 3D, etc. are words for the purposes of
    structure type enum generation.
    (internal MR 2237)
• Specification
  • Clarify inconsistent specified semantics for array getters/two-call idiom,
    resolving ambiguity in favor of the fundamentals section on buffer size
    parameters.
    (OpenXR-Docs PR 104,
    OpenXR-Docs issue 94,
    internal issue 1599,
    internal issue 1612)
  • Document new XR_EXT_palm_pose multi-vendor extension.
    (internal MR 2112)
  • Document new XR_FB_scene vendor extension.
    (internal MR 2237)
  • Fix documentation for xrApplyHapticFeedback to specify the correct action
    type.
    (internal MR 2268)
  • Fix structure definition in XR_FB_spatial_entity_container.
    (internal MR 2278)

OpenXR Specification (Source) 1.0.23

OpenXR Specification 1.0.23 (2022-05-27)

This release includes a large number of new vendor and multi-vendor extensions,
as well as some updates to existing extensions. It also adds some details about
app manifest requirements on Android.

• Registry
  • Add new XR_ULTRALEAP_hand_tracking_forearm vendor extension.
    (internal MR 2154)
  • Add new XR_EXT_dpad_binding multi-vendor extension.
    (internal MR 2159)
  • Add "externally synchronized" markup for xrBeginFrame and xrEndFrame so
    they get the matching box and their session parameters are included in the list
    of externally-synchronized parameters in the "Threading" section.
    (internal MR 2179,
    OpenXR-Docs issue 23,
    internal issue 1216)
  • Add new XR_FB_spatial_entity vendor extension.
    (internal MR 2194)
  • Add new XR_FB_spatial_entity_storage vendor extension.
    (internal MR 2194)
  • Add new XR_FB_spatial_entity_query vendor extension.
    (internal MR 2194)
  • Add new XR_FB_composition_layer_settings vendor extension.
    (internal MR 2221)
  • Add new XR_FB_spatial_entity_container vendor extension.
    (internal MR 2236)
  • Add new XR_HTC_vive_wrist_tracker_interaction vendor extension.
    (internal MR 2252)
  • Add XR_HTC_hand_interaction extension.
    (internal MR 2254)
  • Add new XR_VARJO_view_offset vendor extension.
    (internal MR 2255)
  • Add new XR_META_performance_metrics vendor extension.
    (internal MR 2256)
  • Add new XR_META_vulkan_swapchain_create_info vendor extension.
    (internal MR 2257)
  • Change the XML type of XR_MIN_COMPOSITION_LAYERS_SUPPORTED so it outputs an
    includable snippet for the spec text.
    (internal MR 2201,
    internal issue 1652,
    OpenXR-Docs issue 117)
  • Fix registry consistency script and codegen scripts to allow extension of KHR
    and EXT enumerations with vendor-specific members.
    (internal MR 2213,
    internal MR 2243)
  • Fix warning print statement arguments in header generation/validation script.
    (internal MR 2244)
  • Reserve the extension number for multi-vendor hand interaction profile
    extension.
    (internal MR 2206)
  • Reserve vendor extensions 304-317 for Qualcomm
    (internal MR 2258)
  • Reserve vendor extensions 318-370 for HTC.
    (internal MR 2266)
  • KHR_composition_layer_depth: Update spec version to 6 for updated spec text.
    (internal MR 2207,
    internal issue 1651)
  • XR_EXT_eye_gaze_interaction: Update the spec version for spec text change.
    (internal MR 2227)
  • XR_EXT_uuid: Add enum tags to XR_UUID_SIZE_EXT to ensure it is defined
    before XrUuidEXT in generated header
    (internal MR 2234,
    internal issue 1673)
  • XR_FB_hand_aim_tracking, XR_FB_hand_tracking_capsule,
    XR_FB_hand_tracking_mesh: Fix documentation to specify correct next chain
    usage.
    (internal MR 2229)
  • XR_FB_hand_tracking_capsules: Update XrHandCapsuleFB and
    XrHandTrackingCapsulesStateFB to use
    XR_HAND_TRACKING_CAPSULE_POINT_COUNT_FB and
    XR_HAND_TRACKING_CAPSULE_COUNT_FB enums when defining arrays so they match
    the usual practice for vendor extensions
    (internal MR 2216)
  • XR_FB_passthrough_keyboard_hands: Add
    XR_PASSTHROUGH_LAYER_PURPOSE_TRACKED_KEYBOARD_MASKED_HANDS_FB, update spec
    version to 2.
    (internal MR 2270)
  • XR_FB_passthrough: add XrPassthroughBrightnessContrastSaturationFB, update
    spec version to 2
    (internal MR 2222)
  • XR_FB_render_model: Add capability support levels, bump spec version to 2.
    (internal MR 2264)
  • XR_FB_space_warp: Add
    XR_COMPOSITION_LAYER_SPACE_WARP_INFO_FRAME_SKIP_BIT_FB into
    XrCompositionLayerSpaceWarpInfoFlagBitsFB, update spec version to 2.
    (internal MR 2193)
  • XR_HTC_vive_focus3_controller_interaction: Support component path
    "/input/squeeze/value", update spec version to 2.
    (internal MR 2253)
  • XR_KHR_D3D11_enable and XR_KHR_D3D12_enable: Update to describe error
    conditions for XR_ERROR_GRAPHICS_DEVICE_INVALID.
    (internal MR 2176,
    internal issue 1617)
  • XR_MSFT_spatial_graph_bridge: Update to revision 2.
    (internal MR 2182)
• Specification
  • Add spec language for XR_MIN_COMPOSITION_LAYERS_SUPPORTED.
    (internal MR 2201,
    internal issue 1652,
    OpenXR-Docs issue 117)
  • Add a few level 4 headers so the sub chapters in extensions can be referenced
    with anchors.
    (internal MR 2205)
  • Add text in the appendix describing adding
    org.khronos.openxr.intent.category.IMMERSIVE_HMD category to intent-filter
    for AndroidManifest.xml, to indicate an immersive application.
    (internal MR 2219)
  • Change instances of Samsung Electronics authorship references to only have
    first and last name of author, and to spell out Samsung Electronics instead of
    just Samsung.
    (internal MR 2211)
  • Clarify that XR_SPACE_VELOCITY_LINEAR_VALID_BIT and
    XR_SPACE_VELOCITY_ANGULAR_VALID_BIT work just like
    XR_SPACE_LOCATION_POSITION_VALID_BIT and
    XR_SPACE_LOCATION_ORIENTATION_VALID_BIT: Don't read the corresponding field
    if it's not set.
    (internal MR 2185,
    OpenXR-Docs issue 35,
    internal issue 1264)
  • Document new XR_HTC_hand_interaction extension.
    (internal MR 2254)
  • Document new XR_ULTRALEAP_hand_tracking_forearm vendor extension.
    (internal MR 2154)
  • Document new XR_EXT_dpad_binding multi-vendor extension.
    (internal MR 2159)
  • Document new XR_FB_spatial_entity vendor extension.
    (internal MR 2194)
  • Document new XR_FB_spatial_entity_storage vendor extension.
    (internal MR 2194)
  • Document new XR_FB_spatial_entity_query vendor extension.
    (internal MR 2194)
  • Document out of range XrSwapchainSubImage imageArrayIndex
    (internal MR 2220)
  • Document new XR_FB_composition_layer_settings vendor extension.
    (internal MR 2221)
  • Document new XR_FB_spatial_entity_container vendor extension.
    (internal MR 2236)
  • Document new XR_HTC_vive_wrist_tracker_interaction vendor extension.
    (internal MR 2252)
  • Document new XR_VARJO_view_offset vendor extension.
    (internal MR 2255)
  • Document new XR_META_performance_metrics vendor extension.
    ([internal MR 2256](https://gitl...

OpenXR Specification (Source) 1.0.22

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
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.

OpenXR Specification (Source) 1.0.21

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

OpenXR Specification (Source) 1.0.20

OpenXR Specification 1.0.20 (2021-10-04)

This release includes a number of new vendor extensions and a few minor clarifications.

• Registry
  • Add new XR_HTCX_vive_tracker_interaction provisional vendor extension.
    (internal MR 1983)
  • Add new XR_VARJO_marker_tracking vendor extension.
    (internal MR 2129)
  • Add new XR_FB_triangle_mesh vendor extension.
    (internal MR 2130)
  • Add new XR_FB_passthrough vendor extension.
    (internal MR 2130)
  • Reserve vendor extensions for Facebook.
    (internal MR 2131)
  • Reserve a vendor extension for Almalence.
    (OpenXR-Docs PR 99)
  • XR_FB_color_space: Fix XML markup to indicate that
    XrSystemColorSpacePropertiesFB is chained to XrSystemProperties.
    (internal MR 2143)
• Specification
  • Clarify that swapchain image wait must not timeout before releasing.
    (internal MR 2134,
    OpenXR-Docs issue 101,
    internal issue 1603)
  • D3D11 and D3D12 extensions: Specify handling of swapchain usage flags.
    (internal MR 2133,
    internal issue 1500)
  • OpenGL and OpenGL ES extensions: Specify handling of swapchain usage flags.
    (internal MR 2127,
    internal issue 1500)
  • Document new XR_HTCX_vive_tracker_interaction provisional vendor extension.
    (internal MR 1983)
  • Document new XR_VARJO_marker_tracking vendor extension.
    (internal MR 2129)
  • Document new XR_FB_triangle_mesh vendor extension.
    (internal MR 2130)
  • Document new XR_FB_passthrough vendor extension.
    (internal MR 2130)
  • Fix generated links from OpenXR ref pages to Vulkan ref pages.
    (internal MR 2126)
  • Loader specification: Describe a cross-vendor loader for use on Android.
    (internal MR 1949,
    internal issue 1425)
  • Scripts: Fix reflow script error message and make sure it creates the necessary
    output directory.
    (OpenXR-Docs PR 97)

OpenXR Specification (Source) 1.0.19

OpenXR Specification 1.0.19 (2021-08-24)

This release features a number of new or updated vendor extensions, as well as
some minor spec clarifications.

• Registry
  • Add XR_SESSION_NOT_FOCUSED as a possible success return code to
    xrApplyHapticFeedback and xrStopHapticFeedback.
    (internal MR 2106,
    internal issue 1270)
  • Add new XR_FB_hand_tracking_mesh vendor extension.
    (internal MR 2089)
  • Add new XR_FB_hand_tracking_capsules vendor extension.
    (internal MR 2089)
  • Add new XR_FB_hand_tracking_aim vendor extension.
    (internal MR 2089)
  • Add version 1 of new XR_FB_space_warp vendor extension.
    (internal MR 2115)
  • Register new Author ID for Almalence.
    (OpenXR-Docs PR 92,
    OpenXR-Docs PR 93)
  • Update to version 2 of XR_VALVE_analog_threshold.
    (internal MR 2113)
• Specification
  • Clarifies the imageRect in XrSwapchainSubImage uses a graphics API-specific
    coordinate origin.
    (internal MR 2104,
    OpenXR-Docs issue 86,
    internal issue 1587)
  • Clarify text that haptics are suppressed when the session does not have or
    loses focus.
    (internal MR 2106,
    internal issue 1270)
  • Document new XR_FB_hand_tracking_mesh vendor extension.
    (internal MR 2089)
  • Document new XR_FB_hand_tracking_capsules vendor extension.
    (internal MR 2089)
  • Document new XR_FB_hand_tracking_aim vendor extension.
    (internal MR 2089)
  • Document updated version 2 of XR_VALVE_analog_threshold. This adapts the
    extension for usage with XR_KHR_binding_modification, deprecating the
    previous direct binding modification technique.
    (internal MR 2113)
  • Document version 1 of new XR_FB_space_warp vendor extension.
    (internal MR 2115)
  • scripts: Some typing annotations and type-related cleanup found by using type-
    aware Python editors.
    (internal MR 2100)

OpenXR Specification (Source) 1.0.18

OpenXR Specification 1.0.18 (2021-07-30)

The main changes in this release include clarifications to the Session chapter
of the specification, plus the addition of diagrams to the text describing grip
and aim pose. The release also adds one new ratified KHR extension (promoted
from a vendor extension), and a number of new vendor extensions.

• Registry
  • Add ratified XR_KHR_swapchain_usage_input_attachment_bit Khronos extension.
    (Promotion of XR_MND_swapchain_usage_input_attachment_bit, which is now
    deprecated.)
    (internal MR 2045)
  • Add new XR_FB_foveation, XR_FB_foveation_configuration, and
    XR_FB_foveation_vulkan vendor extensions.
    (internal MR 2050)
  • Add additional extension dependencies to XR_FB_swapchain_update_state.
    (internal MR 2072,
    internal issue 1572)
  • Add new XR_FB_composition_layer_secure_content vendor extension.
    (internal MR 2075)
  • Add new XR_FB_composition_layer_alpha_blend vendor extension.
    (internal MR 2078)
  • Add new XR_FB_composition_layer_image_layout vendor extension.
    (internal MR 2090)
  • Add new XR_MSFT_spatial_anchor_persistence vendor extension.
    (internal MR 2093)
  • Add some simple Schematron rules and a script to
    check the XML registry against them.
    (internal MR 2103)
  • Register author ID and reserve vendor extensions for Unity.
    (internal MR 2105)
  • Reserve extension ID range 187-196 for LIV Inc.
    (internal MR 2102)
• Specification
  • Rewrite the introduction of Session chapter to explain a typical session
    lifecycle.
    (internal MR 2087)
  • Add grip diagram to specification
    (internal MR 2092,
    internal issue 1545,
    OpenXR-Docs PR 45,
    OpenXR-Docs issue 44)
  • Describe how runtimes may register themselves at installation time for manual
    selection.
    (internal MR 2081,
    internal MR 2109,
    internal issue 1574)
  • Document new ratified XR_KHR_swapchain_usage_input_attachment_bit Khronos
    extension. (Promotion of XR_MND_swapchain_usage_input_attachment_bit, which
    is now deprecated.)
    (internal MR 2045)
  • Document new XR_FB_foveation, XR_FB_foveation_configuration, and
    XR_FB_foveation_vulkan vendor extensions.
    (internal MR 2050)
  • Document new XR_FB_composition_layer_secure_content vendor extension.
    (internal MR 2075)
  • Document new XR_FB_composition_layer_alpha_blend vendor extension.
    (internal MR 2078)
  • Document new XR_FB_composition_layer_image_layout vendor extension.
    (internal MR 2090)
  • Document new XR_MSFT_spatial_anchor_persistence vendor extension.
    (internal MR 2093)
  • Minor cleanups to the loader documentation/specification.
    (internal MR 2108)
  • Revise Varjo vendor extensions so that the sample code is buildable (and build
    during CI testing).
    (internal MR 2020)
  • Scripts: Verify externsync attributes of destroy calls.
    (internal MR 2065)
  • Update XR_MSFT_spatial_anchor to note the external sync requirements of the
    destroy call.
    (internal MR 2065)
  • Add missing copyright/license notice for FB extension sources
    (internal MR 2076,
    internal issue 1562)
  • Add missing item to new enum constants of spatial anchors extension
    (internal MR 2088)
  • scripts: Handle aliased bitmask values properly in header files.
    (internal MR 2045)