Reconstruct lab story, interactions, patrol and jet pack practice flow
This commit is contained in:
1 parent
58424120bb
commit
c929f942e1
84 files changed
+7957
-305
No files matched your search
@@ -0,0 +1,133 @@
|
||||
# Original laboratory objectives and practice modal
|
||||
|
||||
Evidence: read-only Neutron.exe disassembly (`artifacts/binary/neutron.asm`),
|
||||
original `omt/screens.omt`, and `alpha.omt`. EXE VAs below equal file offsets
|
||||
plus `0x400000` for these sections. Static evidence and decoded original art
|
||||
are verified; original modal/HUD runtime comparison remains outstanding.
|
||||
|
||||
## Recovered screen resources and coordinates
|
||||
|
||||
`402687..4026E8` registers slot0=`screens:Canv156` objectivePad,
|
||||
slot1=120 labobjective0A, slot2=121 labobjective0B, slot3=122 labobjective0C.
|
||||
Their original pixels say **GET JET PACK.**, **TALK TO CARL.**, and
|
||||
**FOLLOW CARL OUTSIDE.** respectively. GAM pickup tag `shrinkray` is the
|
||||
prototype/internal name of the lab jetpack (inventory group0/item3); the art
|
||||
does not describe it as a shrink-ray weapon.
|
||||
|
||||
| Element | Original identity | Native dimensions | Reference top-left |
|
||||
| --- | --- | --- | --- |
|
||||
| Objective pad | screens Canv156 | 320x173 | (384,380+offset) |
|
||||
| Current objective | screens Canv120/121/122 | 256x29 | (384,448+offset) |
|
||||
| Objective selector digit | alpha Canv83/84/85 | 8x8 | (393,450+offset) |
|
||||
| PracticeYesNo | screens Canv169 | 207x100 | (210,210) |
|
||||
|
||||
`402C40` positions visible flagged objectives at x384,
|
||||
y=`448 + self[4EC] + visibleRow*15`. `407070` renders the pad at x384,
|
||||
y=`380+self[4EC]` during its stationary phase and prints selector `%d`
|
||||
(`4EC794`) at (393,450+offset), font tag SMAL (`534D414C`). `401F9D`
|
||||
initializes offset=-69; `406590` changes -69 to0, while `406650` changes0 to-69.
|
||||
These source paths toggle vertical layout and other gadget UI, not a simple
|
||||
objective visibility bit. The pad extends beyond the640x480 reference viewport;
|
||||
retain clipping rather than repositioning it to fit.
|
||||
|
||||
`406F50(index,flag)` only accepts index>0: it clears44 dword flags at4F7D00,
|
||||
sets selector4F8194, resets animation timer4F8188, then enables the selected
|
||||
entry. It does not map selector0 to objective1. The source has sliding/timed
|
||||
objective presentation; the consumer currently renders its stationary geometry
|
||||
under caller-controlled visibility. Animation and exact source visibility timing
|
||||
are not yet implemented.
|
||||
|
||||
`402D70/402CC0` convert positions using windowWidth/640 and windowHeight/480;
|
||||
constants at file8D40C=1/640 and8D408=1/480. The port quads use NDC
|
||||
`(2*x/640-1,2*y/480-1,0)` with an identity overlay transform. Original bitmap
|
||||
UV orientation is top-down, retained as(0,0) at top-left.
|
||||
|
||||
Gameplay text uses individual `alpha.omt` canvases, not editor
|
||||
`fontsmall.png`: `4683E0` loads `alpha.omt` (string4F51D8), copies6x64
|
||||
Canv pointer sets from table4F4ED8, and `468B80` maps uppercase ASCII-32.
|
||||
SMAL selects set1; table entries for '1'/'2'/'3' are83/84/85. The separate
|
||||
fontsmall CanvasFont is created in editor initialization46B280..46B3C7 and
|
||||
must not silently substitute for gameplay digits.
|
||||
|
||||
## Practice request, input and dispatch
|
||||
|
||||
`402243..402273` binds Canv169 at(210,210). `406F90(type)` guards against
|
||||
an existing modal (4F8198), shows the matching canvas, enables cursor,
|
||||
pauses the main game through virtual168, then stores type at4F8048. Type0
|
||||
uses169, whose pixels explicitly ask **DO YOU WANT TO PRACTICE? YES / NO**.
|
||||
|
||||
`46A360/46A380` set/clear keyboard bytes at509838+virtualKey;
|
||||
46A3A0/46A3B0 track left mouse at509834. Consequently modal code reads
|
||||
Y=509891, N=509886, Enter=509845. Source404523..404586 defines strict
|
||||
Yes hit bounds225<x<305,240<y<300; No404BD0..404C40 is315<x<395 with
|
||||
the same y bounds. Y accepts regardless of pointer; N dismisses. Enter
|
||||
accepts Yes while hovering its region and otherwise follows No. Mouse
|
||||
click accepts the corresponding hovered region; no blanket click dismissal.
|
||||
Controller state paths also exist but remain unmapped. Escape handling is
|
||||
not established by this modal branch.
|
||||
|
||||
Type0 Yes dispatch is `40469E` jump table4=404DA8 ->4046AF. It hides the
|
||||
modal/highlight, clears4F8198, disables cursor, invokes4063E0 for screen155,
|
||||
and calls Jimmy virtual168 (`43B5A0`) with:
|
||||
|
||||
```
|
||||
targetLevel = "VR04.gam" (4EC77C)
|
||||
targetStart = "PHONEBOOTH" (4EC788)
|
||||
returnLevel = Jimmy+955
|
||||
returnStart = Jimmy+724
|
||||
```
|
||||
|
||||
The latter field names follow how43B5A0 stages requested/current strings;
|
||||
the argument addresses and literal targets are certain. Modal1/2/3 dispatch
|
||||
VR03/VR02/VR01 respectively, so type0 must not be routed toVR01.
|
||||
Runtime checkpoint42AF00 captures the current level code and a16-byte
|
||||
actor root into Jimmy+1E48/+1E38 separately. This does not prove the
|
||||
meaning of the saved TSK StoredVector or justify overwriting it.
|
||||
|
||||
No path404D1E hides practice elements, clears4F8198, disables cursor and
|
||||
unpauses main game virtual168(0); yes continues into the level transition.
|
||||
|
||||
## Implementation and verification
|
||||
|
||||
- `tools/extractors/ui.py` exports only the8 proven canvases, retaining original
|
||||
identity, database, offset, source size, whole-input hashes and decoded RGBA
|
||||
hashes. It validates every requested identity/dimension before writing and
|
||||
rejects destinations overlapping source directories.
|
||||
- `Application/SceneHud.cs` bounds manifest/depth/count, exact canvas dimensions,
|
||||
paths and decoded byte counts; appends screen-space indexed quads to the scene,
|
||||
preserves world draws/textures, and updates the final merged vertex buffer.
|
||||
Selector0 produces no invented objective image. Input/modal state belongs to
|
||||
the caller.
|
||||
- `python3 tests/GamePort.HudTests/test_ui.py` verifies exact original RGBA,
|
||||
output roundtrip, missing-resource rejection and input hash preservation.
|
||||
- `dotnet run --project tests/GamePort.HudTests -- artifacts/prepared/ui/ui.json`
|
||||
verifies final-buffer writes, original coordinates, digit/objective/modal
|
||||
visibility, retained implicit world draw, and malformed-resource rejection.
|
||||
|
||||
Both targeted commands passed24Oct2026. Integrated headless overlays/VR04 entry
|
||||
and GTX1070/Xvfb modal pause/N/resume/resize pass with zero validation errors.
|
||||
The packaged Windows Wine64 modal check also passes with validation disabled;
|
||||
native Windows/original-game comparison remain outstanding.
|
||||
|
||||
## Return-context field confirmation
|
||||
|
||||
Follow-up field tracing confirms the meaning of the two staged return arguments:
|
||||
|
||||
- Literal4EF524 is `level1b.gam`. Jimmy constructor437656..437684 copies it
|
||||
to complete-object+955, initializing the current/requested GAM filename.
|
||||
- Constructor437589..4375B5 initializes+724 from4ECA6C=`none`, not PHONEBOOTH.
|
||||
- PlayerLoadLevel43B5A0 copies its second argument (requested start tag) to+724
|
||||
at43B6A7..43B6E0, first argument (requested GAM) to+955 at43B764..43B78C,
|
||||
third argument (return GAM) to+88C, and fourth argument (return start) to+8F0.
|
||||
- TSK load460A83..460AE5 reads the saved StartPoint string and copies it to
|
||||
+724 and+774. The supplied NewGame StartPoint is STARTEXP, so a lab practice
|
||||
transition after loading NewGame should carry ReturnStart=STARTEXP, rather
|
||||
than copying NewGame's preexisting ReturnStart=`none`.
|
||||
-40B70A..40B770 looks up+724 with actor lookup474070 and assigns that actor's
|
||||
root transform to Jimmy, independently confirming that this buffer is a
|
||||
start entity tag. Runtime checkpoint42AF00 does not alter it.
|
||||
|
||||
Therefore source modal0 Yes preserves current `level1b.gam`/`STARTEXP` as the
|
||||
return pair for the normal NewGame route, while entering VR04/PHONEBOOTH.
|
||||
Its separately captured checkpoint root and unknown TSK StoredVector remain
|
||||
distinct evidence; a new PHONEBOOTH return marker must not be invented.
|
||||
Reference in new issue
Block a user