Commentate code, add a few more CallFuncs

This commit is contained in:
Sally Coolatta 2022-10-06 02:48:43 -04:00
parent 6b94b9728e
commit df47a5fe39
7 changed files with 451 additions and 28 deletions

View file

@ -27,13 +27,11 @@ extern "C"
// //
// ACSVM_Module_GetName // ACSVM_Module_GetName
// //
void ACSVM_Module_GetName(ACSVM_Module const *module_, ACSVM_ModuleName *out) ACSVM_ModuleName ACSVM_Module_GetName(ACSVM_Module const *module_)
{ {
auto module = reinterpret_cast<ACSVM::Module const *>(module_); auto module = reinterpret_cast<ACSVM::Module const *>(module_);
out->s = reinterpret_cast<ACSVM_String *>(module->name.s); return {reinterpret_cast<ACSVM_String *>(module->name.s), module->name.p, module->name.i};
out->p = module->name.p;
out->i = module->name.i;
} }
// //

View file

@ -45,7 +45,7 @@ struct ACSVM_ModuleName
// Extern Functions | // Extern Functions |
// //
void ACSVM_Module_GetName(ACSVM_Module const *module, ACSVM_ModuleName *out); ACSVM_ModuleName ACSVM_Module_GetName(ACSVM_Module const *module);
// Returns false if reading fails. // Returns false if reading fails.
bool ACSVM_Module_ReadBytecode(ACSVM_Module *module, ACSVM_Byte const *data, size_t size); bool ACSVM_Module_ReadBytecode(ACSVM_Module *module, ACSVM_Byte const *data, size_t size);

View file

@ -67,7 +67,7 @@ endif
ifdef GCC45 ifdef GCC45
WFLAGS+=-Wlogical-op WFLAGS+=-Wlogical-op
endif endif
WFLAGS+=-Waggregate-return #WFLAGS+=-Waggregate-return
ifdef HAIKU ifdef HAIKU
ifdef GCC41 ifdef GCC41
#WFLAGS+=-Wno-attributes #WFLAGS+=-Wno-attributes

View file

