48 lines
3.6 KiB
Markdown
48 lines
3.6 KiB
Markdown
# Cutscene preparation and control handoff
|
||
|
||
2026-10-26, static EXE evidence. SHA256
|
||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||
VAs below use400000 preferred base; raw offset=VA−400000 at these sites.
|
||
cutscene_preparation.py records exact bytes/virtual targets; its projection is
|
||
interpretation, not source execution. Primary completed the investigator's helper,
|
||
corrected its sign-extended byte−1 comparison anchor and added tests/report.
|
||
|
||
| Boundary | Proven order and source sites |
|
||
|---|---|
|
||
|CAM with PlayerControlled=NULL|Guard prior raw owner416635;43841665D→41041666B→flatten current/destination Euler(0,currentYaw,0)41667E..4166E5→game118(NULL)4166F4. Target lookup occurs later416754. Preparation can precede a missing target/sound failure.|
|
||
|Initial MCA activation|First target name `none` guard431300 exits before preparation. A non-none name reaches initial target/animation prelude; missing lookup can continue. Prior owner guard431502;410431512→flatten current/destination Euler431525..43158D→438431598→game118(NULL)4315A7. Per-shot helper invoked431600.|
|
||
|Later MCA shot|CompleteE0→431750; target/sound/animation work, no410/438 or raw control clear. The sound−1 check431771 sign-extends one immediate byte, not a four-byte immediate.|
|
||
|AI PlayerControlled=NULL|Prior raw owner guard40C4AD→41040C4B9→game118(NULL)40C527; no438 or flatten. Named AI ownership remains an older port interpretation requiring broader proof.|
|
||
|DEFAULT|447D5C checks whether Jimmy already owns raw control;447E27 restores via118 without410/438. No new key-release boundary is implemented. Music uses authored ownership independently of debug force.|
|
||
|
||
Jimmy410→42AFC0 calls43A750 first: clear speed608 and velocity XYZ2C4; stop
|
||
saved sound148; then request complete150(`STOP`) at42AFDE/E5. Body changes precede
|
||
the STOP animation notification. Mode, jump, hold, pending impulse, acceleration
|
||
and fire timer are separate. Existing isolated43A750 probe validates its limited
|
||
write set with invalid sound handle; it does not execute full camera activation.
|
||
|
||
Jimmy438→42AE00 invokes selected-gadget cleanup178→427FF0 and sets interface1D65
|
||
and global4F8182. Supported no-selection/jetpack cleanup clears selection; other
|
||
gadget cases are not blanket resets (retained-return-cleanup.md). The port exposes
|
||
these ordered boundaries, implements supported player motion/selection and logical
|
||
orientation changes, and leaves other class/UI/resource side effects explicit.
|
||
|
||
Authored AI movement has separate setters: marker root310 at40C732→target314
|
||
at40C757; yaw40C88F..40C961 uses174→4716D0, writes authored/live Euler and cached
|
||
Euler, and does not write movement destination yaw61C. PlayerSceneBinding applies
|
||
root/yaw to the simulation without erasing pending motion or destination yaw.
|
||
Only actual transform writes emit that event; animation-only changes do not.
|
||
|
||
The port's skip fast-forward, malformed/reentrant activations, MCA's initial
|
||
animation prelude, all other class virtual effects and full shared camera state
|
||
are not certified by this chunk. Existing named control behavior is preserved,
|
||
not newly recovered here. Three byte/projection tests and coupled managed
|
||
director/body tests guard the implemented ordering and boundaries.
|
||
|
||
2026-11-05 correction: game+274 is the facing destination, not an independent
|
||
render cache. CAM/MCA copy `(0,currentYaw,0,currentW)` into both current and
|
||
destination vectors without touching dirty. See
|
||
[exact rotation handoff](../gameplay/jimmy-cutscene-rotation-source.md) for20
|
||
isolated original-code cases and the recovered fix. STOP alone, AI NULL and
|
||
DEFAULT retain their existing separate policies.
|