ACS_NamedExecute

From ZDoom Wiki
Jump to navigation Jump to search

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_Execute ACS_NamedExecute
ACS_ExecuteWait ACS_NamedExecuteWait
ACS_ExecuteAlways ACS_NamedExecuteAlways
ACS_ExecuteWithResult ACS_NamedExecuteWithResult
ACS_LockedExecute ACS_NamedLockedExecute
ACS_LockedExecuteDoor ACS_NamedLockedExecuteDoor
ACS_Suspend ACS_NamedSuspend
ACS_Terminate ACS_NamedTerminate
ScriptWait NamedScriptWait
FS_Execute UsePuzzleItem