The first hardware integration for DisplayXR — and the reference example of a vendor plug-in.
This plug-in turns Leia SR glasses-free 3D displays (e.g. Samsung Odyssey 3D, Acer SpatialLabs) into OpenXR targets for the DisplayXR runtime. Building a plug-in for your own display? Start from this worked example, alongside the vendor onboarding guide.
Get it: download DisplayXRLeiaSRSetup-<version>.exe from the Releases page. The DisplayXR runtime must be installed first (the installer reads HKLM\Software\DisplayXR\Runtime\InstallPath).
Ships DisplayXR-LeiaSR.dll, a vendor plug-in DLL implementing xrt_plugin_iface from the runtime's public ABI (xrt/xrt_plugin.h). It loads at xrCreateInstance time via registry-driven discovery (HKLM\Software\DisplayXR\DisplayProcessors\leia-sr).
src/drv_leia/— Windows driver source: device, EDID probe, plug-in entry point (xrtPluginNegotiate), per-API display processors (D3D11, D3D12, OpenGL, Vulkan), SR SDK weavers, eye-tracking listener, WGC background capture.src/drv_leia_android/— Android arm (CNSDK):libdxrp050_leia_cnsdk.sofor the runtime APK.src/drv_leia_linux/— Linux desktop arm:DisplayXR-LeiaSR.so, with two weaver backends behind one seam. Track B (-DDXR_LEIA_LINUX_WEAVER=sdk) is the real srSDK Vulkan weaver — it builds clean on Ubuntu 26.04 against the installedleiasr-runtime.deb and passesdisplayxr-cli selftestwithleia-sractive (on-panel weave validation on 26.04 still pending; weave itself was validated on 22.04/NVIDIA, #81). Track A is the default stub weaver (passthrough, no SR SDK) for CI and SDK-less boxes. The SDK-facing interface is fixed by the LeiaSR Linux SDK contract (PROPOSED). Build/validate withscripts/build-linux.shand the Track B runbook; CI covers Ubuntu 22.04/24.04/26.04.installer/DisplayXRLeiaSRInstaller.nsi— NSIS installer that drops the DLL at$RuntimeInstall\Plugins\LeiaSR\and registers the plug-in underHKLM\Software\DisplayXR\DisplayProcessors\leia-sr.
Implementation internals live in docs/ (migrated from the runtime's docs/vendors/leia/):
- Integration overview — source layout, build flags, eye-tracking mode
- Weaver internals — DX11 / DX12 / GL / Vulkan weaver creation, weave() flow, DPI, phase math
- Transparency model — WGC compose-under-bg (primary) on D3D11 / D3D12 / Vulkan
- Chroma-key overlay — legacy fallback; still the only path on the GL DP
- Window phase snapping — SR weaver WndProc subclassing for lenticular phase alignment
- Display mode switching — 2D/3D via
SwitchableLensHint/ backlight - CNSDK Android calibration — face axes / tile-to-eye / UV-flip validation procedure for Lume Pad
- LeiaSR Linux SDK contract — what the Linux SDK must expose (PROPOSED, #81);
src/drv_leia_linux/leia_sr_linux.hmirrors it
The vendor-neutral contract (what any plug-in must implement) stays in the runtime repo: docs/specs/vendor/, docs/specs/runtime/plugin-discovery.md, docs/guides/vendor-plugin-onboarding.md.
- ADR-019 — vendor plug-in / aux boundary:
displayxr-runtime/docs/adr/ADR-019-vendor-plugin-aux-boundary.md - Plug-in discovery spec:
displayxr-runtime/docs/specs/runtime/plugin-discovery.md - Vendor onboarding guide (post-#263):
displayxr-runtime/docs/guides/vendor-plugin-onboarding.md