mirror of
https://github.com/bearstonem/openmohaa-vr.git
synced 2026-10-18 10:00:21 +02:00
bearstonemandClaude Opus 5
5aff8d336a
Runs on a Meta Quest 3 in stereo at the headset's native 1680x1760 per eye, with the world tracking head movement in six degrees of freedom. The session binds to the EGL context SDL already created rather than a private one, so there is a single GL context and the renderer needs no thread or context juggling. Each eye is rendered into an OpenXR swapchain image by substituting the framebuffer the renderer treats as the screen, which leaves the whole render path untouched. Exactly two eye passes per frame; there is deliberately no third pass to produce a flat image. The session and its swapchains belong to the GL context they were made with, so they are torn down and rebuilt around the renderer restarts the engine performs. Menus, the loading screen and cinematics go on a quad layer fixed in the room, placed once in front of wherever the player is facing. Drawing screen space content into both eyes instead gives it no stereo disparity while each eye still warps it through its own asymmetric frustum, and the result cannot be fused. The panel is drawn into one persistent buffer that is then copied into the swapchain image: a swapchain rotates through several images, and the engine's 2D path expects the screen to still hold what it drew last frame. Head tracking: - The per-eye asymmetric frustum from xrLocateViews feeds R_SetupProjection directly. A symmetric approximation misaligns the two images by a few degrees, which the eyes cannot fuse. - The pose is applied in RE_RenderScene, so it follows every camera the game has - the player's, cutscenes, ladders, death animations - without each needing to know about VR. - Orientation is carried as axes rather than pitch/yaw/roll, and composed with the game's heading as a rotation. Adding Euler angles only works while pitch and roll are near zero and turns every head movement into a twist once they are not. - Position is measured from where the head was when tracking started, so the game keeps supplying eye height and the headset contributes only leaning, ducking and stepping. The initial heading is subtracted too, or the play space's arbitrary forward is added to the character's and the player spawns facing the wrong way. The controllers point at the panel and click: the aim ray is intersected with the quad and the hit becomes the engine's cursor position, so the menus behave as they always did. The renderer's own framebuffer objects stay off on Android. Each eye is already a swapchain image, so routing through tr.renderFbo first would cost a second full resolution pass and resolve per eye for nothing. Known gaps: head orientation does not yet reach the player's view angles, so the game does not know where the player is looking; and there is no controller model or pointer ray. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
45 lines
1.9 KiB
C
45 lines
1.9 KiB
C
/*
|
|
===========================================================================
|
|
Copyright (C) 2026 the OpenMoHAA team
|
|
|
|
This file is part of OpenMoHAA source code.
|
|
|
|
OpenMoHAA source code is free software; you can redistribute it
|
|
and/or modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of the License,
|
|
or (at your option) any later version.
|
|
|
|
OpenMoHAA source code is distributed in the hope that it will be
|
|
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with OpenMoHAA source code; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
===========================================================================
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
// The tag every log entry is filed under; `adb logcat -s openmohaa` shows
|
|
// only ours.
|
|
#define SYS_ANDROID_LOG_TAG "openmohaa"
|
|
|
|
// Writes a single line to logcat. Safe to call before the engine has started
|
|
// and from a signal handler.
|
|
void Sys_AndroidLog(const char *message);
|
|
|
|
// Installs handlers for the fatal signals that report the faulting address and
|
|
// program counter. The generic Unix handler cannot: it is installed with
|
|
// signal(), so it never sees siginfo, and _Unwind_Backtrace cannot walk out of
|
|
// the kernel's signal trampoline - which leaves a crash reported as four frames
|
|
// of the handler itself and nothing about where the fault actually happened.
|
|
void Sys_AndroidInstallCrashHandler(void);
|
|
|
|
// Points the install path at the app's external files directory and makes it
|
|
// the working directory. Must run before Com_Init, which is where FS_Startup
|
|
// reads the install path. A no-op in the dedicated server, which has no
|
|
// activity to ask.
|
|
void Sys_AndroidSetupPaths(void);
|