How to Use Track Triggers

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Creating a Trigger Event)
(major addendum)
Line 25: Line 25:
 
</table>
 
</table>
  
*'''Configuring a Trigger'''
+
==='''Configuring a Trigger'''===
  
 
As soon as a new trigger has been placed, its properties window will open on the screen. It will be given a default name and assigned to the currently active layer.
 
As soon as a new trigger has been placed, its properties window will open on the screen. It will be given a default name and assigned to the currently active layer.
Line 68: Line 68:
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:EditSessionWindowX.JPG]]</td>
+
<td rowspan="2">[[file:EditSessionWindowX.JPG]]</td>
<td>Click the '''Add''' button.
+
<td>Click the '''Add''' button then scroll down to select the '''Trigger Check''' rule then click the '''Tick''' icon.
 
</td>
 
</td>
</table>
+
</tr>
<table>
+
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[file:RuleSelect.JPG]]</td>
 
<td>[[file:RuleSelect.JPG]]</td>
<td> Scroll down to select the '''Trigger Check''' rule then click the '''Tick''' icon. This will add the '''Trigger Check''' rule to the session.
 
</td>
 
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
This will add the '''Trigger Check''' rule to the session.
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
Line 87: Line 84:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
For this example we will leave all settings unchanged and simply identify the trigger to be used.
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerCheckProperties.JPG]]</td>
+
<td rowspan="2">[[file:TriggerCheckProperties.JPG]]</td>
<td>For this example we will leave all settings unchanged and simply identify the trigger to be used. Click the '''''Add trigger''''' link.
+
<td>Click the '''''Add trigger''''' link and select the trigger you have previously added.<br>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:TriggerList.JPG]]
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
<br>Click the '''Tick''' icon on the selection list and again on the '''Trigger Check''' properties window.<br><br>
 +
 +
To test your trigger event you will need to add a rule to the Trigger Check. When you are back in the '''Session Editor''' window, click the '''Add''' button to add a new rule.
  
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerList.JPG]]</td>
+
<td rowspan="2">[[file:TriggerAddMesPopup.JPG]]</td>
<td>Select the trigger you have previously added. Click the '''Tick''' icon on the selection list and again on the '''Trigger Check''' properties window.
+
<td><br>Scroll down the rule selection window to select the '''Message Popup''' rule and click the '''Tick''' icon.
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:MessagePopupAdded.JPG]]<br>
 +
