Files
BT412/game/reconstructed/btdirect.hpp
T
arcattackandClaude Opus 4.8 7b7d465e5e Initial commit: bt411 -- standalone Windows BattleTech (Tesla 4.10 port)
Clean, self-contained extraction of the BattleTech-specific work from the
reverse-engineering workspace -- engine + game + content + build, with nothing
from Red Planet or the raw archive dumps. Builds green (Win32) and runs the
single-player drive->animate->target->fire->damage->destroy loop out of the box.

Layout:
  engine/   MUNGA + MUNGA_L4 shared 2007 engine, carrying our BT render/loader
            work (bgfload/L4D3D/L4VIDEO: BSL bit-slice decode, LOD/ground/shadow
            models) + image codec; the minimal rp/ headers the audio HAL needs
  game/     reconstructed BT logic + surviving-original BT source + fwd shims
            + WinMain launcher
  content/  full runtime tree (BTL4.RES, VIDEO/, GAUGE/, AUDIO/, eggs, BTDPL.INI)
  docs/     format specs + reconstruction ledgers
  reference/ raw Ghidra pseudocode (recon source-of-truth) + decomp exporter
  tools/    MP console emulator + map/resource scanners

One top-level CMake builds munga_engine lib + bt410_l4 game lib + btl4.exe.
All paths relativized (186 fwd shims + ~437 CMake abs paths -> repo-relative);
DXSDK is the one external, overridable via -DDXSDK. Verified: builds to a
byte-identical 2.27MB exe and runs combat (TARGET DESTROYED, 0 crashes) against
the bundled content.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-05 21:03:40 -05:00

122 lines
4.6 KiB
C++

//===========================================================================//
// File: btdirect.hh //
// Project: Red Planet //
// Contents: Chooses from a Selection of Camerea's and provides information //
// to any number of cameraship's as to which player to follow //
//---------------------------------------------------------------------------//
// Date Who Modification //
// -------- --- ---------------------------------------------------------- //
// 01/15/95 JM Initial coding. //
//---------------------------------------------------------------------------//
// Copyright (C) 1995, Virtual World Entertainment, Inc. //
// All Rights reserved worldwide //
// This unpublished sourcecode is PROPRIETARY and CONFIDENTIAL //
//===========================================================================//
//
// SURVIVING HEADER (ground truth -- reproduced verbatim from
// 410SRC/Telsa40/Rel410/CODE/BT/BT/BTDIRECT.HPP).
//
// The block below was added during reconstruction (see btdirect.cpp for the
// per-method @ADDR evidence) and is *commentary only* -- the class body is
// unchanged from the shipped header.
//
// vtable @005134c4 (PTR_FUN_005134c4; CLASSMAP listed 5134b8 -- that
// is actually mid-string in the "BTCameraDirector"
// ClassDerivations name @005134b1; the real vtable
// starts 0xC later at 005134c4). 17 slots, only
// slot0 (the scalar-deleting dtor @004c1484) is a
// BT override; slots 1..16 inherit CameraDirector.
// ClassDerivations @00513414 DefaultData @00513444
// object size 0x238 (allocated by Make @004c1454 and by the entity factory
// @004c15f0)
//
// BTCameraDirector adds NO data members of its own -- everything it touches
// lives in the engine CameraDirector base (DIRECTOR.HPP; base vtable
// @004e6b4c, base ctor @0042eec8). Base offsets observed in the decomp:
// this+0x1c activePerformance (Simulation::Performance, 12 bytes)
// this+0x28 simulationFlags ((flags & 0xc)==4 => replicant copy)
// this+0x1fc cameraShip receiver (base idx 0x7f; setup target)
// this+0x20c followedVehicle (embedded target Connection/SlotOf,
// base idx 0x83, ctor @0042f121)
// this+0x218 switchTimer (Scalar; base idx 0x86; base inits -1.0f,
// base BeADirector resets 10.0f, BTCameraDirector
// resets 30.0f)
// this+0x21c cameraShip* (Receiver*; base idx 0x87; Dispatch target)
//
#if !defined (BTDIRECT_HPP)
# define BTDIRECT_HPP
# if !defined (DIRECTOR_HPP)
# include <director.hpp>
# endif
# if !defined (BTPLAYER_HPP) && 0
# include <btplayer.hpp>
# endif
class BTCameraDirector :
public CameraDirector
{
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Shared Data support
//
public:
static Derivation ClassDerivations;
static SharedData DefaultData;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Simulation Support
//
public:
typedef void
(BTCameraDirector::*Performance)(Scalar time_slice);
void
SetPerformance(Performance performance)
{
Check(this);
activePerformance = (Simulation::Performance)performance;
}
void
CreateBTCameraShip(Scalar);
void
BeABTDirector(Scalar);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Construction and Destruction Support
//
BTCameraDirector(
MakeMessage *creation_message,
SharedData &virtual_data = DefaultData
);
static BTCameraDirector*
BTCameraDirector::Make(CameraDirector::MakeMessage *creation_message);
~BTCameraDirector();
Logical
TestInstance() const;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Player-selection support
//
// @0042efe4 in the shipped binary documented this as a CameraDirector
// base helper that walked the "Players" EntityGroup returning the player
// whose display/slot index == i. The modernized engine CameraDirector
// exposes only FindPlayerByRank(rank); BTCameraDirector needs the by-slot
// variant, so it is declared here (BT-local) and defined in btdirect.cpp.
//
private:
Player*
GetPlayerByIndex(int index);
};
#endif