Files
TeslaRel410/restoration/source410/BT/SEQCTL.NOTES.md
T
CydandClaude Fable 5 bc59e39f41 Mech milestone: reconstruct SequenceController (helper 2/3), struct+Init verified
The BT keyframe-animation player embedded in the Mech as legAnimation/
bodyAnimation. Struct field layout (from BT411's binary-offset map), default
ctor, dtor, and Init(Mech*) reconstructed and compile-verified; Init is
ctor-time (Mech ctor calls legAnimation.Init(this)/bodyAnimation.Init(this)) so
it's real (binds owner + caches owner->GetJointSubsystem()). The per-frame gait
engine (SelectSequence/Advance/Reset) is staged with Fail bodies -- it fires
only once the mech is ticking, past the current ctor frontier.

BT stage 23 ok; full tree still links clean. Evidence + real/staged split in
SEQCTL.NOTES.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-19 20:53:54 -05:00

2.1 KiB

SEQCTL.HPP / .CPP — reconstruction notes

Status: struct + ctor/dtor + Init RECONSTRUCTED (compile-verified); the per-frame playback methods (SelectSequence / Advance / Reset) staged. Helper 2/3 of the Mech embedded helpers (MECH-LAYOUT step 1).

SequenceController — the BT keyframe-animation player embedded in the Mech as legAnimation (@0x65c) and bodyAnimation (@0x6bc). Plays a gait clip: walks keyframes, interpolates each animated joint's rotation, writes it through the joint subsystem, returns the root-translation distance advanced. Absent from the 4.10 archive and the RP engine; reconstructed from the shipped binary + BT411's seqctl.cpp decomp.

What's real vs staged

  • Real (ctor-time): default ctor (zeroes all fields) and Init(Mech*) — the Mech ctor calls legAnimation.Init(this) / bodyAnimation.Init(this) (binary; BT411 mech.cpp:685-686), so Init must run at construction. Init binds owner and caches jointSubsystem = owner->GetJointSubsystem() (JMOVER.HPP:104, returns JointSubsystem*), clipResource = NULL.
  • Staged (per-frame, after boot): SelectSequence (@004277a8, clip parse + resource lock), Advance (@0042790c, keyframe interpolation + joint writes — the gait engine, ~145 lines in the decomp), Reset (@004283b8). These fire only once the mech is ticking, well past the current ctor frontier, so they Fail loudly until reconstructed.

Field layout

Field set + order from BT411's binary-offset map (keyframeCount +0x14 … callbackArg3 +0x50). Byte-exact offsets are not required for the functional build (only wire/update-record layout needs that, and SequenceController is not serialised) — the members are declared as named fields and BC4.52 lays them out; the Mech's legAnimation/bodyAnimation slots size to sizeof(SequenceController) self-consistently.

Placement

1995 filename unknown (decomp-only; BT411 used seqctl.cpp). Filed as BT/SEQCTL.HPP + SEQCTL.CPP. Not in the authentic BT.MAK member list, so the build appends seqctl.obj to bt.lib via the extra-objs fallback (order is immaterial — no static init).