Overview
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:
Description | |
* | 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 ends in "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. |
Note: 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
Rare/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.
- 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.