Add passive F2 diagnostics overlay with persistent session visibility

This commit is contained in:
UnixNight committed 2026-10-25 02:17:40 -04:00
1 parent 20aa1bc2b9
commit 113e9a41cc
17 files changed
+414 -24

No files matched your search

+8
View File
@@ -162,3 +162,11 @@ Effective control/tag queries expose Jimmy while forced; source shot assignments
still update the authored tag. DEFAULT uses authored ownership for its music
handoff. Disabling force reveals current script state; Begin clears the override.
The debug flag is never serialized into original saves.
DebugDiagnostics is session-owned timing/visibility state passed into each Run.
It reads DebugStatus/DebugMotion snapshots and formats bounded live text; its
wall-frame timer is independent of the simulation clock. F2 handles only its own
key and never enters the menu's pause/input-reset boundary. F1 selects the full
menu layout while open, otherwise the same overlay ranges display compact live
diagnostics. The source viewport/projection decision supplies actual camera/far
data. No debug visibility state is written into the original TSK wire format.
+9
View File
@@ -25,6 +25,7 @@ separate evidence categories. **The game is not fully reconstructed/playable yet
| Swapchain resize | Linux tested | 960x720 ->800x600, zero validation errors |
| F1 debug menu | Managed/SDL audio tests + native Linux GTX1070 window pass |Pause/actions/input capture/resume/800x600 resize, zero validation errors;33 prepared scene/start choices; intentional modern tools, no new Windows runtime claim |
| F1 Force Control | Menu/director/interaction checks + native Linux SDL pass |Persistent override through source shots; disable/reset restores normal ownership; actual movement with neutron1a active, zero Vulkan errors; music handoff regression passes |
| F2 live debug overlay | Managed timing/layout/menu + native Linux SDL pass |Non-pausing movement, visibility/repeat/menu priority and800x600 resize; all checks true, zero Vulkan errors; session persistence; modern tools, no new Windows runtime claim |
| Focus / fullscreen | Code present, partial/unverified | Focus clears keys; fullscreen toggle not dynamically tested |
| Mouse/relative input/controller | Incomplete | SDL entry point declaration alone is not behavior |
| Audio stream | Linux dummy device | Original11025Hz mono WAV consumed10752bytes/500ms; speakers untested |
@@ -85,6 +86,14 @@ window/input/action/resize evidence is artifacts/debug-window.log; screenshots
were visually inspected. Both Linux and Windows self-contained packages publish
successfully. No new Windows/Wine runtime check was run for this addition.
Live F2 diagnostics: artifacts/live-debug-full-tests.log passes the full suite
and539 original hashes. Native SDL live movement/menu/visibility/resize and the
existing force-control check pass with zero Vulkan errors. Headless lab/VR04/lab
retains visibility and samples1/2/3 with zero errors; camera/layout/timing groups
pass. See artifacts/live-debug-window.log and live-debug-return.log. No new
Windows runtime claim is made.
Both self-contained platform packages rebuild successfully with this addition.
Known visual/behavior limits include incomplete lighting/fog/blend/culling/material
mapping, inferred model/root pivot, provisional collision/cadence/animation timing,
close-wall camera clipping near Jimmy, incomplete class-specific triggers/interactions,
+41 -1
View File
@@ -1,4 +1,4 @@
# F1 debug menu
# Debug menu and live overlay
User-requested modern investigation tools, separate from recovered original UI.
F1 works in the game, during cutscenes and practice prompts, and in scene inspection.
@@ -8,6 +8,7 @@ audio. Closing resumes the previous mode. No new assets or dependencies are need
| Key | Action |
| --- | --- |
| F1 | Open/close |
| F2 | Toggle live diagnostics without pausing |
| Up/Down | Select a row |
| Left/Right | Change selected level, startpoint or staged SCENE task value |
| Page Up/Down | Change staged SCENE value by10 |
@@ -62,6 +63,45 @@ It also enables Force Control through the menu and verifies actual movement whil
Carl's MCA is still playing. Director checks cover disabling the override, shot
changes, scene reset and the normal completion music handoff.
## Live diagnostics (F2)
F2 toggles a compact panel in the upper-left corner while gameplay, cutscenes and
audio continue. The F1 menu also offers Live Overlay; opening F1 replaces the live
panel temporarily, preserving its setting. F2 works while F1 or practice is open
without changing their pause state. Visibility persists through resets and scene
loads within the process; it is not stored in TSK. `--debug-overlay` starts enabled.
Twelve bounded rows show measured FPS/frame milliseconds; level/start; root XYZ;
velocity XYZ; yaw/speed/turn rate; ground/pose/energy; control/force/pause; SCENE/
score/jetpack state and burst timer; actual camera mode/far plane; cutscene/shot/
blocked state; movement counters; and reported issue/Vulkan-error/frame counts.
STRT, orbit, gameplay and cutscene modes use the actual rendered view selection;
orbit reports its own radius-derived far plane. A paused player/control lock is
separate from pausing the whole simulation.
Timing measures rendered-loop wall intervals, including rendering/presentation,
independently of the simulation clock. It shows an initial running mean, then
publishes half-second window averages. Text uses the preceding timing sample;
the first frame has no measurement yet. This is frame timing, not GPU profiling.
Timing continues while hidden so enabling the panel has current samples.
Motion fields describe the player simulation; standalone mesh inspection has no
running player and displays zero/default motion values.
DebugDiagnostics is read-only and retains timing/visibility across scene rebuilds.
DebugMenuOverlay reuses the existing font and fixed vertex ranges with a smaller,
content-sized panel. Gameplay state, pause policy and original HUD stay separate.
There are no added assets or dependencies.
DebugDiagnosticsTests verifies timing, finite zero/invalid cases, live snapshots,
camera selection, culture-independent formatting and label bounds. The24-frame
`--smoke-debug-overlay` SDL check verifies F2/repeat handling, movement without
pause, hide/show, F1 priority, visibility preference, menu action and800x600 resize.
Native Linux evidence: artifacts/live-debug-window.log; zero Vulkan validation
errors. The existing F1/force-control SDL check also passes. Full regression and
cross-scene results are in progress.md; no new Windows runtime check is claimed.
The headless lab/VR04/lab check preserves enabled state and frame samples1/2/3,
with zero Vulkan errors (artifacts/live-debug-return.log).
Native Linux GTX1070 window test passes with zero Vulkan validation errors:
artifacts/debug-window.log. GPU screenshots debug-menu.png and debug-window.open.ppm
show the menu. Source/build/regression evidence does not constitute new native
+5
View File
@@ -87,3 +87,8 @@
Force Control is a persistent debug override over authored ownership, with
FALSE restoring the current scripted state. Reset/new scene clears it, and
source music handoff continues to use authored ownership.
20. **Keep live diagnostics passive and session-owned.** F2 and the F1 Live Overlay
action change visibility without pausing gameplay/audio. Preserve this setting
across scene rebuilds in memory, independently of TSK state. Reuse the existing
font/buffers, give F1 display priority and measure wall-frame intervals separately
from simulation ticks. Report the rendered camera/projection, not a guessed mode.
+25
View File
@@ -4,6 +4,31 @@
user-verified Windows rendering checkpoint into an interactive original lab and
jet pack tutorial flow. This is not a verified faithful complete scene or release.
## User-requested live debug overlay
F2 toggles a compact, non-pausing live diagnostics panel. F1 also offers Live
Overlay and takes display priority while open. The setting/timing object belongs
to the session, preserving visibility across scene rebuilds and resets without
writing original saves. --debug-overlay enables startup visibility.
The12 rows expose FPS/frame time, root/velocity, steering/pose/ground/energy,
control/force/pause, tasks/score/jetpack, actual camera/far plane, active cutscene
and counters/errors. Source camera and orbit projection values reflect rendering.
The existing font/overlay buffers are reused with a smaller content-sized panel.
Targeted model/renderer/diagnostics groups pass. Native Linux GTX1070 SDL checks
pass live movement77.58 travel with visibility/menu/resize checks all true and
zero Vulkan validation errors (artifacts/live-debug-window.log). The prior F1
force-control check still passes. Headless GPU output was visually inspected.
Complete scripts/test.sh passes, including41 Python checks, all managed/gameplay/
GPU/audio regressions and539 unchanged originals (artifacts/live-debug-full-tests.log).
The lab -> VR04 -> lab headless check retains enabled diagnostics with frame
samples1/2/3 and zero Vulkan errors (artifacts/live-debug-return.log); exact RETURN
root/companion placement still passes. Final authored-camera inspection also
renders with zero errors, and targeted camera-mode/layout/timing checks pass.
Both Linux and Windows self-contained packages are rebuilt successfully. No new
Windows/Wine runtime check was run.
## User-requested F1 debug menu
Follow-up: Force Control is now a persistent TRUE/FALSE menu toggle. It overrides
+2
View File
@@ -33,6 +33,8 @@ compile, runtime and original-fidelity verification are separate.
camera/cutscene/energy/jetpack/task/scene/start/reset controls and input capture.
- [x] Force Control TRUE/FALSE override in F1; persists through scripted shots,
restores authored ownership when disabled, clears on reset/new scene.
- [x] F2 live diagnostics plus F1 visibility toggle; non-pausing compact overlay,
measured frame timing and session-owned visibility across scene rebuilds.
## Immediate continuation