Implement timed Invisible gadget and shared energy warnings

This commit is contained in:
UnixNight committed 2026-11-02 09:21:56 -05:00
1 parent 3527d33810
commit 1897dd2b90
44 files changed
+2466 -39

No files matched your search

+175
View File
@@ -0,0 +1,175 @@
# Bubble / Invisible resource and tutorial follow-up
2026-11-01. Original asset parsing, decoded-pixel inspection and local REA static
analysis. Originals remain untouched. This report does not establish original
gameplay execution, enemy detection, tutorial completion or native Windows runtime.
Primary selected Invisible as the next bounded gameplay implementation; Bubble
resource observations are retained for the later effect.
## Evidence and reusable output
`tools/extractors/gadget_followup_assets.py` inventories exact original resources,
seven current Jimmy clips and both authored tutorials. It retains archive/payload
hashes, resource byte offsets, GAM property offsets/raw bytes and duplicate tags.
It also guards the source image identities and eight bounded meter code spans.
No game code is executed by this utility. Generated report and inspected images:
`artifacts/gadget-followup-assets/resources.json`, `orangebubble.png`,
`controls_109.png`, `controls_111.png`, `canvas_21.png`, `canvas_22.png`.
```bash
python3 tools/extractors/gadget_followup_assets.py ../Original \
--output artifacts/gadget-followup-assets/resources.json \
--meter-output artifacts/extracted/invisible-meter
python3 -m unittest discover -s tests -p test_gadget_followup_assets.py -v
```
`export_meter(original, output)` writes `meter.json` schema1, reference640×480,
exactly two texture records and original decoded RGBA/PNG files. Records contain
id/name/width/height/path/png/sourceOffset/sourceBytes/sourceSha256/rgbaSha256.
Both names/dimensions are checked before any files are written. Original root,
its subtrees and ancestor outputs are rejected. Pixel files are neither recolored
nor resized; state/tint/geometry belong to the caller. Six checks pass in
`artifacts/gadget-followup-assets/tests.log`: exact assets, tutorial source offsets,
duplicate identity, output protection, pixel export and guarded meter spans.
## Invisible uses the existing Jimmy family — asset facts
`png/jimycarl.png` is256×256; all65,536 texels have alpha255. The existing
prepared Jimmy atlas therefore has no translucent source pixels to replace for
this effect. Source `jimstop.ASE` has426 vertices/814 faces, two samples at10fps,
480 ticks/frame, and supplies3,551 UV entries/814 UV faces. `jimrun`,
`jimbackpedal`, `jimjump`, `jimfall`, `jimfly` and `jimshoot` have the same
vertex/face counts and no UV tables; existing preparation uses the standing UV
topology. This report verifies counts and resource identity, not every morph's
original interpolation phase.
No additional ASE or PNG is required for the recovered Invisible material path.
[Invisible source](invisible.md) owns the activation/timer/state interpretation;
[material report](gadget-blending.md) already traces complete slot114→40E4A0
positive RGBA/material alpha and source blend enums. Existing port fragment
cutout occurs before multiplying material opacity, so alpha0.7 does not discard
this fully opaque source atlas. Original fixed-function alpha-test interaction
and full material-state parity remain separate renderer questions.
The original control strip Canv111 `BmenuLInvisible` visibly labels primary mouse
and Ctrl as INVISIBLE. Bubble strip109 separately labels mouse movement/forward,
jump and Ctrl/Insert keyboard equivalents. These inspected pixels corroborate
the input descriptions; they do not establish a held/edge policy, timers or
power consumption. Menu/HUD resources already exported for both items are in
[gadget assets](gadget-assets.md); no invented icons are needed.
## Recharge-meter resources and source chain
Original `screens.omt` SHA256:
`e8e95231f5d302b41f4fbf33df1c5a08ce4645370f9f519527ff1727b73b7a5e`.
| Canvas | Source offset / bytes | Exact decoded dimensions |
| --- | --- | --- |
|21 `meter` |0x88E18 /8118 |30×110, border/backplate |
|22 `metercolor` |0x8C5D8 /9138 |30×110, original multicolor fill |
REA inspected private hashed copies. EXE identity is
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`;
DLL identity is `3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
Complete replies, exports and closed snapshots are in
`artifacts/gadget-followup-assets/rea-meter/` and `rea-meter-dll/`.
The renderer/alignment follow-up is exported/closed in `rea-meter-surface/`.
| Source function | REA Evidence |
| --- | --- |
|401430 menu construction |`ev_e7355ffccf1c4066e58d93e229e4a89662e01045e555d178cb2c11b1ddb5b42b` |
|402D70 canvas placement |`ev_37b8296fe0ea52d6b1d36ba096c60700a7dca3986cb7966b8d6d2884253bf4f0` |
|4037F0 meter percent |`ev_525ca303ce70c16f524063053ebdd9fecd82054cf480d8f2f30f1ec0d7e08333` |
|DLL10029430 canvas render |`ev_f133d0c29cd7b2969814c4b89df37e369776d954543980c93dc69bc3ccb7e579` |
|DLL10029180 canvas construction |`ev_856445a19d924cf5ec157575da27686731caca9a1a611895a98d269fe31c4b03` |
|DLL10037AC0 draw_surface |`ev_143b978a715b32486294f27aa987c926c0cf8f52e09a2116b81ec34803d9962b` |
|DLL10029870 update_logic |`ev_5021f9ff80b9087cafdf449976e363921d6159833f003efe15870f24932d8343` |
|DLL10029890 compute_auto_align |`ev_b963c3e443054b1425af94a27efd37cc157f6dd2070d2d87cbb2a78f72dc083e` |
|DLL10029930 get_canv_wordsize |`ev_d766e30f3466351eaea497f58546f564563849cf9fdc269c42b131c01ac542a5` |
Constructor401430 opens `omt/screens.omt` and binds global4F7CB0 to canvas21 at
4017CB, global4F8028 to canvas22 at401865 through402D70→menu454/402E30. Literal
coordinate arguments are(320,7) and(322,4). Constructor sets sprite source blend6,
destination1 or7 according to graphics509A13; RGBA initiallywhite. Runtime
menu484/488 show/hide both;48C/490 change fill tint to red(1,.2,.2,1)/white.
Those latter caller/state branches are guarded by [Invisible](invisible.md).
4037F0 (raw0x37F0) clamps only negative percent to0, writes fill width
`screenWidth/640*27`, and height `screenHeight/480*percent*1.04`. Global4F6560 is
screen width,4F655E height. The multiplier at48D908/raw8D908 is a stored double
**1.04**, not0.01. At100 percent the logical height is104. Width/height are fields
AC/B0; source sprite placement44/48 stays separate. No forced100 clamp is proven
in this leaf. Caller supplies the actual timer/recharge conversion.
Texture resize is **full-image stretch**, not percentage UV cropping. Canvas
render10029430 obtains custom AC/B0 dimensions when flagC4 bit0 is set, then
forwards the original canvas, cached offsets, dimensions and RGBA90 to renderer
slotB0.402D70 sets flagC4 to1. DX draw_surface10037AC0 builds a rectangle using
the supplied width/height, with source UV0..0.9999 for the single-texture path;
the tiled path distributes the complete source canvas across those dimensions.
Percentage does not enter UV selection. The modern texture uses0..1 over the
exact decoded image; legacy edge epsilon/texture padding remain renderer details.
The tint multiplies this original gradient once; no replacement solid fill or
partial-source gradient crop is evidenced. Source48C/490 tint leaves are already
in the guarded192-byte meter_tint span0x3730..37F0.
Modern layout policy: interpret the source coordinates using a640×480 logical
viewport with uniform widescreen scale, background rectangle(320,7,30,110),
fill width27 and bottom114/top `114−1.04*percent`. This preserves source initial
bottom placement while changing height. It is explicitly not a fully closed
original pixel-position recovery:402D70 writes alignment modesBC/C0=3;
constructor initializes cached offsetsA0/A4=0, while engine update_logic10029870
can recompute−half-size offsets through10029890. Canvas render forwards cached
offsets and dimensions. Whether these menu sprites enter that engine logic pass,
and the exact frame of recomputation, remain unresolved. Pseudocode for402D70
has incorrectly recovered parameters; its arguments/formulas above are checked
against the guarded instructions, not copied from its prototype.
## Original tutorial fixtures
| Data | VR01 Bubble | VR03 Invisible |
| --- | --- | --- |
|GAM SHA256 |`7938214fb62784fcb34245491342a5f33e3615bdc178e4883a9e285e6869904f` |`8acc4d3b8c416c41c1900ac0b1f895ab5819781e5dd87d19a1f177414660d5b2` |
|Entity count |16 |67 |
|Scene shape |`VRRoom`,60 vertices/80 triangles |`Box01`,280 vertices/424 triangles |
|PHONEBOOTH STRT offset |0x45C |0x406 |
|Authored root |(−2678.0381,87.3322,−2783.4011) |(−292.9982,160.3451,−2467.5544) |
|Yaw |290 |290 |
|Intro |`bu`,3MCA0xA61 |`inv`,3MCA0x8EEE |
|Voicepractice IDs |24/23/22 |21/20/37 |
|Return LOAD offsets |0x83C radius400;0x1631 radius300 |0x94DE radius300 |
Both intros serialize PlayerControlled=NULL and NextTrigger=default. VR01 has
DeactivateInv=1; VR03 omits that property. Absence is not evidence forfalse;
the constructor/default binding is documented separately by the Invisible
investigator. VR03 source SoundIndex0/1/2 properties occur at0x90F7/0x9176/0x91F5.
The voice bank also contains invisibility4/ID38, but this intro does not use it.
VR03 contains eight actual3SOL at source offsets0x7BA,14B0,1EB7,342B,4828,4D2F,
5736,633B. All share ObjectTag `C3DYOKIANSOLDIER`; keep actor identity by instance/
source offset, never collapse them into one dictionary/tag lookup. Each serializes
AIState2, VisibleRange2500,FOV359,TargetNameJIM1. These data values do not recover
the target-detection algorithm or prove combat/AI is implemented.
Literal patrol links contain two missing names: yok3→`tok4`, and soldier0x5736
starts at `fyoy1`; supplied patrols contain `yok4`/`fyok1`. Preserve these original
strings rather than silently repairing them. VR01 contains no3SOL.
A meaningful bounded Invisible fixture can load actualVR03/PHONEBOOTH, skip or
complete its source intro, and exercise equipped/ready/activation/expiry/recharge/
cleanup against the current player, atlas and meter. It must establish item2
availability through the existing inventory/PostLoad contract. No fake enemy or
invented vision/combat response is needed to verify this first effect. Tutorial
navigation, stealth detection and trophy/RETURN completion remain separate tests.
## Bubble assets retained for later
`RetainedSprites.omt` Canv1 `orangebubble` at0x17FCE/66322 bytes decodes146×146,
with15,824 opaque and5,492 transparent pixels. RGBA SHA256:
`a3a678c47c1ce94946b1136560a84f3ef86c6884b981256a9fbff62fe8a988e4`.
This is confirmed by the Bubble constructor's explicit archive/ID binding, not
just its name: [Bubble report](bubble.md), constructor410840 REA
`ev_a0c9ee6d5757a741190f3dfcc093bdc7d7b802bcdcd2cbc029422550d34e7cb2`,
saved/exported/closed in `artifacts/bubble/rea-effect/`. No new ASE is indicated.
SoundEffects Wave2/3/106 are gravitybubble/gravitybubbleoff/bubble boing; serialized
resource identities alone do not establish repeat/stop ownership. Bubble pulse,
growth/fade/collision and billboard orientation belong to that system report.