Keep presentation alive across levels and scale UI for widescreen
This commit is contained in:
1 parent
113e9a41cc
commit
69d0187a21
26 files changed
+889
-70
No files matched your search
@@ -0,0 +1,80 @@
|
||||
# Persistent presentation and widescreen UI
|
||||
|
||||
User-requested modern presentation/layout, 2026-10-25. Original assets and hashes
|
||||
remain unchanged. These policies are separate from original fade/progression recovery.
|
||||
|
||||
## Presentation lifetime
|
||||
|
||||
Program.Main owns RenderSession until application exit. Each Run replaces level,
|
||||
controller and audio state; SDL window/title changes do not recreate the window.
|
||||
Position, logical/drawable dimensions, focus and fullscreen state survive loading.
|
||||
|
||||
VulkanRenderer.ReplaceScene validates bounds and stages vertex/index buffers,
|
||||
textures, sampler and descriptor pool/sets after DeviceWaitIdle. Instance, device,
|
||||
surface, swapchain, targets, pipelines and layouts stay alive. Resize/fullscreen
|
||||
changes still replace size-dependent swapchain/targets. SceneRevision increments
|
||||
on success and RendererIdentity exposes core handles for verification.
|
||||
|
||||
Old scene resources remain available until staging succeeds. Failure cleans partial
|
||||
new resources and restores the prior set. Invalid indices/RGBA are runtime-tested
|
||||
to preserve revision, identities and rendering; allocation-failure rollback is
|
||||
implemented without fault injection. Loading remains synchronous; source fades
|
||||
and loading presentation remain unfinished.
|
||||
|
||||
## Uniform layout and pointer mapping
|
||||
|
||||
UiViewport uses scale=min(drawableWidth/640,drawableHeight/480). Logical dimensions
|
||||
are drawable dimensions divided by that common scale. Art/glyph X/Y proportions
|
||||
match while the3D scene fills the viewport.
|
||||
|
||||
| UI | Anchor |
|
||||
| --- | --- |
|
||||
| Objective pad/text/digit | Bottom-right delta from authored640x480 |
|
||||
| Practice prompt/F1 menu | Centered authored canvas |
|
||||
| F2 live panel | Top-left safe inset |
|
||||
|
||||
Original4:3 positions, objective edge clipping and strict practice hit regions
|
||||
remain. Widescreen anchors are an explicit port policy. --width/--height choose
|
||||
initial window/offscreen dimensions64..8192; subsequent loads retain actual size.
|
||||
|
||||
Mouse coordinates map from SDL logical dimensions into actual drawable pixels
|
||||
before inverse modal mapping. Double precision avoids ultrawide cancellation that
|
||||
turned boundary225 into225.00003. Fractional DPI with independently rounded pixel
|
||||
dimensions uses the same mapping.
|
||||
|
||||
## Verification
|
||||
|
||||
UiViewport/Hud/DebugOverlay tests cover nine aspect/resolution fixtures,4:3
|
||||
equivalence,16:9/21:9/32:9, square/portrait,1.5x/2x DPI and fractional rounded
|
||||
drawable dimensions. They verify glyph/art proportions, anchors, centered layouts
|
||||
and strict Yes/No boundaries. The full suite passes in
|
||||
artifacts/persistent-widescreen-full-tests.log, including539 unchanged originals.
|
||||
|
||||
Actual headless lab/VR04/lab Run transitions retain one renderer with revisions
|
||||
1/2/3 at1280x720, exact RETURN root/companion and zero Vulkan errors
|
||||
(artifacts/persistent-practice-return.log).
|
||||
|
||||
Native GTX1070: six loads, one window/renderer at960x720,1280x720,1680x720,
|
||||
2560x720 and fullscreen3440x1440. Checks assert unchanged window ID/bounds/focus,
|
||||
renderer identities across loading, fullscreen retention/restored windowed bounds,
|
||||
native practice pointer mapping, rejected-load retention and zero cumulative
|
||||
validation errors. Captures were visually inspected. Evidence:
|
||||
artifacts/window-transition-final.log and window-transitions/*.png. Existing F1/
|
||||
force-control and F2 input checks also pass from widescreen startup sizes.
|
||||
|
||||
```
|
||||
source scripts/env.sh
|
||||
dotnet build
|
||||
scripts/test-window-transitions.sh
|
||||
```
|
||||
|
||||
The runner uses installed Xvfb/Xfwm with private X11/D-Bus and artifact-backed
|
||||
configuration. Bare Xvfb lacks a window manager to honor fullscreen requests.
|
||||
NEUTRON_WINDOW_TEST=1 scripts/test.sh can use an existing managed display. These
|
||||
are test dependencies; the game adds none. Linux runtime/cross-publishing does
|
||||
not establish new native Windows or original visual/gameplay equivalence.
|
||||
|
||||
Both platform self-contained builds pass. The packaged Linux executable also
|
||||
passes1920x1080 lab/VR04/lab with one renderer and exact RETURN root/companion
|
||||
(artifacts/package-persistent-return.log; validation layers unavailable for this
|
||||
standalone invocation). Native source/fullscreen checks above enable validation.
|
||||
Reference in new issue
Block a user