Working with Triggers: Trigger Init, RunTrigger

Working with Triggers

Trigger Init

The trigger named [Init] is the basic trigger activated when a mission is launched and it is usually used to launch other triggers and initialize global variables

Example:

[Init]

Set @@num = 0

RunTrigger ( 'xxx" )

Halt

RunTrigger

Launches the specified trigger asynchronously. This means that both the calling trigger and the called trigger continue to work independently of each other. The called trigger may return its results repeatedly to the calling trigger through the call parameters.

Syntax:

RunTrigger ( "TriggerName

"Trigger Name" - name of the trigger to be launched asynchronously.

Example:

[Init]

Set @@num = 0

RunTrigger ( 'Trigger" )

// Launches the trigger named Trigger

Halt

[Trigger]

Set @@num = 0

Halt

CallTrigger

Launches the specified synchronous trigger and the calling trigger waits until the called trigger ends. The called trigger may return its results to the calling trigger through the call parameters.

Syntax:

CallTrigger ( "TriggerName

"Trigger Name" - name of the trigger to be launched in a synchronous manner

CallTriggerInstance

Launches the specified synchronous trigger with the unique name "TriggerName#InstanceName" and with its local variables. In this case the trigger TriggerName must be present in the trigger.ini file. The called trigger waits until the called one ends. The called trigger may return its results to the calling trigger through the call parameters.

Syntax:

CallTrigger ( "TriggerName" , <InstanceName>

"Trigger Name" - name of the template trigger to be launched in a synchronous manner

<InstanceName> - named indicator of the trigger

RunTriggerInstance

Generates the trigger with the unique name "TriggerName#InstanceName" and with its local variables and launches it asynchronously. In this case the trigger TriggerName must be present in the trigger.ini file. The called trigger may return its results repeatedly to the calling trigger through the call parameters.

Syntax:

RunTriggerInstance ( <TriggerName> , <InstanceName>

<TriggerName> - name of the template trigger to be launched in an asynchronous manner

<InstanceName> - named indicator of the trigger

DestroyTrigger

Destroys the specified trigger

Syntax:

DestroyTrigger ( "TriggerName

"TriggerName - name of the trigger to be destroyed

Example:

[Init]

Set @@num = 0

RunTrigger ( 'Trigger" )

// the trigger named Trigger will be stopped and destroyed

Halt

DestroyTriggerInstance

Destroys the trigger with the unique name "TriggerName#InstanceName" and with its local variables

Syntax:

DestroyTriggerInstance ( <TriggerName> , <InstanceName>