Reset cutscene facing destination with original camera rotation handoff
This commit is contained in:
1 parent
7818cc8d64
commit
dae13ace73
24 files changed
+2864
-9
No files matched your search
@@ -0,0 +1,102 @@
|
||||
# Jimmy cutscene rotation: source ownership
|
||||
|
||||
2026-11-05. User reports that jumping at an angle into cutscene triggers retains
|
||||
Jimmy's airborne tilt. This investigation identifies a direct source mismatch,
|
||||
not a new global "cutscenes upright" policy.
|
||||
|
||||
## Source and provenance
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
REA retained complete instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||||
artifacts/jimmy-movement-audit/rea-original-disassembly.json, supplies the exact
|
||||
instruction windows. `tools/binary/jimmy_cutscene_rotation.py` independently
|
||||
checks original identity and seven complete instruction-range hashes; optional
|
||||
`--rea-disassembly` retains matching extracts in its generated source.json.
|
||||
Preferred VA400000; raw offsets below are VA minus400000, independently checked
|
||||
against PE section mapping. This uses existing REA evidence rather than repeating
|
||||
the previously unsupported native selectors.
|
||||
|
||||
## Recovered facts
|
||||
|
||||
Jimmy game interface is complete+C0. Current Euler is game224/228/22C/230,
|
||||
complete2E4/2E8/2EC/2F0. Destination Euler is game274/278/27C/280,
|
||||
complete334/338/33C/340. Byte game+A is facing dirty; byte+5 is facing enabled.
|
||||
|
||||
| Original boundary | Current and destination ownership |
|
||||
|---|---|
|
||||
|CAM NULL control:416671..4166EB, file16671..166EB|Read current full Euler through328 at41667E→4723F0. Build `(0,current.Y,0,current.W)`. Direct-write destination at4166A0..4166C9, then full current setter32C at4166E5→472450. Neither operation writes dirty or calls destination setter36C.|
|
||||
|Initial MCA:431518..431590, file31518..31590|Read328 at431525; build the same flat Vec4; write current32C at431565, then direct-write destination431578..43158D. Preserve dirty.|
|
||||
|Current full setter32C→472450, file72450|Copies all four values to game224..230; does not touch destination/dirty. Distinct from current XYZ setter330→472420.|
|
||||
|Destination XYZ setter36C→472660, file72660|Writes destinationXYZ and sets dirty+A=1. Camera suffixes bypass this setter; using it would introduce a dirty-state change absent from source.|
|
||||
|Facing43A420, file3A420|Global-ready475CA0, enabled+5, dirty+A gate. On acceptance, clears dirty first, compares before-step current/target axes, marks dirty for any unequal axis, adds per-axis angular deltas through334. Runs before Jimmy's raw-control gate437A1B.|
|
||||
|
||||
The old [preparation report](../checkpoint/cutscene-preparation.md) called
|
||||
game274 a "cached Euler". The later [target-state recovery](jimmy-air-target-state.md)
|
||||
identifies this same storage as the live facing destination. These camera writes
|
||||
therefore replace the **whole destination**, including Y with current Y; they do
|
||||
not merely cache an independent render rotation. Full W is copied too, though the
|
||||
port currently models orientationXYZ only.
|
||||
|
||||
CAM's broader order remains438 cleanup→410 stop→orientation writes→clear raw
|
||||
control. MCA starts410 stop→orientation writes→438 cleanup→clear raw control.
|
||||
Their prior-owner guards still apply. Initial MCA's first-name `none` guard exits
|
||||
before this path; subsequent shots do not repeat it. Generic AI NULL ownership
|
||||
40C4AD..40C527 only stops motion and clears control: **no flattening**. DEFAULT
|
||||
restores control without flattening/preparation. Animation STOP is also separate
|
||||
from these orientation writes. Do not flatten on every input lock, shot, action
|
||||
change, or missing controller tick.
|
||||
|
||||
## Port mismatch and implementation contract
|
||||
|
||||
At investigation start, LabSimulation.FlattenOrientation only set Pitch=Roll=0;
|
||||
it left destinationEuler at the airborne target. The newly restored full-Euler
|
||||
facing bridge legitimately runs while uncontrolled. Its next step therefore
|
||||
interpolates Jimmy back toward the stale airborne pitch/bank and possibly old
|
||||
heading. The source camera path overwrites that stale target at the handoff.
|
||||
|
||||
Replace currentXYZ and destinationXYZ with `(0,currentYaw,0)` on this existing
|
||||
FlattenOrientation boundary, preserving facingDirty/facingEnabled and all motion,
|
||||
impulse, jump/hold/fire and pitch seeds. Preserve named-authored/current writes as
|
||||
separate ownership; do not make arbitrary current setter writes reset destination.
|
||||
The existing CAM/MCA order and prior-owner guards remain authoritative. Parent
|
||||
owns integration and managed/native port checks.
|
||||
|
||||
## Verification boundary
|
||||
|
||||
The source guard passes against authoritative bytes. The bounded native probe
|
||||
executes the copied original orientation suffixes with the actual328/32C leaves,
|
||||
then the actual43A420 facing leaf and334 Euler-add chain, using synthetic owner
|
||||
storage/vtables and a forced-ready global facing gate. It does not execute game
|
||||
entrypoints, camera activation, actor registry, body, inputs, gadget cleanup or
|
||||
renderer. All execution is in the generated copy with Original unmounted and
|
||||
network disabled. All20 native cases pass (CAM/MCA × five initial Euler pairs × dirty0/1).
|
||||
Each suffix changes exactly the full current/destination vectors in the synthetic
|
||||
object; all other sentinel bytes, including enabled/dirty, are preserved. Before
|
||||
facing, current and target both equal `(0,oldCurrent.Y,0,oldCurrent.W)`; after
|
||||
one real facing pass dirty is0, and after30 passes the same upright vectors
|
||||
remain. Cases cover positive tilt, actual powered-flight-style wrapped tilt,
|
||||
negative tilt, heading359 with target1, and heading360 with target0. Initial
|
||||
current/targetW differ, proving the source copies currentW into both.
|
||||
|
||||
Artifacts: artifacts/jimmy-cutscene-rotation/build/source.json,
|
||||
probe/wine.log, probe/capture.json, native-observations.json. The JSON retains all
|
||||
before/prepared/after-facing/after30 vectors and dirty bytes for managed
|
||||
comparison. First3s capture only created the Wine prefix; repeating with12s allowed
|
||||
initialization and completed with exit0 and the required marker. This is a native
|
||||
original-component execution under Wine32, not whole-game/runtime Windows parity.
|
||||
|
||||
```sh
|
||||
python3 tools/binary/jimmy_cutscene_rotation.py ../Original \
|
||||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--generate-probe artifacts/jimmy-cutscene-rotation/build
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-cutscene-rotation/build/jimmy_cutscene_rotation_probe.c \
|
||||
-o artifacts/jimmy-cutscene-rotation/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-cutscene-rotation/build/probe.exe \
|
||||
--probe-success JIMMY_CUTSCENE_ROTATION_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-cutscene-rotation/probe
|
||||
```
|
||||
|
||||
Reference in new issue
Block a user