simplysanatori
71ee9db113
Most draws reuse the game's last c0 upload (0.1.3 stereo stats: about 9 draws per distinct c0 pair), so with stereo_shared_math and the eye cache the substitution now keeps what it derived from an upload and checks each part against what it was made from: - world-space: the recovered projection and its inverse (c0 bits + game projection generation), the sky origin (main camera bits), M*P^-1* paused_head (paused_head serial) and each eye's registers (full eye key); - interface: each eye's registers, keyed on source, rotation, scale, bias, clip depths, eye and frusta; vr_head_rotation and the HUD/menu relative rotations memoised on their inputs (no trig per HUD draw); - pure projection: the eye cache keeps register copies for an identity paused_head; - sky test: past both windows of a frame a repeat of the previous call (same origin and camera) reuses its answer, still counting the call and recording the hit. Menu/movie/loading state and the game camera are read once per call (guarded reads per world-space draw 11 -> 6). binocular_zoom and the sky counter still run per eye; all branch checks and logs run as before. mathtest: repeated uploads (with state changes between repeats) in the synthetic run, memo coverage checks, a 9-draws-per-upload bench; all copies bit-identical. Host instructions per stereo draw: 2189 -> 1289 (-41%) against the current release, 4203 -> 1289 against 1.1.0.
LegendFrame
Tomb Raider: Legend in VR on the Valve Steam Frame.
LegendFrame is a Steam Frame fork of Tomb-Raider-Legend-VR-Port by RototRobot: a virtual reality mod for Tomb Raider: Legend with stereoscopic rendering, 6DoF head tracking, motion controllers, a VR third-person camera and an optional first-person mode. All of the VR work is theirs. LegendFrame tracks their current release (TRLVR 1.1.0) and adapts it to run on the Frame, which is an Arm64 Linux headset, through Proton 11 ARM64 and SteamVR, with a single-pass stereo renderer to make it cheaper to emulate. The original README is kept in docs/UPSTREAM-README.md. Apache License 2.0, as upstream.
You need your own copy of Tomb Raider: Legend from Steam. No game data is in this repository.
Status
0.1.3, in testing on the Frame. No GitHub release yet. Version numbers: LegendFrame 0.1.x is upstream mod 1.1.0 plus the Frame work in this repository.
What is measured, on one Frame (72 Hz, 1440 px per eye, Proton 11 ARM64, OpenVR):
- Upstream's two-pass stereo: about 40 fps median in gameplay.
- LegendFrame 0.1.1 single-pass: about 51 fps median in gameplay (worst 27 to 39, best 72).
- Menu A/B with the CPU wait for the GPU before
Submitremoved (submit_wait=0): 43 to 45 fps became 67 to 70 fps.
What is not confirmed yet: the gameplay effect of submit_wait=0, whether it shows tearing or partial frames in the headset, and whether the god_carry_fix option cures the god-mode carry smearing. Those are being tested by the owner on 0.1.3 and are not claimed here. The game is a 32-bit x86 program, so the whole thing is emulated; the cost that limits it is the per-draw submission, not the GPU. Details and the numbers are in docs/FRAME-INSTALL.md.
Install on the Frame
You need a Steam Frame with Tomb Raider: Legend installed from Steam, Proton 11 ARM64, and a built payload (see Building).
git clone https://github.com/simplysanatori/LegendFrame.git
cd LegendFrame
git checkout steam-frame
frame/install.sh --payload /path/to/dist
The installer finds the game, backs up any mod files already there, copies the payload, seeds Frame defaults for trlvr.ini and the game's graphics registry values, sets SteamVR's per-app settings (72 Hz, resolution 1440) when SteamVR is running, and queues the Tomb Raider: Legend VR shortcut for Steam's next start. It does not restart Steam. Restart it yourself, then launch the shortcut, not the store entry. frame/uninstall.sh reverses it.
docs/FRAME-INSTALL.md has the whole story: requirements, what each step does, the manual steps if the installer cannot do one (Next Generation Content must be off in the game's Setup dialog), tuning keys, logs and uninstall.
What differs from upstream
- Single-pass stereo. One D3D9 draw for both eyes instead of two, done in the DXVK fork by the viewport-index technique (not Vulkan multiview): the draw is issued once with
instanceCountdoubled, a vertex-shader epilogue setsViewportIndex = InstanceIndex & 1, and the per-eyec0..c3matrices come from a left/right bank. The images and overlays stay the existing double-wide target. The two-pass path is kept as a fallback:[vr] stereo_mode=twopass|singlepass, and a live Shift+F6 or settings-panel toggle. Design in docs/DESIGN.md, plan in docs/PLAN.md. - Cheaper per-eye maths. The proxy computes both eyes' matrices in one call (
stereo_shared_math, bit-exact against the two-call version) and is built with SSE2 maths. - No GPU wait before Submit (option).
[vr] submit_wait=0drops the CPU wait for the GPU before the OpenVR submit. Under trial. - God-mode carry fix (option).
[vr] god_carry_fix=1addresses an upstream carry bug where parts of Lara's mesh stay at the pick-up spot; see docs/INVESTIGATION-godmode-stretch.md. Under trial. - Linux build. The 32-bit
d3d9.dllproxy, the DXVK fork and the launcher are cross-built with mingw in a container (toolchain/), on the Frame itself, instead of MSVC on Windows. The toolchain includes an SEH shim (mingw has no 32-bit SEH) and SSE2 flags. - Frame installer.
frame/install.shandframe/uninstall.shinstall into the Steam copy of the game on SteamOS, with backups, a manifest and a queued Steam shortcut. - Frame controller binding. A native Frame controller binding: the left menu button taps for the gear menu and pause, and holds for the settings panel.
- HUD nudge.
hud_offset_xandhud_offset_ymove the gameplay HUD (also sliders in the settings panel). - Frame tuning defaults. FSAA off, MSAA 2, no comfort vignette, a 110 degree culling cone, no shadows, reflections or water effects, 72 Hz at resolution 1440 in SteamVR, and the OpenVR runtime (OpenXR is not available under Proton 11 ARM64; see the guide).
Everything else is upstream's.
Building
The mod is cross-built for 32-bit Windows (the game is 32-bit) with mingw in a podman container. The recipe is in toolchain/; it produces d3d9.dll, d3d9_dxvk.dll and trlvr_launcher.exe, which together with openvr_api.dll, input/actions.json (as trlvr_actions.json) and the input/bindings_*.json files and the openxr_loader.dll the mingw d3d9.dll links against (install with --with-openxr), make the payload frame/install.sh expects. Upstream's own Windows build (build.bat, MSVC) is still in the tree.
Controls
The layout is upstream's: see VR CONTROLLER BINDINGS.txt (Oculus Touch is the layout that applies on the Frame). One thing is different on the Frame: the left menu button is the Frame controller's own menu button, and LegendFrame binds it directly: a tap opens the gear menu and pauses, and holding it for about half a second opens the settings panel. The left system button always opens the SteamVR dashboard. If a button does nothing, reset the binding in SteamVR > Settings > Controllers > Manage Controller Bindings.
Credits
- Built by simplysanatori.
- RototRobot, author of Tomb-Raider-Legend-VR-Port: the VR mod this is a fork of, including the stereo renderer, tracking, controls, god mode, physics and settings panel. Without their work there would be nothing to port; the original README is in docs/UPSTREAM-README.md. Upstream's thanks apply here too: DXVK (Philip Rebohle and contributors), chreden's TRAWindowed, Valve's OpenVR, Khronos OpenXR, Dear ImGui, and Crystal Dynamics for the game.
THIRD_PARTY_NOTICES.md lists the third-party parts and their licences.
Tomb Raider: Legend is the property of its owners. This is an unofficial fan project, not affiliated with or endorsed by Crystal Dynamics, Eidos, Valve or the upstream author.
License
Apache License 2.0, as upstream: see LICENSE and NOTICE. Third-party code keeps its own licences (DXVK is zlib/libpng and the shipped d3d9_dxvk.dll is a modified build).