feat(vk): add centered 3D rotating Triforce loading screen with retro LOADING... overlay #471

Closed

oscarlosu-lab wants to merge 13 commits from feat/loading-screen-triforce into main

oscarlosu-lab commented

2026-11-08 04:33:39 +00:00

(Migrated from github.com)

Summary

This PR adds an optional, centered 3D rotating golden Triforce animation with a retro "LOADING..." indicator during zone and scene transitions, paying homage to classic 90s console loading screens while replacing the empty black screen and the tiny static corner icon.

Preview

Key Features & Design

Accurate GPU Synchronization (Zero False Positives):
- Synchronized directly with the Vulkan command stream (d3d depth draws, compute dispatches, and pass geometry).
- Only triggers during actual black loading transitions (d3d == 0, f_disp == 0, f_draws <= 25, where the engine unloads the 3D scene).
- Automatically hides on the exact frame the 3D world resumes rendering (d3d >= 15), completely preventing false triggers during background streaming in towns or open areas.
Display Thread & Frame Pacer Decoupling:
- Integrated into display_main() (vk_framegen.cpp) with a 16 ms timeout fallback so the 3D Triforce continues spinning smoothly at 60 FPS even when the CPU game thread stalls performing heavy I/O file loads.
Clean Visuals:
- Clears the swapchain image to black during active loading passes to cleanly replace the small static bottom-right indicator with the centered 3D rotating model.
Configurable in F1 / Insert Menu:
- Added toggle Loading animation: On/Off under the in-game options menu (Options::loading_screen).
Zero Performance Overhead:
- Measured overhead during normal 3D gameplay: 0.00 ms (a single atomic read per frame).
- Active animation cost: ~0.19 ms per frame during loading.

Tested Scenarios

Entering/exiting buildings in Kakariko Village.
Area warping and dungeon transitions.
Verified on Windows x64 Vulkan backend with frame interpolation enabled and disabled.

### Summary This PR adds an optional, centered 3D rotating golden Triforce animation with a retro `"LOADING..."` indicator during zone and scene transitions, paying homage to classic 90s console loading screens while replacing the empty black screen and the tiny static corner icon. ### Preview ![Zelda Loading Animation](https://raw.githubusercontent.com/oscarlosu-lab/Hookshot/media-assets/loading_screen_transition.gif) ### Key Features & Design 1. **Accurate GPU Synchronization (Zero False Positives):** - Synchronized directly with the Vulkan command stream (`d3d` depth draws, compute dispatches, and pass geometry). - Only triggers during actual black loading transitions (`d3d == 0`, `f_disp == 0`, `f_draws <= 25`, where the engine unloads the 3D scene). - Automatically hides on the exact frame the 3D world resumes rendering (`d3d >= 15`), completely preventing false triggers during background streaming in towns or open areas. 2. **Display Thread & Frame Pacer Decoupling:** - Integrated into `display_main()` (`vk_framegen.cpp`) with a 16 ms timeout fallback so the 3D Triforce continues spinning smoothly at 60 FPS even when the CPU game thread stalls performing heavy I/O file loads. 3. **Clean Visuals:** - Clears the swapchain image to black during active loading passes to cleanly replace the small static bottom-right indicator with the centered 3D rotating model. 4. **Configurable in F1 / Insert Menu:** - Added toggle `Loading animation: On/Off` under the in-game options menu (`Options::loading_screen`). 5. **Zero Performance Overhead:** - Measured overhead during normal 3D gameplay: **0.00 ms** (a single atomic read per frame). - Active animation cost: **~0.19 ms** per frame during loading. ### Tested Scenarios - Entering/exiting buildings in Kakariko Village. - Area warping and dungeon transitions. - Verified on Windows x64 Vulkan backend with frame interpolation enabled and disabled.

NotRexed commented

2026-11-09 05:29:32 +00:00

(Migrated from github.com)