176 lines
11 KiB
Markdown
176 lines
11 KiB
Markdown
# 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.
|