mirror of
https://github.com/mitch030504/Wiicompiled_VR_Frame.git
synced 2026-10-06 07:00:30 +02:00
iChris4
1cf9389d69
- Introduced a new configuration option for immersive window mode in runtime_config.h. - Updated the parsing and setting functions to handle the immersive window state. - Modified the OpenXR backend to support rendering with the immersive window, blending the race view with the surrounding environment. - Enhanced the settings overlay to allow users to select between immersive, immersive window, and flat screen race views. - Implemented GPU rendering logic for the immersive window mask, ensuring correct visual output in various rendering paths. - Added tests to validate the immersive window functionality and its interaction with existing race view settings.
88 lines
3.9 KiB
C++
88 lines
3.9 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, and around the immersive window, never during a fully
|
|
// 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;
|
|
|
|
// The immersive window: an immersive race keeps its stereo view but is seen
|
|
// only through the screen its 2D layer sits on, with the room (or, without
|
|
// passthrough, black) around it. Callable from any thread; applied to the next
|
|
// published frame. Flat Screen mode, which keeps races off the immersive path
|
|
// altogether, makes it moot.
|
|
void OpenXRSetImmersiveWindow(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
|