runtime: integrate OpenXR presentation for Mario Kart Wii

runtime/include/vr/openxr_integration.h

@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+#pragma once
+
+#include <aurora/aurora.h>
+
+#include <string>
+
+namespace mkw::vr {
+
+enum class OpenXRStartupResult {
+    Disabled,
+    Prepared,
+    Unavailable,
+};
+
+// Performs the OpenXR instance/system and graphics-requirements work that must
+// happen before Aurora selects an adapter. On success this may force the
+// backend and populate AuroraConfig's XR interop fields.
+OpenXRStartupResult OpenXRPrepareAurora(AuroraConfig& config);
+
+// Completes the graphics binding and starts the asynchronous XR pacing thread.
+// Call after aurora_initialize(), while Aurora's frame worker is idle.
+bool OpenXRStartAfterAurora(AuroraBackend active_backend);
+
+// Stops publishing stereo work, drains the pacing thread, and destroys the XR
+// session before aurora_shutdown(). Safe to call after partial initialization.
+void OpenXRShutdownBeforeAurora() noexcept;
+
+// Services an XR-owned teardown request at the producer's safe frame boundary:
+// after aurora_begin_frame() has granted the worker's prepare phase and before
+// aurora_end_frame_tagged() seals the current frame. No-op unless the pacing
+// thread has fallen back to desktop rendering.
+void OpenXRServiceProducerFrameBoundary() noexcept;
+
+bool OpenXRIsRunning() noexcept;
+std::string OpenXRLastError();
+
+} // namespace mkw::vr