Exibir código-fonte para ACS ExecuteWait

void '''ACS_ExecuteWait''' (int ''script'', int ''unused'', int ''arg1'', int ''arg2'', int ''arg3'');

== Usage ==

Using '''ACS_ExecuteWait''' is exactly equivalent to the following two commands:

 [[ACS_Execute]] (script, 0, arg1, arg2, arg3);
 [[ScriptWait]] (script);

Note that where you would specify a map number with [[ACS_Execute]], you must specify 0 here because you can only wait on scripts in the current map.

=== Parameters ===

*''script'': The script number to execute.
*''unused'': Not currently used. Should always be set to 0.
*''arg1'': First argument passed to the script.
*''arg2'': Second argument passed to the script.
*''arg3'': Third argument passed to the script.

==Examples==

This function is rather uncommon, but does have its uses. A common use would be to wait on a scripted event. For example, if there were some sort of event or challenge that used a script at various points in the level, and at one point the player had to complete the event as part of another script, this command can be used rather than copying the challenge script twice. To elaborate, here is a script.

 script 15 (int armytid, int sector)
 {
     [[Print]] (s:"Defeat the monsters for a prize!");
 
     [[ACS_ExecuteWait]] (5, 0, armytid, 0, 0);
 
     [[Ceiling_RaiseByValue]] (sector, 10, 64);
 }

This script tells the player to defeat the monsters for a prize. Then it executes script 5 which could be script 5 as used [[ThingCount|here]]. After the success of script 5, a ceiling is raised, supposedly to reveal a prize. As this script can be used elsewhere, script 15 is like a wrapper for script 5 which offers a prize.

{{script functions}}
[[category:ACS Wait functions]]
{{DISPLAYTITLE:ACS_ExecuteWait}}