External Activations are functions that activate Actions and or Conditions in other scenes on output.
There are four possible arguments:
- <ChannelIndex> is a number describing a channel (one-based so the first output channel is 1).
- <ChannelName> is the text name of a output channel.
- <SceneName> is the text name of a scene
- <ActionName> is the text name of an action
All of these arguments support a wildcard (asterisk) in the following manner:
| * | This will match anything. So * could match any channel, any scene or any action depending on which argument it is utilized for. |
| *Text | This will match any value that starts with "Text" |
| Text* |
This will match any value that starts with "Text" |
| *Text* | This will match any value that contains "Text" somewhere other than the start or end. |
You cannot use the wildcard like this: *Text1*Text2*
Supported External Activation Usage for Actions or Conditions:
- ActionName: This will match any action with the provided name regardless of which scene contains it; only scenes on the same channel as the scene causing this trigger will be affected. This is consistent with the original External Activation implementation.
- SceneName.ActionName: This will match any action with the provided name in a specific scene, but only on the same channel as the scene causing this trigger. This is also consistent with the original External Activation implementation.
- ChannelIndex.SceneName.ActionName: This will match any action with the provided name in the designated scene, but only on the channel indicated by the provided index.
- ChannelName.SceneName.ActionName: This will match any action with the provided name in the designated scene, but only on the channel indicated by the provided name.
The same format exists to execute Conditions:
- ConditionName
- Scene.ConditionName
- Channel.Scene.ConditionName
Actual Usage Examples
Imagine the following scenario.
- Two output channels: "Output1" and "Output2"
- Two scenes: "FirstNames" and "LastNames"
- FirstNames has an action named "SlideOn" and "SlideOff"
- LastNames has an action named "DissolveOn" and "DissolveOff"
- Play both scenes to both outputs
Now for extreme examples:
- SlideOn
- If triggered from a scene on Output1, this will play action FirstNames.SlideOn.
- If triggered from a scene on Output2, no actions will be played.
- If triggered from a scene on Output1, this will play action FirstNames.SlideOn.
- FirstNames.SlideOn
- If triggered from a scene on Output1, this will play action FirstNames.SlideOn
- If triggered from a scene on Output 2, no actions will be played.
- *.*On
- If triggered from a scene on Output1, this will play action FirstNames.SlideOn and LastNames.DissolveOn.
- If triggered from a scene on Output 2, no actions will be played.
- 1.FirstNames.SlideOn
- Regardless of which scene activated this trigger, this will play action FirstNames.SlideOn on Output1.
- 2.LastNames.DissolveOn
- Regardless of which scene activated this trigger, this will play action LastNames.DissolveOn on Output2.
- 2.*.*On
- Regardless of which scene activated this trigger, this will play FirstNames.SlideOn and LastNames.DissolveOn on Output2.
- *.FirstNames.SlideOn
- Regardless of which scene activated this trigger, this will play FirstNames.SlideOn on both Output1 and Output2.
- *.*.*On
- Regardless of which scene activated this trigger, this will play actions FirstNames.SlideOn, LastNames.DissolveOn on Output1 and FirstNames.SlideOn, LastNames.DissolveOn on Output2.
- Output2.FirstNames.SlideOn
- Regardless of which scene activated this trigger, this will play FirstNames.SlideOn on Output2.
- Output*.FirstNames.SlideOn
- Regardless of which scene activated this trigger, this will play FirstNames.SlideOn on both Output1 and Output2.