ACS_NamedExecute

bool ACS_NamedExecute (string script, int map, int s_arg1, int s_arg2, int s_arg3)
ACS_NamedExecute (string script, int map, int s_arg1, int s_arg2, int s_arg3)

Usage

Variant of ACS_Execute for named scripts.

There is both an ACS and a DECORATE version of this function. Both behave identically.

However, it is not available as an action special: to call named scripts from a a line or thing special, you have to use the non-named variant (ACS_Execute) in UDMF, with the arg0str custom argument set to the name of the script this will override the first parameter.

Parameters

  • script: Name of the script to execute
  • map: Map which contains the script
  • s_arg1: First argument passed to the script
  • s_arg2: Second argument passed to the script
  • s_arg3: Third argument passed to the script

Return value

Returns true if the script could be executed successfully, false otherwise. Deferred scripts are always considered successful.

Examples

Execute a script named GollyFluff.

 script "PinFeathers" (void)
 {
     ACS_NamedExecute("GollyFluff", 0);
 }
 
 script "GollyFluff" (void)
 {
     print(s:"Golly Fluff!");
 }
Script functions
ACS_ExecuteACS_NamedExecute
ACS_ExecuteWaitACS_NamedExecuteWait
ACS_ExecuteAlwaysACS_NamedExecuteAlways
ACS_ExecuteWithResultACS_NamedExecuteWithResult
ACS_LockedExecuteACS_NamedLockedExecute
ACS_LockedExecuteDoorACS_NamedLockedExecuteDoor
ACS_SuspendACS_NamedSuspend
ACS_TerminateACS_NamedTerminate
ScriptWaitNamedScriptWait
FS_ExecuteUsePuzzleItem
This article is issued from Zdoom. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.