Add passive F2 diagnostics overlay with persistent session visibility
This commit is contained in:
1 parent
20aa1bc2b9
commit
113e9a41cc
17 files changed
+414
-24
No files matched your search
@@ -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.
|
||||
@@ -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
@@ -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
|
||||
|
||||
@@ -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.
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
Reference in new issue
Block a user