The '''Message Popup''' rule should now appear directly below the '''Trigger Check''' rule. The new rule will show a red cross because it has not yet been configured.
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
To test your trigger event you will need to add a rule to the Trigger Check. When you are back in the '''Session Editor''' window, click the ''Add''' button to add a new rule.
+
The '''Message Popup Rule''' has to be ''indented'' so that it becomes a ''Child'' of the '''Trigger Check Rule'''.  
  
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerAddMesPopup.JPG]]</td>
+
<td rowspan="2">[[file:SessionRuleIndent.JPG]]</td>
<td>Scroll down the rule selection window to select the '''Message Popup''' rule and click the '''Tick''' icon.
+
<td><br>With the '''Message Popup Rule''' highlighted, click the '''''Indent''''' (''right arrow'') button.
 
</td>
 
</td>
 
</tr>
 
</tr>
 +
<tr>
 +
<td>[[file:SessionRuleIndented.JPG]]
 +
</td>
 +
</tr>
 +
</table>
 +
 +
<br>The '''Message Popup Rule''' is now controlled by the '''Trigger Check Rule''' but it still has to be configured to show a message.
 +
 +
<br>
 +
With the '''Message Popup Rule''' highlighted, click the '''Edit''' button.
 +
 +
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:MessagePopupAdded.JPG]]</td>
+
<td rowspan="2">[[file:MessagePopupText.JPG]]</td>
<td>The '''Message Popup''' rule should now appear directly below the '''Trigger Check''' rule. The new rule will show a red cross because it has not yet been configured.
+
<td><br>Set the properties as shown:-
 +
*Check'''ON''' ''Close previous message popup windows''
 +
*Select '''Option Button''' ''Custom text''
 +
*Enter a short text message (you are limited to about 6 lines of text)
 +
<br>
 +
To add an icon to the message:-
 +
*Click the link ''click here to set'' and either scroll down the list to find a suitable icon (some will not be suitable) or simply type "icon stop" in the text box then click the '''Tick''' icon.<br>
 +
[[file:IconStop.JPG]]
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:MessagePopupStop.JPG]]</td>
 +
<td>
 +
</td></tr>
 +
</table>
 +
<br>
 +
Again, click the '''Tick''' icon to exit the '''Message Popup Rule''' then exit the Session Editor.<br>
 +
 +
Add a consist to your layout a short distance from the trigger (but further away than its radius), save the surveyor session, and then test in '''Driver Mode'''.
 +
 +
Another example of using the '''Trigger Check Rule''' can be found in the '''Message Popup Rule Applications''' link below.
  
 
==='''Related Trainz Wiki Links:'''===
 
==='''Related Trainz Wiki Links:'''===

Revision as of 21:27, 20 May 2018

Contents

What are Triggers?

Triggers are invisible markers (invisible in Driver Mode but visible in Surveyor Mode) that are placed on a track. They can be programmed to "trigger an event" when a train (any train or a specific train) passes over them in Driver Mode.

The "event" is a message that is transmitted by the trigger to certain Session Rules that have been programmed to "listen" for the message. When one of those listening rules detects the message, it can be forced into action by executing preset instructions.

TrackTrigger.JPG A Track Trigger in place on a track visible in Surveyor Mode. The "5.00m" is the trigger detection radius

Adding a Trigger

The Track Trigger is placed on the track using the Tracks tool and Trackmark Mode.

TrackTriggerMode.JPG The Trigger Object is selected from the list of installed objects then the Add Object button is clicked followed by clicking the track position where the trigger is to be placed.

Configuring a Trigger

As soon as a new trigger has been placed, its properties window will open on the screen. It will be given a default name and assigned to the currently active layer.

TrackTriggerProperties.JPG
  • To change the assigned layer click on the layer box and select a new layer.
  • To change the trigger name click on the default name and enter a new name.
  • To confirm the changes click on the Tick icon on the bottom right of the window.

Triggers have a "detection radius" that controls how close a train has to approach to trigger the event. The smaller the radius the closer the train. This radius is set in the Advanced Properties section of the Tools window.

TrackTriggerRadius.JPG Click the Advanced Tab to open its properties. Enter a new radius value in metres, click the Set Trigger Radius button then click on the trigger that has been placed on the track.

Creating a Trigger Event

Trigger events are handled by the Trigger Check Rule which is added to a session in the Session Editor.

EditSessionMenu.JPG Open the Session Editor from the Surveyor Main Menu.

Select the option Edit Session from the drop down menu list.

EditSessionWindowX.JPG Click the Add button then scroll down to select the Trigger Check rule then click the Tick icon.
RuleSelect.JPG

This will add the Trigger Check rule to the session.

TriggerCheck.JPG With the Trigger Check rule highlighted, click the Edit button. This will open its properties window.

For this example we will leave all settings unchanged and simply identify the trigger to be used.

TriggerCheckProperties.JPG Click the Add trigger link and select the trigger you have previously added.
TriggerList.JPG


Click the Tick icon on the selection list and again on the Trigger Check properties window.

To test your trigger event you will need to add a rule to the Trigger Check. When you are back in the Session Editor window, click the Add button to add a new rule.

TriggerAddMesPopup.JPG
Scroll down the rule selection window to select the Message Popup rule and click the Tick icon.
MessagePopupAdded.JPG

The Message Popup rule should now appear directly below the Trigger Check rule. The new rule will show a red cross because it has not yet been configured.

The Message Popup Rule has to be indented so that it becomes a Child of the Trigger Check Rule.

SessionRuleIndent.JPG
With the Message Popup Rule highlighted, click the Indent (right arrow) button.
SessionRuleIndented.JPG


The Message Popup Rule is now controlled by the Trigger Check Rule but it still has to be configured to show a message.


With the Message Popup Rule highlighted, click the Edit button.

MessagePopupText.JPG
Set the properties as shown:-
  • CheckON Close previous message popup windows
  • Select Option Button Custom text
  • Enter a short text message (you are limited to about 6 lines of text)


To add an icon to the message:-

  • Click the link click here to set and either scroll down the list to find a suitable icon (some will not be suitable) or simply type "icon stop" in the text box then click the Tick icon.

IconStop.JPG

MessagePopupStop.JPG


Again, click the Tick icon to exit the Message Popup Rule then exit the Session Editor.

Add a consist to your layout a short distance from the trigger (but further away than its radius), save the surveyor session, and then test in Driver Mode.

Another example of using the Trigger Check Rule can be found in the Message Popup Rule Applications link below.

Related Trainz Wiki Links:

Personal tools