mirror of
https://github.com/mitch030504/Wiicompiled_VR_Frame.git
synced 2026-10-06 06:00:25 +02:00
80 lines
3.5 KiB
C++
80 lines
3.5 KiB
C++
// 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;
|
|
|
|
// Writes the controllers the pacing thread last published to the virtual
|
|
// gamepad. Call it from the thread that polls controllers, wherever the game
|
|
// is about to read them: the pacing thread deliberately leaves SDL alone, since
|
|
// SDL's joystick lock is held for the length of a device enumeration and an
|
|
// OpenXR frame may not wait that long. Cheap and safe to call when VR is off.
|
|
void OpenXRApplyControllerState() noexcept;
|
|
std::string OpenXRLastError();
|
|
|
|
// Recenters on where the player is sitting now: it moves the immersive race
|
|
// view's origin, and re-places the anchored menu screen upright in front of
|
|
// them. Position only for the race view: the forward direction and the horizon
|
|
// come from the OpenXR reference space and are never relatched from the
|
|
// headset, so recentering cannot tilt the game's horizon. Use the runtime's own
|
|
// recenter gesture to change forward. Callable from any thread; serviced once
|
|
// per frame on the XR pacing thread.
|
|
void OpenXRRequestRecenter() noexcept;
|
|
|
|
// Sets a fixed pitch of the game camera for a player sitting reclined, in
|
|
// degrees, clamped to RuntimeConfigFile::kVrLeanBackDegreesLimit. Positive
|
|
// tilts the camera back with the player, so an angle matching how far they are
|
|
// reclined puts the track back in front of them. 0 applies no pitch at all.
|
|
// Applies to the immersive race view only; callable from any thread and read
|
|
// once per published frame.
|
|
void OpenXRSetLeanBackDegrees(float degrees) noexcept;
|
|
|
|
// Shows the room through the headset's cameras around the menu screen and every
|
|
// other virtual screen, never during an immersive race. Only the standalone
|
|
// (Quest) backend offers it; elsewhere this changes nothing. Callable from any
|
|
// thread; applied on the XR pacing thread's next frame.
|
|
void OpenXRSetPassthrough(bool enabled) noexcept;
|
|
|
|
// Live scene interpolation at the headset's own display deadlines.
|
|
// 0 = Off, 1 = Auto, otherwise 72/90/120 as a rendering-rate ceiling.
|
|
void OpenXRSetFrameInterpolationFps(uint32_t target) noexcept;
|
|
bool OpenXRFrameInterpolationAvailable() noexcept;
|
|
struct OpenXRFrameTiming {
|
|
float headset_hz = 0;
|
|
float rendered_fps = 0; // Newly rendered pairs; excludes retained-layer repeats.
|
|
};
|
|
OpenXRFrameTiming OpenXRGetFrameTiming() noexcept;
|
|
|
|
} // namespace mkw::vr
|