@ -1,5 +1,6 @@
// DR. ROBOTNIK'S RING RACERS // DR. ROBOTNIK'S RING RACERS
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Copyright (C) 2016 by James Haley, David Hill, et al. (Team Eternity)
// Copyright (C) 2022 by Sally "TehRealSalt" Cochenour // Copyright (C) 2022 by Sally "TehRealSalt" Cochenour
// Copyright (C) 2022 by Kart Krew // Copyright (C) 2022 by Kart Krew
// //
@ -14,19 +15,75 @@
#include "doomtype.h" #include "doomtype.h"
#include "doomdef.h" #include "doomdef.h"
#include "doomstat.h"
#include "d_think.h" #include "d_think.h"
#include "p_mobj.h" #include "p_mobj.h"
#include "p_tick.h" #include "p_tick.h"
#include "w_wad.h" #include "w_wad.h"
#include "m_random.h"
#include "g_game.h"
#include "d_player.h"
#include "CAPI/BinaryIO.h" /*--------------------------------------------------
#include "CAPI/Environment.h" bool ACS_CF_Random(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
#include "CAPI/Module.h"
#include "CAPI/PrintBuf.h"
#include "CAPI/Scope.h"
#include "CAPI/String.h"
#include "CAPI/Thread.h"
ACS wrapper for P_RandomRange.
--------------------------------------------------*/
bool ACS_CF_Random(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{
(void)argC;
ACSVM_Thread_DataStk_Push(thread,
P_RandomRange(PR_ACS, argV[0], argV[1])
);
return false;
}
/*--------------------------------------------------
bool ACS_CF_TagWait(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
Pauses the thread until the tagged
sector stops moving.
--------------------------------------------------*/
bool ACS_CF_TagWait(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{
ACSVM_ThreadState st = {0};
(void)argC;
st.state = ACSVM_ThreadState_WaitTag;
st.data = argV[0];
st.type = ACS_TAGTYPE_SECTOR;
ACSVM_Thread_SetState(thread, st);
return true; // Execution interrupted
}
/*--------------------------------------------------
bool ACS_CF_PolyWait(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
Pauses the thread until the tagged
polyobject stops moving.
--------------------------------------------------*/
bool ACS_CF_PolyWait(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{
ACSVM_ThreadState st = {0};
(void)argC;
st.state = ACSVM_ThreadState_WaitTag;
st.data = argV[0];
st.type = ACS_TAGTYPE_POLYOBJ;
ACSVM_Thread_SetState(thread, st);
return true; // Execution interrupted
}
/*--------------------------------------------------
bool ACS_CF_EndPrint(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
ACS wrapper for CONS_Printf.
--------------------------------------------------*/
bool ACS_CF_EndPrint(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC) bool ACS_CF_EndPrint(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{ {
ACSVM_PrintBuf *buf = NULL; ACSVM_PrintBuf *buf = NULL;
@ -41,6 +98,75 @@ bool ACS_CF_EndPrint(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word ar
return false; return false;
} }
/*--------------------------------------------------
bool ACS_CF_PlayerCount(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
Pushes the number of players to ACS.
--------------------------------------------------*/
bool ACS_CF_PlayerCount(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{
UINT8 numPlayers = 0;
UINT8 i;
(void)argV;
(void)argC;
for (i = 0; i < MAXPLAYERS; i++)
{
player_t *player = NULL;
if (playeringame[i] == false)
{
continue;
}
player = &players[i];
if (player->spectator == true)
{
continue;
}
numPlayers++;
}
ACSVM_Thread_DataStk_Push(thread, numPlayers);
return false;
}
/*--------------------------------------------------
bool ACS_CF_GameType(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
Pushes the current gametype to ACS.
--------------------------------------------------*/
bool ACS_CF_GameType(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{
(void)argV;
(void)argC;
ACSVM_Thread_DataStk_Push(thread, gametype);
return false;
}
/*--------------------------------------------------
bool ACS_CF_GameSpeed(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
Pushes the current game speed to ACS.
--------------------------------------------------*/
bool ACS_CF_GameSpeed(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{
(void)argV;
(void)argC;
ACSVM_Thread_DataStk_Push(thread, gamespeed);
return false;
}
/*--------------------------------------------------
bool ACS_CF_Timer(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
Pushes leveltime to ACS.
--------------------------------------------------*/
bool ACS_CF_Timer(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC) bool ACS_CF_Timer(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC)
{ {
(void)argV; (void)argV;

View file

@ -1,5 +1,6 @@
// DR. ROBOTNIK'S RING RACERS // DR. ROBOTNIK'S RING RACERS
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Copyright (C) 2016 by James Haley, David Hill, et al. (Team Eternity)
// Copyright (C) 2022 by Sally "TehRealSalt" Cochenour // Copyright (C) 2022 by Sally "TehRealSalt" Cochenour
// Copyright (C) 2022 by Kart Krew // Copyright (C) 2022 by Kart Krew
// //
@ -18,6 +19,10 @@
#include "z_zone.h" #include "z_zone.h"
#include "w_wad.h" #include "w_wad.h"
#include "i_system.h" #include "i_system.h"
#include "r_defs.h"
#include "r_state.h"
#include "p_polyobj.h"
#include "taglist.h"
#include "CAPI/BinaryIO.h" #include "CAPI/BinaryIO.h"
#include "CAPI/Environment.h" #include "CAPI/Environment.h"
@ -29,36 +34,121 @@
static ACSVM_Environment *ACSenv = NULL; static ACSVM_Environment *ACSenv = NULL;
/*--------------------------------------------------
ACSVM_Environment *ACS_GetEnvironment(void)
See header file for description.
--------------------------------------------------*/
ACSVM_Environment *ACS_GetEnvironment(void) ACSVM_Environment *ACS_GetEnvironment(void)
{ {
return ACSenv; return ACSenv;
} }
/*--------------------------------------------------
static void ACS_EnvBadAlloc(ACSVM_Environment *env, char const *what)
ACSVM Environment hook. Runs in case of a memory
allocation failure occuring. Environment state
afterwards is unusable; the only thing safe to do
is using ACSVM_FreeEnvironment.
Input Arguments:-
env - The ACS environment data.
what - Error string.
Return:-
N/A
--------------------------------------------------*/
static void ACS_EnvBadAlloc(ACSVM_Environment *env, char const *what) static void ACS_EnvBadAlloc(ACSVM_Environment *env, char const *what)
{ {
(void)env; (void)env;
I_Error("Error allocating memory for ACS (%s)\n", what);
CONS_Alert(CONS_ERROR, "Error allocating memory for ACS (%s)\n", what);
if (env == ACSenv)
{
// Restart the main environment.
ACS_Shutdown();
I_RemoveExitFunc(ACS_Shutdown); // Since ACS_Init will add it again.
ACS_Init();
}
} }
/*--------------------------------------------------
static void ACS_EnvReadError(ACSVM_Environment *env, char const *what)
ACSVM Environment hook. Runs when an ACS module
fails to read. Environment state should be safe
afterwards.
Input Arguments:-
env - The ACS environment data.
what - Error string.
Return:-
N/A
--------------------------------------------------*/
static void ACS_EnvReadError(ACSVM_Environment *env, char const *what) static void ACS_EnvReadError(ACSVM_Environment *env, char const *what)
{ {
(void)env; (void)env;
I_Error("Error reading ACS module (%s)\n", what); CONS_Alert(CONS_WARNING, "Error reading ACS module (%s)\n", what);
} }
/*--------------------------------------------------
static void ACS_EnvSerialError(ACSVM_Environment *env, char const *what)
ACSVM Environment hook. Runs when the ACS state
fails to save or load. Environment state is
safe in that it shouldn't be causing crashes,
but it is indeterminate.
Input Arguments:-
env - The ACS environment data.
what - Error string.
Return:-
N/A
--------------------------------------------------*/
static void ACS_EnvSerialError(ACSVM_Environment *env, char const *what)
{
(void)env;
CONS_Alert(CONS_WARNING, "Error serializing ACS state (%s)\n", what);
}
/*--------------------------------------------------
static void ACS_EnvConstruct(ACSVM_Environment *env)
ACSVM Environment hook. Runs when the
environment is initally created.
Input Arguments:-
env - The ACS environment data to construct.
Return:-
N/A
--------------------------------------------------*/
static void ACS_EnvConstruct(ACSVM_Environment *env) static void ACS_EnvConstruct(ACSVM_Environment *env)
{ {
ACSVM_GlobalScope *global = ACSVM_Environment_GetGlobalScope(env, 0); ACSVM_GlobalScope *global = ACSVM_Environment_GetGlobalScope(env, 0);
// Activate global scope immediately, since we don't want it off. // Activate global scope immediately, since we don't want it off.
// Not that we're adding any modules to it, though. :p
ACSVM_GlobalScope_SetActive(global, true); ACSVM_GlobalScope_SetActive(global, true);
// Add the data & function pointers // Add the data & function pointers
// See also: // See also:
// https://doomwiki.org/wiki/ACS0_instruction_set // - https://doomwiki.org/wiki/ACS0_instruction_set
// // - https://github.com/DavidPH/ACSVM/blob/master/ACSVM/CodeData.hpp
// 0 to 56: Implemented by ACSVM // - https://github.com/DavidPH/ACSVM/blob/master/ACSVM/CodeList.hpp
// 0 to 56: Implemented by ACSVM
ACSVM_Environment_AddCodeDataACS0(env, 57, "", ACSVM_Code_CallFunc, 2, ACSVM_Environment_AddCallFunc(env, ACS_CF_Random));
ACSVM_Environment_AddCodeDataACS0(env, 58, "WW", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_Random));
ACSVM_Environment_AddCodeDataACS0(env, 61, "", ACSVM_Code_CallFunc, 1, ACSVM_Environment_AddCallFunc(env, ACS_CF_TagWait));
ACSVM_Environment_AddCodeDataACS0(env, 62, "W", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_TagWait));
ACSVM_Environment_AddCodeDataACS0(env, 63, "", ACSVM_Code_CallFunc, 1, ACSVM_Environment_AddCallFunc(env, ACS_CF_PolyWait));
ACSVM_Environment_AddCodeDataACS0(env, 64, "W", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_PolyWait));
// 69 to 79: Implemented by ACSVM // 69 to 79: Implemented by ACSVM
// 81 to 82: Implemented by ACSVM // 81 to 82: Implemented by ACSVM
@ -66,13 +156,16 @@ static void ACS_EnvConstruct(ACSVM_Environment *env)
// 84 to 85: Implemented by ACSVM // 84 to 85: Implemented by ACSVM
ACSVM_Environment_AddCodeDataACS0(env, 86, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_EndPrint)); ACSVM_Environment_AddCodeDataACS0(env, 86, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_EndPrint));
// 87 to 89: Implemented by ACSVM // 87 to 89: Implemented by ACSVM
ACSVM_Environment_AddCodeDataACS0(env, 90, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_PlayerCount));
ACSVM_Environment_AddCodeDataACS0(env, 91, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_GameType));
ACSVM_Environment_AddCodeDataACS0(env, 92, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_GameSpeed));
ACSVM_Environment_AddCodeDataACS0(env, 93, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_Timer)); ACSVM_Environment_AddCodeDataACS0(env, 93, "", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_Timer));
// 136 to 137: Implemented by ACSVM // 136 to 137: Implemented by ACSVM
// 157: Implemented by ACSVM // 157: Implemented by ACSVM
// 167 to 173: Implemented by ACSVM // 167 to 173: Implemented by ACSVM
ACSVM_Environment_AddCodeDataACS0(env, 174, "BB", ACSVM_Code_CallFunc, 0, ACSVM_Environment_AddCallFunc(env, ACS_CF_Random));
// 175 to 179: Implemented by ACSVM // 175 to 179: Implemented by ACSVM
// 181 to 189: Implemented by ACSVM // 181 to 189: Implemented by ACSVM
@ -98,10 +191,25 @@ static void ACS_EnvConstruct(ACSVM_Environment *env)
// 363 to 380: Implemented by ACSVM // 363 to 380: Implemented by ACSVM
} }
/*--------------------------------------------------
static void ACS_EnvLoadModule(ACSVM_Environment *env, ACSVM_Module *module)
ACSVM Environment hook. Runs when a ACS
module is being loaded.
Input Arguments:-
env - The ACS environment data.
module - The ACS module being loaded.
Return:-
true when successful, otherwise false.
Returning false will also call the
ACS_EnvReadError hook.
--------------------------------------------------*/
static bool ACS_EnvLoadModule(ACSVM_Environment *env, ACSVM_Module *module) static bool ACS_EnvLoadModule(ACSVM_Environment *env, ACSVM_Module *module)
{ {
ACSVM_ModuleName name = {0}; ACSVM_ModuleName name = ACSVM_Module_GetName(module);
const char *str = NULL; const char *str = ACSVM_String_GetStr(name.s);
size_t lumpLen = 0; size_t lumpLen = 0;
@ -112,9 +220,6 @@ static bool ACS_EnvLoadModule(ACSVM_Environment *env, ACSVM_Module *module)
(void)env; (void)env;
ACSVM_Module_GetName(module, &name);
str = ACSVM_String_GetStr(name.s);
if (name.i == (size_t)LUMPERROR) if (name.i == (size_t)LUMPERROR)
{ {
// No lump given for module. // No lump given for module.
@ -171,6 +276,62 @@ static bool ACS_EnvLoadModule(ACSVM_Environment *env, ACSVM_Module *module)
return ret; return ret;
} }
/*--------------------------------------------------
static bool ACS_EnvCheckTag(ACSVM_Environment const *env, ACSVM_Word type, ACSVM_Word tag)
ACSVM Environment hook. Ran to determine
whenever or not a thread should still be
waiting on a tag movement.
See: TagWait, PolyWait.
Input Arguments:-
env - The ACS environment data.
type - The kind of level data we're waiting on. See also: acs_tagType_e.
tag - The tag of said level data.
Return:-
true when the tag is done moving and
execution can continue, or false to keep
the thread paused.
--------------------------------------------------*/
static bool ACS_EnvCheckTag(ACSVM_Environment const *env, ACSVM_Word type, ACSVM_Word tag)
{
(void)env;
switch (type)
{
case ACS_TAGTYPE_SECTOR:
{
INT32 secnum = -1;
TAG_ITER_SECTORS(tag, secnum)
{
sector_t *sec = &sectors[secnum];
if (sec->floordata != NULL || sec->ceilingdata != NULL)
{
return false;
}
}
return true;
}
case ACS_TAGTYPE_POLYOBJ:
{
const polyobj_t *po = Polyobj_GetForNum(tag);
return (po == NULL || po->thinker == NULL);
}
}
return true;
}
/*--------------------------------------------------
void ACS_Init(void)
See header file for description.
--------------------------------------------------*/
void ACS_Init(void) void ACS_Init(void)
{ {
// Initialize ACS on engine start-up. // Initialize ACS on engine start-up.
@ -178,14 +339,21 @@ void ACS_Init(void)
funcs.bad_alloc = ACS_EnvBadAlloc; funcs.bad_alloc = ACS_EnvBadAlloc;
funcs.readError = ACS_EnvReadError; funcs.readError = ACS_EnvReadError;
funcs.serialError = ACS_EnvSerialError;
funcs.ctor = ACS_EnvConstruct; funcs.ctor = ACS_EnvConstruct;
funcs.loadModule = ACS_EnvLoadModule; funcs.loadModule = ACS_EnvLoadModule;
funcs.checkTag = ACS_EnvCheckTag;
ACSenv = ACSVM_AllocEnvironment(&funcs, NULL); ACSenv = ACSVM_AllocEnvironment(&funcs, NULL);
I_AddExitFunc(ACS_Shutdown); I_AddExitFunc(ACS_Shutdown);
} }
/*--------------------------------------------------
void ACS_Shutdown(void)
See header file for description.
--------------------------------------------------*/
void ACS_Shutdown(void) void ACS_Shutdown(void)
{ {
// Delete ACS environment. // Delete ACS environment.
@ -193,18 +361,47 @@ void ACS_Shutdown(void)
ACSenv = NULL; ACSenv = NULL;
} }
/*--------------------------------------------------
static void ACS_ResetHub(ACSVM_GlobalScope *global)
Shortcut function to quickly free the
only hub scope Ring Racers uses.
Input Arguments:-
global - The global scope to free the hub from.
Return:-
N/A
--------------------------------------------------*/
static void ACS_ResetHub(ACSVM_GlobalScope *global) static void ACS_ResetHub(ACSVM_GlobalScope *global)
{ {
ACSVM_HubScope *hub = ACSVM_GlobalScope_GetHubScope(global, 0); ACSVM_HubScope *hub = ACSVM_GlobalScope_GetHubScope(global, 0);
ACSVM_GlobalScope_FreeHubScope(global, hub); ACSVM_GlobalScope_FreeHubScope(global, hub);
} }
/*--------------------------------------------------
static void ACS_ResetMap(ACSVM_HubScope *hub)
Shortcut function to quickly free the
only map scope Ring Racers uses.
Input Arguments:-
hub - The hub scope to free the map from.
Return:-
N/A
--------------------------------------------------*/
static void ACS_ResetMap(ACSVM_HubScope *hub) static void ACS_ResetMap(ACSVM_HubScope *hub)
{ {
ACSVM_MapScope *map = ACSVM_HubScope_GetMapScope(hub, 0); ACSVM_MapScope *map = ACSVM_HubScope_GetMapScope(hub, 0);
ACSVM_HubScope_FreeMapScope(hub, map); ACSVM_HubScope_FreeMapScope(hub, map);
} }
/*--------------------------------------------------
void ACS_LoadLevelScripts(size_t mapID)
See header file for description.
--------------------------------------------------*/
void ACS_LoadLevelScripts(size_t mapID) void ACS_LoadLevelScripts(size_t mapID)
{ {
ACSVM_Environment *env = ACSenv; ACSVM_Environment *env = ACSenv;
@ -234,7 +431,9 @@ void ACS_LoadLevelScripts(size_t mapID)
// a better language to do that kind of code). // a better language to do that kind of code).
// Since we literally only are using map scope, we can // Since we literally only are using map scope, we can
// just free everything between every level. // just free everything between every level. But if
// hubs are to be implemented, this logic would need
// to be far more sophisticated.
// Reset hub scope, even if we are not using it. // Reset hub scope, even if we are not using it.
ACS_ResetHub(global); ACS_ResetHub(global);
@ -280,6 +479,11 @@ void ACS_LoadLevelScripts(size_t mapID)
ACSVM_MapScope_ScriptStartType(map, 1, NULL, 0, NULL, NULL); ACSVM_MapScope_ScriptStartType(map, 1, NULL, 0, NULL, NULL);
} }
/*--------------------------------------------------
void ACS_Tick(void)
See header file for description.
--------------------------------------------------*/
void ACS_Tick(void) void ACS_Tick(void)
{ {
ACSVM_Environment *env = ACSenv; ACSVM_Environment *env = ACSenv;

View file

@ -1,5 +1,6 @@
// DR. ROBOTNIK'S RING RACERS // DR. ROBOTNIK'S RING RACERS
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Copyright (C) 2016 by James Haley, David Hill, et al. (Team Eternity)
// Copyright (C) 2022 by Sally "TehRealSalt" Cochenour // Copyright (C) 2022 by Sally "TehRealSalt" Cochenour
// Copyright (C) 2022 by Kart Krew // Copyright (C) 2022 by Kart Krew
// //
@ -32,14 +33,107 @@ typedef enum
ACS_ST_ENTER = 4, // ENTER: Runs when a player enters the game; both on start of the level, and when un-spectating. ACS_ST_ENTER = 4, // ENTER: Runs when a player enters the game; both on start of the level, and when un-spectating.
} acs_scriptType_e; } acs_scriptType_e;
typedef enum
{
ACS_TAGTYPE_POLYOBJ,
ACS_TAGTYPE_SECTOR,
} acs_tagType_e;
/*--------------------------------------------------
ACSVM_Environment *ACS_GetEnvironment(void);
Returns the global ACS environment. This contains
all of the information about the ACS VM state.
Input Arguments:-
None
Return:-
The ACS environment object.
--------------------------------------------------*/
ACSVM_Environment *ACS_GetEnvironment(void); ACSVM_Environment *ACS_GetEnvironment(void);
/*--------------------------------------------------
void ACS_Init(void);
Initializes the ACS environment. Handles creating
the VM, initializing its hooks, storing the
pointer for future reference, and adding the
shutdown function.
--------------------------------------------------*/
void ACS_Init(void); void ACS_Init(void);
/*--------------------------------------------------
void ACS_Shutdown(void);
Frees the ACS environment, for when the game
is exited.
--------------------------------------------------*/
void ACS_Shutdown(void); void ACS_Shutdown(void);
/*--------------------------------------------------
void ACS_LoadLevelScripts(size_t mapID);
Resets the ACS hub and map scopes to remove
existing running scripts, and inserts the new
level's ACS modules (BEHAVIOR lump) into
the environment.
Input Arguments:-
mapID: The map's number to read the BEHAVIOR
lump of.
Return:-
None
--------------------------------------------------*/
void ACS_LoadLevelScripts(size_t mapID); void ACS_LoadLevelScripts(size_t mapID);
/*--------------------------------------------------
void ACS_Tick(void);
Executes all of the ACS environment's
currently active threads.
--------------------------------------------------*/
void ACS_Tick(void); void ACS_Tick(void);
/*--------------------------------------------------
bool ACS_CF_???(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
These are the actual CallFuncs ran when ACS
is executed. Which CallFuncs are executed
is based on the indices from the compiled
data. ACS_EnvConstruct is where the link
between the byte code and the actual function
is made.
Input Arguments:-
thread: The ACS execution thread this action
is running on.
argV: An array of the action's arguments.
argC: The length of the argument array.
Return:-
Returns true if this function pauses the
thread's execution. Otherwise returns false.
--------------------------------------------------*/
bool ACS_CF_Random(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_TagWait(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_PolyWait(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_EndPrint(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC); bool ACS_CF_EndPrint(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_PlayerCount(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_GameType(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_GameSpeed(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
bool ACS_CF_Timer(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC); bool ACS_CF_Timer(ACSVM_Thread *thread, ACSVM_Word const *argV, ACSVM_Word argC);
#endif // __K_ACS__ #endif // __K_ACS__

View file

@ -37,6 +37,7 @@ typedef enum
// gameplay should be split up as much as possible. // gameplay should be split up as much as possible.
PR_EXECUTOR, // Linedef executor PR_EXECUTOR, // Linedef executor
PR_ACS, // ACS scripts
PR_DECORATION, // Generic decoration PR_DECORATION, // Generic decoration
PR_TERRAIN, // TERRAIN particles PR_TERRAIN, // TERRAIN particles