Files
TeslaRel410/CODE/RP/MUNGA/OBJSTRM.HPP
T
CydandClaude Fable 5 fdd9ac9d97 Initial import: Tesla Release 4.10 (Tesla:BattleTech & Tesla:Red Planet)
Archival snapshot of the Virtual World Entertainment Tesla cockpit
software, 1994-1996: MUNGA engine and L4 pod layer source (Borland
C++ 5.0), BT/RP game code, and game content (models, audio, maps,
gauges, Division renderer data). Includes third-party libraries:
Division dVS/DPL graphics, HMI SOS audio, WATTCP networking.

Files are preserved byte-for-byte (.gitattributes disables all
line-ending conversion). README.md documents the layout, target
hardware, and toolchain.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:21:58 -05:00

364 lines
8.8 KiB
C++

//===========================================================================//
// File: objstrm.hpp //
// Project: MUNGA Brick: Resource Manager //
// Contents: Implementation Details of resource management //
//---------------------------------------------------------------------------//
// Date Who Modification //
// -------- --- ---------------------------------------------------------- //
//---------------------------------------------------------------------------//
// Copyright (C) 1994-1995, Virtual World Entertainment, Inc. //
// PROPRIETARY AND CONFIDENTIAL //
//===========================================================================//
#if !defined(OBJSTRM_HPP)
# define OBJSTRM_HPP
# if !defined(MEMSTRM_HH)
# include <memstrm.hpp>
# endif
# if !defined(NODE_HH)
# include <node.hpp>
# endif
# if !defined(HASH_HH)
# include <hash.hpp>
# endif
# if !defined(TREE_HH)
# include <tree.hpp>
# endif
# if !defined(CSTR_HH)
# include <cstr.hpp>
# endif
class NotationFile;
class NameList;
class CString;
class ResourceFile;
class ResourceDescription;
//##########################################################################
//######################### ObjectStream #############################
//##########################################################################
class ObjectStream:
public DynamicMemoryStream
{
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Construction, Destruction and testing
//
public:
ObjectStream();
ObjectStream(
void *stream_start,
size_t stream_size
);
ObjectStream(ResourceDescription *resource_description);
~ObjectStream();
Logical
TestInstance() const;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Object creation
//
public:
virtual void
CreateObjects();
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Notation file parsing
//
public:
virtual void
BuildFromNotationFile(
NotationFile *notation_file,
ResourceFile *resource_file
);
ResourceFile*
GetResourceFile()
{return resourceFile;}
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Object ID generation
//
protected:
static ObjectID
MakeUniqueObjectID();
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Implementations
//
protected:
virtual RegisteredClass*
MakeObjectImplementation(Enumeration class_ID);
virtual void
CreatedObjectImplementation(
RegisteredClass *object,
ObjectID object_ID
);
virtual void
BuildFromPageImplementation(
NameList *name_list,
Enumeration class_ID,
ObjectID object_ID
);
virtual void
BuiltFromPageImplementation(
Enumeration class_ID,
ObjectID object_ID,
const CString &object_name_string
);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Private methods
//
private:
void
ParseNotationFile(NotationFile *notation_file);
void
ReadIncludedFiles(NameList *entry_list);
void
ReadMacros(NameList *entry_list);
void
PerformMacroReplacement(NameList *entry_list);
CString
DeriveMacroValue(const CString &token_string);
void
CleanupMacroReplacement(NameList *entry_list);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Private data
//
private:
typedef PlugOf<CString>
MacroValue;
typedef TreeOf<MacroValue*, CString>
MacroSocket;
typedef TreeIteratorOf<MacroValue*, CString>
MacroIterator;
static ObjectID
lastObjectID;
ResourceFile
*resourceFile;
MacroSocket
*macroSocket;
};
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ObjectIDPlug ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
typedef PlugOf<ObjectID>
ObjectIDPlug;
//##########################################################################
//###################### PlugStreamManager ###########################
//##########################################################################
class PlugStreamManager:
public Node
{
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Plug stream types
//
public:
typedef HashOf<Plug*, ObjectID>
PlugIndex;
typedef TreeOf<ObjectIDPlug*, CString>
ObjectIDIndex;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Construction, Destruction and testing
//
public:
PlugStreamManager();
~PlugStreamManager();
Logical
TestInstance() const;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Program termination
//
public:
void
Cleanup();
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Manager Accessors
//
public:
static void
AddPlug(
Plug *plug,
ObjectID object_ID
);
static Plug*
FindPlug(ObjectID object_ID);
static void
AddPlugName(
ObjectID object_ID,
const CString &object_name_string
);
static ObjectID
FindPlugName(const CString &object_name_string);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Private data
//
private:
PlugIndex
plugIndex;
ObjectIDIndex
objectIDIndex;
static PlugStreamManager
plugStreamManager;
};
//##########################################################################
//########################## PlugStream ##############################
//##########################################################################
class PlugStream:
public ObjectStream
{
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Plug stream types
//
public:
typedef VChainOf<Plug*, ObjectID>
LocalPlugIndex;
typedef VChainOf<ObjectIDPlug*, CString>
LocalObjectIDIndex;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Construction, Destruction and testing
//
public:
PlugStream();
PlugStream(
void *stream_start,
size_t stream_size
);
PlugStream(ResourceDescription *resource_description);
~PlugStream();
Logical
TestInstance() const;
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Object creation and utilities
//
public:
void
CreateObjects();
void
AddLocalPlug(
Plug *plug,
ObjectID object_ID
);
void
AddGlobalPlug(
Plug *plug,
ObjectID object_ID
);
Plug*
FindPlug(ObjectID object_ID);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Notation file parsing
//
public:
void
BuildFromNotationFile(
NotationFile *notation_file,
ResourceFile *resource_file
);
void
AddLocalObjectID(
ObjectID object_ID,
const CString &object_name_string
);
void
AddGlobalObjectID(
ObjectID object_ID,
const CString &object_name_string
);
ObjectID
FindObjectID(const CString &object_name_string);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Implementations
//
protected:
void
CreatedObjectImplementation(
RegisteredClass *object,
ObjectID object_ID
);
void
BuiltFromPageImplementation(
Enumeration class_ID,
ObjectID object_ID,
const CString &object_name_string
);
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Private data
//
private:
LocalPlugIndex
*localPlugIndex;
LocalObjectIDIndex
*localObjectIDIndex;
};
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PlugStream functions ~~~~~~~~~~~~~~~~~~~~~~~~
template <class T> void
PlugStream_ReadObjectIDAndFindPlug(
PlugStream *stream,
T** type_pointer
)
{
Check(stream);
Check_Pointer(type_pointer);
ObjectID object_ID;
Plug *plug;
MemoryStream_Read(stream, &object_ID);
plug = stream->FindPlug(object_ID);
*type_pointer = Cast_Object(T*, plug);
}
void
PlugStream_FindEntryAndWriteObjectID(
PlugStream *stream,
NameList *name_list,
const CString &entry_name
);
#endif