Improve OpenXR loader error messages

When the OpenXR loader library fails to load, provide a detailed error
message explaining:
- On Windows: need openxr_loader.dll in app directory or PATH
- On Linux: install libopenxr-loader package or set LD_LIBRARY_PATH
- Can use SDL_HINT_OPENXR_LIBRARY hint to specify path

Also update D3D12 backend to include the error in its warning log,
and remove redundant SDL_SetError in Vulkan backend that was
overwriting the detailed message.
This commit is contained in:
Aaron Benjamin
2026-02-01 14:57:32 -05:00
committed by Ethan Lee
parent 5640647e14
commit 1f7db1ebcf
3 changed files with 6 additions and 3 deletions

View File

@@ -259,7 +259,10 @@ SDL_DECLSPEC bool SDLCALL SDL_OpenXR_LoadLibrary(void)
}
if (!openxr_loader.lib) {
SDL_SetError("Failed loading OpenXR library");
SDL_SetError("Failed to load OpenXR loader library. "
"On Windows, ensure openxr_loader.dll is in your application directory or PATH. "
"On Linux, install the OpenXR loader package (libopenxr-loader) or set LD_LIBRARY_PATH. "
"You can also use the SDL_HINT_OPENXR_LIBRARY hint to specify the loader path.");
openxr_load_refcount--;
return false;
}