Files
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

184 lines
5.3 KiB
C++

/*
* ----------------------------------------------------------------------------
*
* Copyright 1995 Division Limited.
* All Rights Reserved
*
*
* System :
* Module :
* Object Name : $RCSfile: pgeneral.h,v $
* Revision : $Revision: 1.1 $
* Date : $Date: 95/04/27 23:01:16 $
* Author : $Author: bill $
* Last Modified : <260495.2024>
*
* Description
*
* Notes
*
* History
*
*
* ----------------------------------------------------------------------------
*/
/*
* The following functions are provided in this module
*
* Return flags - to be used in all libs and converters
* dpgSUCCESS=0, dpgERROR=-1
*
* Verbose output setup (special "stderr" & "stdout")
* dpgSetOutput(n)
*
* Verbose warning setup and usage
* dpgSetWarnLevel(n)
* dpgWarn(n,(print stuff))
*
* Verbose error setup and usage
* variable dpgErrNo - set to the last error num ;
* dpgSetErrorLevel(n)
* dpgError(num, n,(print stuff))
*
* Verbose monitering setup and usage
* dpgSetMonitorFlag(n)
* dpgMonitor(flag,(print stuff))
*
* Verbose bad parameter passed error handler
* dpgBadAddress(addr,String)
*
* Dying routine, outputs to the log and if not stderr, out to stderr
* dpgDie(level,(print stuff))
*
* malloc and calloc routines that print out an error and exit on failure.
* dpgMalloc(size,string)
* dpgRealloc(pnt,size,string)
* dpgCalloc(nel,size,string)
*
* dm macro Extensions
*
*/
#ifndef __PGENERAL_H__
#define __PGENERAL_H__
#include <dsys/divtypes.h>
#include <dsys/dm.h>
/* The program name must be defined and setup by the program */
extern char *progname ;
#define dpgSUCCESS 0
#define dpgERROR -1
/* General error numbers */
#define dpgENO_NULL 0x1001
#define dpgENO_ROPEN 0x1002
#define dpgENO_READ 0x1003
#define dpgENO_WOPEN 0x1004
#define dpgENO_WRITE 0x1005
/* Verbose output setup (special "stderr" & "stdout") - returns dpgERROR
* if couldn't open the file, SUCCESS otherwise
*/
extern FILE *dpgLog ;
int32
dpgSetOutput(char *name) ;
#define dpgFlush() fflush(dpgLog)
/* internal functions */
/* If the next variable is non-zero then when any printing is done, a new
* line will be inserted and the variable will be reset to 0 */
extern int32 dpgNewLine ;
#define dpgSetNewLine(v) (dpgNewLine=(v))
/* Verbose warning setup and usage */
extern int32 dpgWarnLvl ;
/* general printing routine */
extern void dpgPrint(char *format, ...) ;
void
dpgPrintActivity(int32 Cur, int32 Tot) ;
#define dpgIncWarnLevel() (dpgWarnLvl++)
#define dpgSetWarnLevel(n) (dpgWarnLvl = n)
extern int32 __dpgWarn(char *format, ...) ;
#define dpgWarn(lvl,p) \
((lvl <= dpgWarnLvl) ? (__dpgWarn p):dpgSUCCESS)
/* Verbose error setup and usage */
extern int32 dpgErrorLvl ;
extern int32 dpgErrNo ;
#define dpgIncErrorLevel() (dpgErrorLvl++)
#define dpgSetErrorLevel(n) (dpgErrorLvl = n)
extern int32 __dpgError(char *format, ...) ;
#define dpgError(num,lvl,p) \
((dpgErrNo = num),((lvl <= dpgErrorLvl) ? (__dpgError p):dpgERROR))
/* Verbose monitor setup and usage */
extern int32 dpgMonitorFlg ;
#define dpgSetMonitorFlag(n) (dpgMonitorFlg = n)
extern int32 __dpgMonitor(char *format, ...) ;
#define dpgMonitor(flag,p) \
((flag & dpgMonitorFlg) ? (__dpgMonitor p):dpgSUCCESS)
#define dpgTestMonitor(flag) \
((flag & dpgMonitorFlg) ? dpgERROR:dpgSUCCESS)
/* Dying routine, outputs to the log and if not stderr, out to stderr - exits
*/
extern void dpgDie(char *format, ...) ;
#define dpgQDie() \
do { \
fprintf(stderr,"Press q to quit.\n") ; \
if(getchar() == 'q') \
dpgDie("User requested death\n") ; \
} while(0)
/* Verbose bad parameter passed error handler - returns ERROR if addr is
* NULL also does dpgError, returns SUCCESS otherwise
*/
int32
__dpgBadAddress(char *posStr) ;
#define dpgBadAddress(addr,posStr) \
((addr == NULL) ? __dpgBadAddress(posStr) : dpgSUCCESS)
/* malloc and calloc routines that print out an error and exit on failure. */
void *
dpgMalloc(size_t size, char *posStr) ;
void *
dpgRealloc(void *pnt, size_t size, char *posStr) ;
void *
dpgCalloc(size_t noElm, size_t size, char *posStr) ;
/* The following are useful dm extensions */
#define dmVectorSqrLen(a) \
(dmSqr((a)[DM_X]) + dmSqr((a)[DM_Y]) + dmSqr((a)[DM_Z]))
#define dmVectorLen(a) dmVectorLength(a)
#define dmVectorUnit(a) \
do { \
float32 mod ; \
mod = dmLength3(a) ; \
(a)[DM_X] /= mod ; \
(a)[DM_Y] /= mod ; \
(a)[DM_Z] /= mod ; \
} while (0)
#define dmVectorCmp(a,b) memcmp(a,b,sizeof(dmVector))
#endif /* __PGENERAL_H__ */