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>
This commit is contained in:
Claude Fable 5
@@ -0,0 +1,97 @@
|
||||
//===========================================================================//
|
||||
// File: seqctl.cpp //
|
||||
// Project: BattleTech Brick: Mech animation //
|
||||
// Contents: The Mech keyframe-animation player (leg / body gait clips) //
|
||||
//---------------------------------------------------------------------------//
|
||||
// Copyright (C) 1995, Virtual World Entertainment, Inc. //
|
||||
// All Rights reserved worldwide //
|
||||
// This unpublished sourcecode is PROPRIETARY and CONFIDENTIAL //
|
||||
//===========================================================================//
|
||||
|
||||
#include <bt.hpp>
|
||||
#pragma hdrstop
|
||||
|
||||
#if !defined(SEQCTL_HPP)
|
||||
# include <seqctl.hpp>
|
||||
#endif
|
||||
|
||||
#if !defined(MECH_HPP)
|
||||
# include <mech.hpp>
|
||||
#endif
|
||||
|
||||
//
|
||||
//#############################################################################
|
||||
//#############################################################################
|
||||
//
|
||||
SequenceController::SequenceController()
|
||||
{
|
||||
keyframeCount = 0;
|
||||
jointCount = 0;
|
||||
footStepThreshold = NULL;
|
||||
jointIndices = NULL;
|
||||
keyframeTimes = NULL;
|
||||
keyframeBase = NULL;
|
||||
keyframeCursor = NULL;
|
||||
keyframeData = NULL;
|
||||
currentFrame = 0;
|
||||
currentTime = 0.0f;
|
||||
jointSubsystem = NULL;
|
||||
owner = NULL;
|
||||
clipResource = NULL;
|
||||
finishedCallback = NULL;
|
||||
callbackArg2 = 0;
|
||||
callbackArg3 = 0;
|
||||
}
|
||||
|
||||
//
|
||||
//#############################################################################
|
||||
// Init Bind the player to its owning mech and cache the joint subsystem the
|
||||
// gait writes through. Called from the Mech ctor for legAnimation/bodyAnimation.
|
||||
//#############################################################################
|
||||
//
|
||||
void
|
||||
SequenceController::Init(Mech *owner_mech)
|
||||
{
|
||||
Check(owner_mech);
|
||||
owner = owner_mech;
|
||||
jointSubsystem = owner_mech->GetJointSubsystem();
|
||||
clipResource = NULL;
|
||||
}
|
||||
|
||||
//
|
||||
//#############################################################################
|
||||
//#############################################################################
|
||||
//
|
||||
SequenceController::~SequenceController()
|
||||
{
|
||||
//
|
||||
// Releases the locked clip resource when reconstructed; nothing is locked
|
||||
// while SelectSequence is staged.
|
||||
//
|
||||
}
|
||||
|
||||
//
|
||||
//#############################################################################
|
||||
// Playback -- the per-frame gait engine (clip parse, keyframe interpolation,
|
||||
// joint writes). Exercised only once the mech is ticking; not yet
|
||||
// reconstructed. See SEQCTL.NOTES.md.
|
||||
//#############################################################################
|
||||
//
|
||||
void
|
||||
SequenceController::SelectSequence(int, void *, unsigned, unsigned)
|
||||
{
|
||||
Fail("SequenceController::SelectSequence -- seqctl.cpp not yet reconstructed");
|
||||
}
|
||||
|
||||
Scalar
|
||||
SequenceController::Advance(Scalar, int)
|
||||
{
|
||||
Fail("SequenceController::Advance -- seqctl.cpp not yet reconstructed");
|
||||
return 0.0f;
|
||||
}
|
||||
|
||||
void
|
||||
SequenceController::Reset(int)
|
||||
{
|
||||
Fail("SequenceController::Reset -- seqctl.cpp not yet reconstructed");
|
||||
}
|
||||
@@ -0,0 +1,86 @@
|
||||
#if !defined(SEQCTL_HPP)
|
||||
# define SEQCTL_HPP
|
||||
|
||||
//##################### Forward Class Declarations #######################
|
||||
class Mech;
|
||||
class JointSubsystem;
|
||||
|
||||
//##########################################################################
|
||||
//###################### SequenceController ##########################
|
||||
//##########################################################################
|
||||
//
|
||||
// The BT keyframe-animation player embedded in the Mech as legAnimation and
|
||||
// bodyAnimation. It plays a gait clip: walks the clip's keyframes,
|
||||
// interpolates each animated joint's rotation, writes it through the joint
|
||||
// subsystem, and returns the root-translation distance advanced this step.
|
||||
//
|
||||
// Reconstructed from the shipped binary (ctor/Init @00427768, SelectSequence
|
||||
// @004277a8, Advance @0042790c, Reset @004283b8). Not in the surviving 4.10
|
||||
// archive nor the RP engine. See SEQCTL.NOTES.md.
|
||||
//
|
||||
class SequenceController
|
||||
{
|
||||
public:
|
||||
//
|
||||
// One root-translation entry (per keyframe); ".stride" is the forward
|
||||
// (local Z) distance the gait reads.
|
||||
//
|
||||
struct Keyframe
|
||||
{
|
||||
Scalar x, y, stride;
|
||||
};
|
||||
|
||||
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
// Construction / Destruction
|
||||
//
|
||||
public:
|
||||
SequenceController();
|
||||
~SequenceController();
|
||||
|
||||
void
|
||||
Init(Mech *owner_mech);
|
||||
|
||||
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
// Playback
|
||||
//
|
||||
public:
|
||||
void
|
||||
SelectSequence(
|
||||
int clip_id,
|
||||
void *finished_callback,
|
||||
unsigned callback_arg2,
|
||||
unsigned callback_arg3
|
||||
);
|
||||
Scalar
|
||||
Advance(Scalar time_slice, int move_joints);
|
||||
void
|
||||
Reset(int loop);
|
||||
|
||||
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
// Clip data (parsed by SelectSequence; keyframe accessors read by the gait)
|
||||
//
|
||||
public:
|
||||
int keyframeCount;
|
||||
int jointCount;
|
||||
Scalar *footStepThreshold;
|
||||
int *jointIndices;
|
||||
Scalar *keyframeTimes;
|
||||
void *keyframeBase;
|
||||
void *keyframeCursor;
|
||||
Keyframe *keyframeData;
|
||||
|
||||
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
// Runtime state / links
|
||||
//
|
||||
public:
|
||||
int currentFrame;
|
||||
Scalar currentTime;
|
||||
JointSubsystem *jointSubsystem;
|
||||
Mech *owner;
|
||||
void *clipResource;
|
||||
void *finishedCallback;
|
||||
unsigned callbackArg2;
|
||||
unsigned callbackArg3;
|
||||
};
|
||||
|
||||
#endif
|
||||
@@ -0,0 +1,41 @@
|
||||
# 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).
|
||||
Reference in New Issue
Block a user