How khronosgroup/openxr-sdk works
This repository packages the OpenXR public headers and the native loader. An application uses the OpenXR API; the loader initializes instance state, discovers runtime and API-layer manifests, and forwards API calls through generated trampolines and dispatch tables to the selected runtime. The tree also includes loader logging and shared object/handle utilities. The README establishes the SDK/loader role; source excerpts show selected loader, manifest, and dispatch behavior, so links beyond those are omitted where wiring is not evidenced.
Main entry points: loader_core.cpp Loader core · manifest_file.cpp Manifest discovery · xr_generated_loader.cpp API trampolines · api_layer_interface.cpp API layer interface
Components 17
Public API
- OpenXR headers
include/openxr/openxr.h - Platform headers
include/openxr/openxr_platform.h - Loader negotiation
include/openxr/openxr_loader_negotiation.h
Loader Runtime
- Loader core
src/loader/loader_core.cpp - API trampolines
src/loader/xr_generated_loader.cpp - Dispatch tables
src/xr_generated_dispatch_table_core.h - Instance state
src/loader/loader_instance.hpp - Loader initialization
src/loader/loader_init_data.hpp
Runtime Discovery
- API layer interface
src/loader/api_layer_interface.cpp - Manifest discovery
src/loader/manifest_file.cpp - Runtime interface
src/loader/runtime_interface.hpp
Loader Support
- Platform library loading
src/loader/loader_platform.hpp - Loader logging
src/loader/loader_logger.hpp - Debug object info
src/common/object_info.h - Handle utilities
src/common/hex_and_handles.h - Platform utilities
src/common/platform_utils.hpp
Other components
- OpenXR application
Connections 19
- OpenXR application → OpenXR headers: uses API
README.md - OpenXR application → Platform headers: uses platform API
README.md - Loader core → Instance state: creates instance
src/loader/loader_core.cpp - Loader core → API layer interface: uses layers
src/loader/loader_core.cpp - Loader core → Loader initialization: uses initialization
src/loader/loader_core.cpp - Loader core → Loader logging: logs events
src/loader/loader_core.cpp - Loader core → Runtime interface: uses runtime interface
src/loader/loader_core.cpp - Loader core → API trampolines: uses trampolines
src/loader/loader_core.cpp - API trampolines → Instance state: gets active instance
src/loader/xr_generated_loader.cpp - API trampolines → Dispatch tables: dispatches calls
src/loader/xr_generated_loader.cpp - Manifest discovery → Runtime interface: configures runtime
src/loader/manifest_file.cpp - API layer interface → Manifest discovery: reads manifests
src/loader/api_layer_interface.cpp - API layer interface → Loader initialization: uses initialization
src/loader/api_layer_interface.cpp - Manifest discovery → Platform utilities: uses platform utilities
src/loader/manifest_file.cpp - Manifest discovery → Platform library loading: uses platform loading
src/loader/manifest_file.cpp - Loader logging → Debug object info: records object info
src/loader/loader_logger.hpp - Debug object info → Handle utilities: uses handle utilities
src/common/object_info.h - Platform library loading → Platform utilities: uses platform utilities
src/loader/loader_platform.hpp - Loader negotiation → OpenXR headers: references API types
include/openxr/openxr_loader_negotiation.h