Files

148 lines
9.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Shrink ray primary fire and owned effect
2026-10-27. Read-only static recovery from supplied EXE SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Preferred VAs below map to raw file offset VA−400000 for this image's text;
shrink_ray.py independently PE-maps all locations and guards eight bounded
function ranges plus44 source sites. No original code was executed by this task.
## Important identity correction
The inventory/menu highlight is not the raw equipped-mode word4F0588. The
[gadget control investigation](gadget-controls.md) proves selecting group0/item3
cleans current mode to−1, then calls equip174(3); cases3 and−1 leave that mode
unchanged.426E40's shrink scan requires owned item3==1 **and mode−1**. The same
item owns the recovered jetpack ability. Earlier jetpack-only descriptions that
treat SHRINKRAY as an unrelated internal label are superseded by this combined
source path and the original item's SHRINK/JUMP art. Do not implement selected
mode3 as a separate shrink-ray state merely because the menu highlights item3.
## Primary input and animation ownership
| VA / raw | Recovered contract |
|---|---|
|426030 /26030|Input callback first requires407060 false,475CA0 true, controlled5099E4 nonnull, global4F8430 false and interface1D2D false. Movement438A60 and gadget subhandlers run before the ordinary fire tail.|
|42A7A0 /2A7A0|Primary helper is false while4F83E0 is set; otherwise OR of509834,509845,509849,509AC4. Readme maps Enter/Ctrl/left mouse; pad input remains separate.|
|426566..42657F /26566|Held primary helper OR keyboard13 invokes the held-fire branch. Release stops the owned sound loop and hides the ray.|
|42668F..4266BD /2668F|Busy1D65 or modal4F8182 rejects; raw mode0 rejects; otherwise controller speed608 is set0.|
|4266C8..4266F1 /266C8|Grappler/energy subhandlers run; mode4 exits; ordinary mode−1 continues.|
|4266F7..42672B /266F7|Supported body requests SHOOT, then animation148. The caller's grounded shooting pose, not the collision support routine, owns this action.|
|4268BE..4268F7 /268BE|Owned item3 must equal1. If sound handle interface974==−1, start SFX0 looping and retain its handle. Invalid availability emits SFX117 and latches busy1D65 until release.|
|426902..42698C /26902|Airborne branch permits the ordinary fire path around the FALL action and owns its own loop interruption; do not force all airborne frames to grounded SHOOT.|
|4269BD /269BD|Complete virtual1B8 invokes426E40 after these gates. No one-shot cooldown or projectile spawn is present in426E40. It is a held, per-input-invocation scan.|
Raw primary callback physics/control predicates are separate from the modern F1,
inspection, focus and practice modal policies. New primary input must be cleared
at modern capture boundaries and must not leak into cutscene skip/menu selection.
## Target scan and hit order
426E40..427334:
1. Require403950(group0,item3)==1 and signed4F0588==−1.
2. Show Jimmy-owned complete object+A10 (interface+950) if present. Copy Jimmy's
current root exactly via318 and current Euler exactly via330. There is no
muzzle offset in this caller; the original ASE supplies the effect geometry.
3. Call42A920(−dt) once **before target traversal**, even if there is no hit.
There is no positive-energy test in this ordinary scan.42A920 exempts original
VR01..VR08, otherwise clamps energy0..100 and owns low/empty sounds/latches.
4. Traverse object registry50999C in linked order. Payload is the game interface.
Require interface13E nonzero, class-name check18(`C3DENEMY`), interface898
nonzero and interface8B0 false (already-shrunk flag).
5. Require enemy rootY strictly greater than JimmyY−150 and strictly less than
JimmyY+60. Full root-to-root Euclidean distance must be strictly below1500.
6. Call imported vector calculate_angles48D108; convert its signed-short heading
to degrees with stored float0.02197265625. Require heading strictly inside
JimmyEulerY−5 .. JimmyEulerY+5. These instructions add no seam wrapping; exact
angle production/convention and generic Euler normalization remain a separate
numeric contract. The helper projection accepts the recovered heading as input.
7. Build a source ray from Jimmy root+(0,150,0) to offset384(0,150,distance).
Call47C210 and reject on **any accepted wall-query hit**. This is the original
static grid/winding query, not nearest sphere sweep or a pixel/crosshair test.
8. For each accepted enemy invoke Jimmy complete1DC→42AC10(target interface).
There is no break/nearest-target reduction: multiple eligible enemies may be
hit in a single invocation. Registry order and source wall query are dependencies.
42AC10 requests exact action string `SHRINK` at4EF71C with argument0 through
enemy completeE0, sets enemy complete124(5), then complete974=30.0 and
complete970=true. Those fields are interface8B4 timer and8B0 flag. It also owns
class/tag-specific objective, score and Humphrey policy, so generic shrinking
must not invent a universal score or destruction event.
The independent [target investigation](shrink-targets.md) owns actual3SOL class,
SHRINK morph, timer expiry and restored action. Its source check corrects an
initial label:44AEC6 requests `WALK` (4ECA54), not STOP. Visual shrink is driven
by the original morph/action; do not substitute an invented uniform scale.
## Beam effect is an owned object, not a ballistic projectile
Jimmy constructor4222AB allocates6D0 bytes;4222C9 calls43FE20 and4222D9 stores
the resulting complete object at Jimmy+A10.43FE20 establishes C3DShrinkRay
interface table4B4350, invokes440000 Init and disables its physical collision
through220 setter4710C0. Phase complete6BC starts0 (interface5FC).
440000 Init binds `HIRAY`→`ray.ase` at440037, then texture slots0/1/2 to
ray0000.png/ray0001.png/ray0002.png. It sets action `RAY`, radius40 and source
factor0.3; these physical values do not imply a moving projectile. The caller
keeps the owned effect at Jimmy's root/Euler while held and hides it on release.
**Opacity, not scale:** C3DShrinkRay complete114 resolves40E4A0. Positive param
walks shape polygons and each nonnull material, writes RGB1 and alpha=param to
material+4C..58, source blend field+30=6, destination+34=7 when global509A13 is
true or1 otherwise, and ORs material flag38 with1. Init and every texture switch
call114(0.5). The earlier per-texture RGBA writes also set0.5; this setter
replaces the alpha rather than multiplying it again. No geometric half-scale is
justified.
The engine adapter10036AB0 (raw36AB0) uses table1013667C (raw13667C) to map both
material enums into D3D render states19/20. Selected entries are6→D3D5 SRC_ALPHA,
1→D3D2 ONE,7→D3D6 INV_SRC_ALPHA. Thus global509A13=false selects alpha-weighted
**additive** blending (SrcAlpha,One), while true selects conventional alpha
(SrcAlpha,OneMinusSrcAlpha). The flag is loaded from a graphics-setup option and
stored476BBE; its complete settings/hardware fallback semantics remain open.
Do not silently treat both branches as conventional alpha. The DLL SHA256 is
`3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
440180 interface3C4 update first invokes base40E050. On its first pass a flag
interface604 causes Init through1C; then float timer600 adds dt. When strictly
greater than **stored double0.1**, phase5FC increments, wraps after2 back0,
swaps the bound texture, reasserts opacity0.5, and resets timer0. It advances at
most once per invocation and discards overshoot. Since float0.1 is slightly above
double0.1, passing an exact float0.1 triggers the switch. No independent finite
beam lifetime is present; hold/release and object visibility own it.
## REA evidence, gaps and checks
The three owned EXE REA sessions used the generated hashed
artifacts/uncontrolled-phases/rea/Neutron.exe and closed/exported normally.
A fourth session used the generated artifacts/asset-probe/game/OMT2.dll copy for
the blend adapter, also closed/exported under artifacts/shrink-ray/rea-blend/.
| Retained path | Successful Evidence |
|---|---|
|artifacts/shrink-ray/rea-primary-followup/03.json|42A7A0 ev_3ff9cde0cab7a1e7ed456591becfcc4c4f4db3796aa6ab5e76a1dd124f9dac47|
|rea-primary-followup/04.json|42A920 ev_71897af12f4bfa1de946c6f17f3bbed34764fdc84258ce64516c8f1f904b465d|
|rea-effect/00.json|440000 ev_875816ebeb0d690c83518f14f36a13d646009d3530c0ad1f27efbd3a2342aeff|
|rea-effect/03.json|43FE20 ev_3ae9cf6456693b674f937b0e4c86392b88f0d80f8eb416e5b7585f08f790e7f9|
|rea-blend/00.json|10036AB0 ev_f5a914ee9eae593b02a04149b6651b2d783151df046bbb417624bf94f23bb96c|
426030/426E40/429D00 VA queries were unrecognized; corrected raw-offset selectors
were tried once and also failed.440180 and42AC10 likewise have no recognized
procedure in this profile. Errors/complete diagnostics remain beside successful
Evidence; their conclusions use fixed source instruction/body guards and the
matching class/vtable/asset chain, not invented successful decompilation.
`python3 -m unittest discover -s tests -p test_shrink_ray.py -v` passes seven groups:
source bodies/constants/assets/opacity anchors; owned3/mode−1; independent target
gates; strict range/height; strict quantized-heading/no-added-wrap; texture float/
double threshold, wrap and discarded overshoot; DLL body/table identity and
additive/conventional-alpha factor distinction. These are source projections,
not original execution or managed/native gameplay verification. Complete source
report can be generated with shrink_ray.py ../Original; originals remain read-only.
Remaining: exact imported heading production/Euler normalization, full airborne
SHOOT interruption, graphics-option/depth order, full enemy class/
script/score policies and original whole-game runtime comparison. The source
device's held geometry, textures, ownership gates and target callbacks support a
bounded first implementation; a synthetic projectile cadence is not supported.