How to Use Track Triggers

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (What are Track Triggers?)
m (Related Links)
(28 intermediate revisions by one user not shown)
Line 1: Line 1:
 +
The information in this Wiki Page applies to '''TANE''', '''TRS19''' and '''Trainz Plus'''.
 +
 +
__TOC__
 
='''What are Track Triggers?'''=
 
='''What are Track Triggers?'''=
 
<table cellpadding="4" bgcolor=#c1e7e7>
 
<table cellpadding="4" bgcolor=#c1e7e7>
 
<tr>
 
<tr>
<td>[[file:DotPoint.JPG]]</td>
+
<td>[[file:DotPoint.JPG|link=]]</td>
<td>'''Track triggers are track markers that are invisible in ''Driver Mode'' but visible in ''Surveyor Mode''.''' They are used to activate '''Session Rules'''.</td>
+
<td>'''Track triggers are track markers that are invisible in ''Driver Mode'' but visible in ''Surveyor Mode''.''' They are used to activate '''Session Rules''' and some '''Driver Commands'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
Track triggers can be programmed to respond when a train (any train or a specific train) passes over them in Driver Mode. The response comes from executing a set of '''Session Rules''' that have been attached to a [[file:WikiLink.PNG]] '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' (or a similar rule) or a '''Driver Command''' that is monitoring the track trigger.  
+
Track triggers can be programmed to respond when a train (any train or a specific train) passes over them in Driver Mode. The response comes from executing a set of '''Session Rules''' that have been attached to a [[file:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' (or a similar rule) or a '''Driver Command''' that is monitoring the track trigger.  
  
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTrigger.JPG]]</td>
+
<td>[[file:TrackTrigger.JPG|link=]]</td>
 
<td><br>
 
<td><br>
 
Shown at left is a '''Track Trigger''' placed on a track in '''Surveyor Mode'''. It is NOT visible in '''Driver Mode'''. The "5.00m" shown below the trigger name is the trigger detection radius
 
Shown at left is a '''Track Trigger''' placed on a track in '''Surveyor Mode'''. It is NOT visible in '''Driver Mode'''. The "5.00m" shown below the trigger name is the trigger detection radius
Line 17: Line 20:
 
</table>
 
</table>
 
<br>
 
<br>
 +
 +
='''Route or Session?'''=
 +
 +
<table cellpadding="4" bgcolor=#c1e7e7>
 +
<tr valign="top">
 +
<td>[[file:DotPoint.JPG|link=]]</td>
 +
<td>'''Track Triggers can be placed in a Route layer or in a Session layer'''</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding="4" bgcolor=#ffffb0>
 +
<tr valign="top">
 +
<td>[[file:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
*Placing Track Triggers in a '''Route layer''' (e.g. in the same layer as the track) means that they will be available in '''all Sessions''' created using that particular Route.
 +
*Placing Track Triggers in a '''Session layer''' means that they will only be available in that Session. This can be useful if two or more Sessions are being created and you want to use different Track Triggers in each Session.</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding="4" bgcolor="Aquamarine">
 +
<tr valign="top">
 +
<td>[[file:LinkWiki.PNG|link=]]</td>
 +
<td>Information on Route and Session layers can be found at:-<br>
 +
* '''[[How to Use Layers]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
 +
<table width="100%">
 +
<tr valign="top">
 +
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
</tr>
 +
</table>
  
 
='''Adding a Track Trigger'''=
 
='''Adding a Track Trigger'''=
Line 22: Line 58:
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTriggerMode.JPG]]</td>
+
<td>[[file:TrackTriggerMode.JPG|link=]]</td>
 
<td><br>
 
<td><br>
 
<table cellpadding="4" bgcolor=#ffffff>
 
<table cellpadding="4" bgcolor=#ffffff>
Line 30: Line 66:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>[[file:Steps.PNG|link=]]</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td><span style="font-size: 17px;">'''Steps:'''</span><br>
 
A '''Track Trigger''' is placed on the track by:-
 
A '''Track Trigger''' is placed on the track by:-
 
#clicking the '''Track''' tool,
 
#clicking the '''Track''' tool,
Line 47: Line 83:
 
</table>
 
</table>
 
<br>
 
<br>
 +
<table width="100%">
 +
<tr valign="top">
 +
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
</tr>
 +
</table>
  
 
='''Configuring a Track Trigger'''=
 
='''Configuring a Track Trigger'''=
  
As soon as a new track trigger has been placed, its properties window (shown below) will open on the screen. It will be given a default name and assigned to the currently active layer.
+
As soon as a new track 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.
  
<table>
+
<table cellpadding="4" bgcolor=#ffffff> <!-- BEGIN Step table -->
<tr valign="top">
+
<td>[[file:TrackTriggerProperties.JPG]]</td>
+
<td>
+
<table cellpadding="4" bgcolor=#ffffff>
+
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
Line 62: Line 99:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>[[file:Steps.PNG|link=]]<br><br>
<td><font size="3">'''Steps:'''</font><br>
+
<span style="font-size: 17px; font-weight: 700;">Steps</span></td>
*To change the track trigger name click on the name box, delete the highlighted default name and enter a new name.
+
<td>[[file:DotPoint1.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Name the Trigger:</span><br>
*To change the assigned layer click on the layer box and select a new layer.
+
<table> <!-- BEGIN Step 1 table -->
*Leave the "Bound Layer" at ''<none>''. (See the Trainz Wiki page [[file:WikiLink.PNG]] '''[[How to Use Layers|Using Layers]]''' for information on layers).
+
<tr valign="top">
*To confirm the changes click on the [[file:Tick.PNG]] icon on the bottom right of the window.</td>
+
<td>[[file:TrackTriggerProperties.JPG|link=]]</td>
 +
<td>
 +
*To change the track trigger name click on the name box, delete the highlighted default name and enter a new name
 +
*To change the assigned layer click on the layer box and select a new layer
 +
*Leave the "Bound Layer" at ''<none>''. (See the '''Trainz Wiki Page''' [[file:WikiLink.PNG|link=]] '''[[How to Use Layers|Using Layers]]''' for information on layers)
 +
*To confirm the changes click on the [[file:Tick.PNG|link=]] icon on the bottom right of the window
 +
</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
Line 73: Line 116:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table></td>
+
</table> <!-- END Step 1 table -->
 +
</td>
 
</tr>
 
</tr>
</table>
 
 
Track 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 has to be to the track trigger to be detected. This radius is set in the '''Advanced Properties''' section of the '''Tools''' window (shown below).
 
 
<table>
 
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTriggerRadius.JPG]]</td>
+
<td>&nbsp;</td>
<td><br>
+
<td>[[file:DotPoint2.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">(Optional) Set the Trigger Detection Radius:</span><br>
<table cellpadding="4" bgcolor=#ffffff>
+
<table> <!-- BEGIN Step 2 table -->
 +
<tr valign="top">
 +
<td colspan=2>Track triggers have a "detection radius" that controls how close a train has to approach to trigger the event. The default radius is 20 metres. The smaller the radius the closer the train has to be to the track trigger to be detected. This radius is set in the '''Advanced Properties''' section of the '''Tools''' window (shown below).</td>
 
<tr>
 
<tr>
<td colspan="2">
 
----</td>
 
</tr>
 
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td width=340>[[file:TrackTriggerRadius.JPG|link=]]</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>
#Click the '''Advanced Tab''' to open its properties.
+
#Click the '''Advanced Tab''' to open its properties
#Enter a new radius value in metres.
+
#Enter a new radius value in metres
 
#Click the '''Set Trigger Radius''' button
 
#Click the '''Set Trigger Radius''' button
#Click on the track trigger to assign its new radius.
+
#Click on the track trigger to assign its new radius
 +
<br>
 +
<table cellpadding="4" bgcolor=#ffffb0> <!-- BEGIN Step 2 Tip Table -->
 +
<tr valign="top">
 +
<td>[[file:PencilTips.PNG|link=]]</td>
 +
<td>A small radius should only be used for slower moving trains. Short fast trains may pass over a small radius track trigger without being detected.</td>
 +
</tr>
 +
</table> <!-- END Step 2 Tip Table -->
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 101: Line 146:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Step 2 table -->
<br>
+
</td>
<table cellpadding="4" bgcolor=#ffffb0>
+
</tr>
 +
</table> <!-- END Steps Table -->
 +
<table width="100%"> <!-- BEGIN Back-To-Top Table -->
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:PencilTips.PNG]]</td>
+
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
<td>A small radius should only be used for slower moving trains. Short fast trains may pass over a small radius track trigger without being detected.</td>
+
 
</tr>
 
</tr>
</table></td>
+
</table> <!-- END Back-To-Top Table -->
</tr>
+
</table>
+
<br>
+
  
 
='''Creating a Track Trigger Event'''=
 
='''Creating a Track Trigger Event'''=
  
Track trigger events are handled by the '''Trigger Check Rule''' (or a similar rule) which is added to a Session in the '''Session Editor'''.<br>
+
Track trigger events are handled by the '''Trigger Check Rule''' (or a similar rule) which is added to a Session in the [[file:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]'''.<br>
  
The Trainz Wiki Link [[file:WikiLink.PNG]] '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' contains detailed information on this rule.
+
<table cellpadding="4" bgcolor="Aquamarine">
 
+
<table>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:EditSessionMenu.JPG]]</td>
+
<td>[[file:LinkWiki.PNG|link=]]</td>
<td><br>
+
<td>
<table cellpadding="4" bgcolor=#ffffff>
+
More information on the '''Trigger Check Rule''' can be found on the '''Trainz Wiki Rules Page''' at:-<br>
 +
* '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]'''<br>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding="4" bgcolor=#ffffff> <!-- BEGIN Step table -->
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
Line 129: Line 176:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>[[file:Steps.PNG|link=]]<br><br>
<td><font size="3">'''Steps:'''</font><br>
+
<span style="font-size: 17px; font-weight: 700;">Steps</span></td>
 +
<td>[[file:DotPoint1.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Open the Session Editor:</span><br>
 +
<table> <!-- BEGIN Step 1 table -->
 +
<tr valign="top">
 +
<td colspan=2>
 
To add the '''Trigger Check Rule''' to a session:-
 
To add the '''Trigger Check Rule''' to a session:-
#Open the '''Surveyor Main Menu'''.
+
#Open the '''Surveyor Main Menu''' in '''TANE''' (shown below left) or the '''Surveyor Edit Menu''' in '''TRS19''' and '''Trainz Plus''' (shown below right)
#Select the option '''Edit Session''' from the drop down menu list.</td>
+
#Select the option '''Edit Session''' from the drop down menu list
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:EditSessionMenu.JPG|link=]]</td>
 +
<td>[[file:SessionEditMenuSP1.png|link=]]<br>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
Line 139: Line 195:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table></td>
+
</table> <!-- END Step 1 table -->
 +
</td>
 
</tr>
 
</tr>
</table>
 
<table>
 
 
<tr valign="top">
 
<tr valign="top">
<td rowspan="2">[[file:EditSessionWindowX.JPG]]</td>
+
<td>&nbsp;</td>
<td><br>
+
<td>[[file:DotPoint2.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Add the Trigger Check Rule:</span><br>
<table cellpadding="4" bgcolor=#ffffff>
+
<table> <!-- BEGIN Step 2 table -->
<tr>
+
<td colspan="2">
+
----</td>
+
</tr>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>In the Edit Session window (shown below left):-
<td><font size="3">'''Steps:'''</font><br>
+
In the Edit Session window (shown left):-
+
 
*Click the '''Add''' button
 
*Click the '''Add''' button
In the Rule Selection window (shown below):-
+
</td>
#Scroll down the list to select the '''Trigger Check''' rule
+
<td>
#Click on the [[file:Tick.PNG]] icon</td>
+
In the Rule Selection window (shown below right):-
 +
:#Scroll down the list to select the '''Trigger Check''' rule
 +
:#Click on the [[file:Tick.PNG|link=]] icon
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=490>[[file:EditSessionWindowX.JPG|link=|480px]]</td>
 +
<td>[[file:RuleSelect.JPG|link=]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td colspan="2">
+
<td colspan=2><br>This will add the '''Trigger Check''' rule to the session.</td>
 +
</tr>
 +
<tr>
 +
<td colspan=2>
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table></td>
+
</table> <!-- END Step 2 table -->
 +
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:RuleSelect.JPG]]</td>
+
<td>&nbsp;</td>
 +
<td>[[file:DotPoint3.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Open the Trigger Check Rule Properties:</span><br>
 +
<table> <!-- BEGIN Step 3 table -->
 +
<tr valign="top">
 +
<td>With the '''Trigger Check''' rule highlighted (shown below):-
 +
*Click the '''Edit''' button. This will open the rule properties window
 +
</td>
 
</tr>
 
</tr>
</table>
 
<br>
 
This will add the '''Trigger Check''' rule to the session.
 
<table>
 
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerCheck.JPG]]</td>
+
<td>[[file:TriggerCheck.JPG|link=]]</td>
<td><br>
+
</tr>
<table cellpadding="4" bgcolor=#ffffff>
+
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
 
----</td>
 
----</td>
 +
</tr>
 +
</table> <!-- END Step 3 table -->
 +
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>&nbsp;</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>[[file:DotPoint4.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Configure the Rule:</span><br>
With the '''Trigger Check''' rule highlighted (shown left):-
+
<table> <!-- BEGIN Step 4 table -->
*Click the '''Edit''' button. This will open its properties window.</td>
+
<tr valign="top">
 +
<td colspan=2>For this example we will leave all settings unchanged and simply identify the track trigger to be used.<br>
 +
In the Trigger Properties window (shown below):-
 +
*Click the '''''<span style="text-decoration: underline;">Add trigger</span>''''' link
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:TriggerCheckProperties.JPG|link=]]</td>
 +
<td>
 +
</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td colspan="2">
+
<td>
----</td>
+
<table cellpadding="4" bgcolor="Aquamarine"> <!-- BEGIN Table 4 Wiki Table -->
 +
<tr valign="top">
 +
<td>[[file:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
More information on the settings and options in this rule can be found on the '''Trainz Wiki Rules Page''' at:-<br>
 +
* '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]'''<br>
 +
</td>
 
</tr>
 
</tr>
</table></td>
+
</table> <!-- END Table 4 Wiki Table -->
 +
</td>
 
</tr>
 
</tr>
</table>
 
<br>
 
For this example we will leave all settings unchanged and simply identify the track trigger to be used.
 
<table>
 
<tr valign="top">
 
<td rowspan="2" width="640">[[file:TriggerCheckProperties.JPG]]<br>
 
<br>
 
Once the trigger has been identified, click on the [[file:Tick.PNG]] icon in the '''Trigger Check''' properties window (shown above) to accept the change.</td>
 
<td><br>
 
<table cellpadding="4" bgcolor=#ffffff>
 
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
 +
</table> <!-- END Step 4 table -->
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>&nbsp;</td>
 +
<td>[[file:DotPoint5.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Select the Trigger:</span><br>
 +
<table> <!-- BEGIN Step 5 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>The '''Trigger Selection Window''' will list all the '''Track Triggers''' in your layout.
<td><font size="3">'''Steps:'''</font><br>
+
In the Trigger Properties window (shown left):-
+
*Click the '''''<u>Add trigger</u>''''' link
+
In the Trigger Selection window (shown below):-
+
 
#Select the trigger you have just added
 
#Select the trigger you have just added
#Click on the [[file:Tick.PNG]] icon on the selection list</td>
+
#Click on the [[file:Tick.PNG|link=]] icon at the bottom of the selection window
 +
</td>
 
</tr>
 
</tr>
 +
<tr valign="top">
 +
<td>[[file:TriggerList.JPG|link=]]</td>
 +
</tr>
 +
<tr>
 +
<td>Once the trigger has been added to the rule, click on the [[file:Tick.PNG|link=]] icon in the '''Trigger Check''' properties window to accept the change.
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table></td>
+
</table> <!-- END Step 5 table -->
 +
</td>
 
</tr>
 
</tr>
 +
</table> <!-- END Step Table -->
 +
<table width="100%"> <!-- BEGIN Back-To-Top Table -->
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerList.JPG]]
+
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
</td>
+
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Back-To-Top Table -->
<br>
+
  
 
='''Adding an Instruction to the Trigger Event'''=
 
='''Adding an Instruction to the Trigger Event'''=
Line 234: Line 314:
 
==Adding a Child Rule==
 
==Adding a Child Rule==
  
<table>
+
<table cellpadding="4" bgcolor=#ffffff> <!-- BEGIN Step table -->
 
<tr valign="top">
 
<tr valign="top">
<td rowspan="2">[[file:TriggerAddMesPopup.JPG]]</td>
+
<td>[[file:Steps.PNG|link=]]<br><br>
<td>
+
<span style="font-size: 17px; font-weight: 700;">Steps</span></td>
<table cellpadding="4" bgcolor=#ffffff>
+
<td>[[file:DotPoint1.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Add A Message Popup Rule:</span><br>
<tr>
+
<table> <!-- BEGIN Step 1 table -->
<td colspan="2">
+
----</td>
+
</tr>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>When you are back in the '''Session Editor''' window:-
<td><font size="3">'''Steps:'''</font><br>
+
#Make sure that the new '''Trigger Check Rule''' is selected (highlighted)
When you are back in the '''Session Editor''' window:-
+
#Click the '''Add''' button to add another new rule
#Click the '''Add''' button to add a new rule
+
 
#Scroll down the rule selection window to find and select the '''Message Popup''' rule
 
#Scroll down the rule selection window to find and select the '''Message Popup''' rule
#Click on the [[file:Tick.PNG]] icon</td>
+
#Click on the [[file:Tick.PNG|link=]] icon
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:TriggerAddMesPopup.JPG|link=]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td colspan="2">
+
<td>The '''Message Popup Rule''' should now appear directly below the '''Trigger Check''' rule. It will display a red cross because it has not yet been configured.
----</td>
+
</td>
 
</tr>
 
</tr>
</table></td>
 
</tr>
 
</table>
 
The '''Message Popup Rule''' should now appear directly below the '''Trigger Check''' rule. It will display a red cross because it has not yet been configured.<br>
 
 
The '''Message Popup Rule''' has to be ''indented'' so that it becomes a ''Child'' of the '''Trigger Check Rule''' and is controlled by that rule.
 
<br>
 
<table>
 
<tr valign="top">
 
<td rowspan="2" width="640">[[file:SessionRuleIndent.JPG]]
 
<br>
 
This '''Message Popup Rule''' is now a '''Child Rule''' of the '''Trigger Check Rule''' and will only be executed ''after'' the track trigger has been activated by a train.</td>
 
<td>
 
<table cellpadding="4" bgcolor=#ffffff>
 
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
 +
</table> <!-- END Step 1 table -->
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>&nbsp;</td>
 +
<td>[[file:DotPoint2.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Indent the Popup Message Rule:</span><br>
 +
<table> <!-- BEGIN Step 2 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>The '''Message Popup Rule''' has to be ''indented'' so that it becomes a ''Child'' of the '''Trigger Check Rule''' and is controlled by that rule.<br>
<td><font size="3">'''Steps:'''</font><br>
+
[[file:SessionRuleIndent.JPG|link=]]<br>
With the '''Message Popup Rule''' highlighted (shown left):-
+
With the '''Message Popup Rule''' highlighted:-
 
*Click the '''''Indent''''' (''right arrow'') button.
 
*Click the '''''Indent''''' (''right arrow'') button.
This should indent the '''Message Popup''' rule one level inwards (shown below).</td>
+
This should indent the '''Message Popup''' rule one level inwards (as shown below).
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:SessionRuleIndented.JPG|link=]]</td>
 +
</tr>
 +
<tr>
 +
<td><br>
 +
This '''Message Popup Rule''' is now a '''Child Rule''' of the '''Trigger Check Rule''' and will only be executed ''after'' the track trigger has been activated by a train.</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
Line 284: Line 365:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Step 2 table -->
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table> <!-- END Steps Table -->
<td>[[file:SessionRuleIndented.JPG]]
+
<table width="100%"> <!-- BEGIN Back-To-Top Table -->
</td>
+
<tr valign="top">
 +
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Back-To-Top Table -->
<br>
+
  
==Configuring the Message==
+
==Configuring the Message and Testing==
  
<table cellpadding="4" bgcolor=#ffffff>
+
<table cellpadding="4" bgcolor=#ffffff> <!-- BEGIN Step table -->
 +
<tr valign="top">
 +
<td>[[file:Steps.PNG|link=]]<br><br>
 +
<span style="font-size: 17px; font-weight: 700;">Steps</span></td>
 +
<td>[[file:DotPoint1.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Open the Message Popup Rule for Editing:</span><br>
 +
<table> <!-- BEGIN Step 1 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>With the '''Message Popup Rule''' highlighted and indented (as shown above):-
<td><font size="3">'''Steps:'''</font><br>
+
*Click the '''Edit''' button. The '''Message Popup Rule''' properties window will appear (as shown below)</td>
With the '''Message Popup Rule''' highlighted and indented (as shown above):-
+
*Click the '''Edit''' button. The '''Message Popup Rule''' properties window will appear (shown below).</td>
+
 
</tr>
 
</tr>
 
<tr>
 
<tr>
Line 307: Line 391:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Step 1 table -->
 
+
<table>
+
<tr valign="top">
+
<td width="640">[[file:MessagePopupText.JPG]]<br><br>
+
The finished '''Message Popup'''.<br>
+
[[file:MessagePopupStop.JPG]]
+
 
</td>
 
</td>
<td>
 
<table cellpadding="4" bgcolor=#ffffff>
 
<tr>
 
<td colspan="2">
 
----</td>
 
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>&nbsp;</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>[[file:DotPoint2.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Configure the Message:</span><br>
Set the properties as shown:-
+
<table> <!-- BEGIN Step 2 table -->
 +
<tr valign="top">
 +
<td>Set the properties as shown:-
 
#Check '''ON''' ''Close previous message popup windows''
 
#Check '''ON''' ''Close previous message popup windows''
 
#Select '''Option Button''' ''Custom text''
 
#Select '''Option Button''' ''Custom text''
 
#Enter a short text message (you are limited to about 6 lines of text)
 
#Enter a short text message (you are limited to about 6 lines of text)
To add an icon to the message:-
+
</td>
*Click the link '''''<u>click here to set</u>''''' (shown left) and either
+
</tr>
**Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, or
+
<tr valign="top">
**Simply type "icon stop" in the text box to use one of the builtin icons.
+
<td width="640">[[file:MessagePopupText.JPG|link=]]</td>
*Click on the [[file:Tick.PNG]] icon</td>
+
</tr>
 +
<tr>
 +
<td>
 +
<table cellpadding="4" bgcolor="Aquamarine"> <!-- BEGIN Step 2 Wikilink Table -->
 +
<tr valign="top">
 +
<td>[[file:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
More information on this rule can be found on the '''Trainz Wiki Page''' at:-<br>
 +
* '''[[How to Use Message Popup Rule]]'''<br>
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 2 Wikilink Table -->
 +
</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
Line 338: Line 425:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Step 2 table -->
[[file:IconStop.JPG]]
+
 
</td>
 
</td>
 
</tr>
 
</tr>
</table>
+
<tr valign="top">
<br>
+
<td>&nbsp;</td>
See the Trainz Wiki page [[file:WikiLink.PNG]] '''[[How to Use Message Popup Rule]]''' for more information on this rule.
+
<td>[[file:DotPoint3.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">(Optional) Add a Message Icon:</span><br>
<table cellpadding="4" bgcolor=#ffffff>
+
<table> <!-- BEGIN Step 3 table -->
 +
<tr valign="top">
 +
<td>
 +
*Click the link '''''<span style="text-decoration: underline;">click here to set</span>''''' (shown left) and either
 +
:*Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, or
 +
:*Simply type "icon stop" in the text box to use one of the builtin icons.
 +
*Click on the [[file:Tick.PNG|link=]] icon</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[file:IconStop.JPG|link=]]</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>
 +
*click on the [[file:Tick.PNG|link=]] icon to exit the '''Message Popup Rule''' and return to the '''Session Editor'''<br>
 +
The completed Message Popup Rule<br>
 +
[[file:MessagePopupStop.JPG|link=]]
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
 
----</td>
 
----</td>
 +
</tr>
 +
</table> <!-- END Step 3 table -->
 +
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>&nbsp;</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>[[file:DotPoint4.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Test the Trigger:</span><br>
*Again, click on the [[file:Tick.PNG]] icon to exit the '''Message Popup Rule''' then exit the Session Editor
+
<table> <!-- BEGIN Step 4 table -->
 +
<tr valign="top">
 +
<td>
 +
*Exit the '''Session Editor'''
 
*Add a consist to your layout a short distance from the track trigger (but further away than its radius), save the Surveyor Session, and then test in '''Driver Mode'''</td>
 
*Add a consist to your layout a short distance from the track trigger (but further away than its radius), save the Surveyor Session, and then test in '''Driver Mode'''</td>
 
</tr>
 
</tr>
Line 360: Line 467:
 
----</td>
 
----</td>
 
</tr>
 
</tr>
</table>
+
</table> <!-- END Step 4 table -->
Another example of using the '''Trigger Check Rule''' can be found in the Trainz Wiki page [[file:WikiLink.PNG]] '''[[How to Use Message Popup Rule (Applications)]]'''.
+
Another example of using the '''Trigger Check Rule''' can be found in the '''Trainz Wiki Page''' [[file:WikiLink.PNG|link=]] '''[[How to Use Message Popup Rule (Applications)]]'''.
 
<br>
 
<br>
 +
</td>
 +
</tr>
 +
</table> <!-- END Steps Table -->
 +
 +
<table width="100%">
 +
<tr valign="top">
 +
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
</tr>
 +
</table>
  
 
='''Alternatives to the Trigger Check Rule'''=
 
='''Alternatives to the Trigger Check Rule'''=
Line 368: Line 484:
 
<table cellpadding="4" bgcolor=#ffffff>
 
<table cellpadding="4" bgcolor=#ffffff>
 
<tr valign="top">
 
<tr valign="top">
<td width="58">[[file:RulesWiki.PNG]]</td>
+
<td width="50">[[file:RulesWiki.PNG|link=]]</td>
 
<td width="640">
 
<td width="640">
There are alternative rules that can be used in place of the '''Trigger Check Rule''' and triggers. A few possibilities are listed below:-</td>
+
There are other '''rules''' that can be used in place of the '''Trigger Check Rule''' and triggers. A few possibilities are listed below:-</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
*'''[[Session_Rule_List_with_Parameters#Directional_Trigger_Check_Rule|Directional Trigger Check Rule]]''' - identical to the '''Trigger Check Rule''' but adds the ability to test the train direction. Requires the use of a special '''Directional Trigger'''. For an example of its use see the Trainz Wiki Link [[file:WikiLink.PNG]] '''[[How to Control Signals in Sessions|Controlling Signals in Sessions]]'''.
+
*'''[[Session_Rule_List_with_Parameters#Directional_Trigger_Check_Rule|Directional Trigger Check Rule]]''' - identical to the '''Trigger Check Rule''' but adds the ability to test the train direction. Requires the use of a special '''Directional Trigger'''. For an example of its use see the '''Trainz Wiki Page''' [[file:WikiLink.PNG|link=]] '''[[How to Control Signals in Sessions|Controlling Signals in Sessions]]'''.
 
*'''[[Session_Rule_List_with_Parameters#Trackside_Check_Rule|Trackside Check Rule]]''' - very similar to the '''Trigger Check Rule''' but provides some different options.
 
*'''[[Session_Rule_List_with_Parameters#Trackside_Check_Rule|Trackside Check Rule]]''' - very similar to the '''Trigger Check Rule''' but provides some different options.
 
*'''Navigation Points''' (see the '''How to Guides''' link below) are more complex but provide more advanced controls and options.
 
*'''Navigation Points''' (see the '''How to Guides''' link below) are more complex but provide more advanced controls and options.
 
*'''[[Session_Rule_List_with_Parameters#Multiple Resource Check Rule|Multiple Resource Check Rule]]''' - monitors and acts on changes in multiple industry or multiple wagon resource (commodity) levels.
 
*'''[[Session_Rule_List_with_Parameters#Multiple Resource Check Rule|Multiple Resource Check Rule]]''' - monitors and acts on changes in multiple industry or multiple wagon resource (commodity) levels.
 
*'''[[Session_Rule_List_with_Parameters#Resource Verify Rule (fixed)|Resource Verify Rule]]''' - monitors and acts on changes in a single industry or wagon resource (commodity) level.
 
*'''[[Session_Rule_List_with_Parameters#Resource Verify Rule (fixed)|Resource Verify Rule]]''' - monitors and acts on changes in a single industry or wagon resource (commodity) level.
*'''[[Session_Rule_List_with_Parameters#Timecheck Rule|Timecheck Rule]]''' - triggers an event at a set time.
+
*'''[[Session_Rule_List_with_Parameters#Timecheck Rule|Timecheck Rule]]''' - triggers an event at a set time.<br>
 +
<br>
 +
<table cellpadding="4" bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width="50">[[file:CommandsWiki.png|link=]]</td>
 +
<td width="640">
 +
There is a '''driver command''' that can be used in place of the '''Trigger Check Rule'''.</td>
 +
</tr>
 +
</table>
 +
 
 +
*'''[[Driver_Commands_List#WaitForTrigger|Wait For Trigger]]''' - forces an AI controlled train to wait until a specified trigger has been activated by another train.
 +
<br>
 +
 
 +
='''Related Links'''=
 +
 
 +
<table cellpadding="4" bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td>[[file:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
* '''[[How to Use Track Direction Markers]]'''
 +
* '''[[How to Use Track Markers]]'''
 +
* '''[[How to Use Track Priority Markers]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
<table width="100%">
 +
<tr valign="top">
 +
<td align="right">[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
</tr>
 +
</table>
 
----
 
----
 
----
 
----
<br>
 
  
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
 
<table cellpadding="4" bgcolor=#ffffff>
 
<table cellpadding="4" bgcolor=#ffffff>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrainzWiki.png]]</td>
+
<td>[[file:TrainzWiki.png|link=]]</td>
 
<td>
 
<td>
<font size="3">'''More Tutorials and Guides to Using Trainz'''</font><br>
+
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 +
*'''[[Driver Commands List]]'''
 
*'''[[Session Rule List with Parameters|Session Rules List (Alphabetical) with Parameters]]'''
 
*'''[[Session Rule List with Parameters|Session Rules List (Alphabetical) with Parameters]]'''
 
*'''[[Session Rules By Categories With Properties|Session Rules List (Categories) With Parameters]]'''
 
*'''[[Session Rules By Categories With Properties|Session Rules List (Categories) With Parameters]]'''
Line 396: Line 541:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
----
[[Category:How-to guides]]
+
This page was created by Trainz user '''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in May 2018 and was last updated as shown below.
[[Category:Rules]]
+
----
 +
[[Category:How-to guides]][[Category:Rules]]

Revision as of 08:47, 8 May 2020

The information in this Wiki Page applies to TANE, TRS19 and Trainz Plus.

Contents

What are Track Triggers?

DotPoint.JPG Track triggers are track markers that are invisible in Driver Mode but visible in Surveyor Mode. They are used to activate Session Rules and some Driver Commands

Track triggers can be programmed to respond when a train (any train or a specific train) passes over them in Driver Mode. The response comes from executing a set of Session Rules that have been attached to a WikiLink.PNG Trigger Check Rule (or a similar rule) or a Driver Command that is monitoring the track trigger.

TrackTrigger.JPG

Shown at left is a Track Trigger placed on a track in Surveyor Mode. It is NOT visible in Driver Mode. The "5.00m" shown below the trigger name is the trigger detection radius


Route or Session?

DotPoint.JPG Track Triggers can be placed in a Route layer or in a Session layer


NotePad.PNG Notes:
  • Placing Track Triggers in a Route layer (e.g. in the same layer as the track) means that they will be available in all Sessions created using that particular Route.
  • Placing Track Triggers in a Session layer means that they will only be available in that Session. This can be useful if two or more Sessions are being created and you want to use different Track Triggers in each Session.


LinkWiki.PNG Information on Route and Session layers can be found at:-
Top

Adding a Track Trigger

TrackTriggerMode.JPG

Steps.PNG Steps:

A Track Trigger is placed on the track by:-

  1. clicking the Track tool,
  2. clicking the Trackmark Mode button,
  3. selecting the Trigger object from the list of installed objects,
  4. clicking the Add Object button,
  5. clicking the track position where the track trigger is to be placed.


Top

Configuring a Track Trigger

As soon as a new track 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.


Steps.PNG

Steps
DotPoint1.JPG Name the Trigger:
TrackTriggerProperties.JPG
  • To change the track trigger name click on the name box, delete the highlighted default name and enter a new name
  • To change the assigned layer click on the layer box and select a new layer
  • Leave the "Bound Layer" at <none>. (See the Trainz Wiki Page WikiLink.PNG Using Layers for information on layers)
  • To confirm the changes click on the Tick.PNG icon on the bottom right of the window

  DotPoint2.JPG (Optional) Set the Trigger Detection Radius:
Track triggers have a "detection radius" that controls how close a train has to approach to trigger the event. The default radius is 20 metres. The smaller the radius the closer the train has to be to the track trigger to be detected. This radius is set in the Advanced Properties section of the Tools window (shown below).
TrackTriggerRadius.JPG
  1. Click the Advanced Tab to open its properties
  2. Enter a new radius value in metres
  3. Click the Set Trigger Radius button
  4. Click on the track trigger to assign its new radius


PencilTips.PNG A small radius should only be used for slower moving trains. Short fast trains may pass over a small radius track trigger without being detected.

Top

Creating a Track Trigger Event

Track trigger events are handled by the Trigger Check Rule (or a similar rule) which is added to a Session in the WikiLink.PNG Session Editor.

LinkWiki.PNG

More information on the Trigger Check Rule can be found on the Trainz Wiki Rules Page at:-



Steps.PNG

Steps
DotPoint1.JPG Open the Session Editor:

To add the Trigger Check Rule to a session:-

  1. Open the Surveyor Main Menu in TANE (shown below left) or the Surveyor Edit Menu in TRS19 and Trainz Plus (shown below right)
  2. Select the option Edit Session from the drop down menu list
EditSessionMenu.JPG SessionEditMenuSP1.png

  DotPoint2.JPG Add the Trigger Check Rule:
In the Edit Session window (shown below left):-
  • Click the Add button

In the Rule Selection window (shown below right):-

  1. Scroll down the list to select the Trigger Check rule
  2. Click on the Tick.PNG icon
EditSessionWindowX.JPG RuleSelect.JPG

This will add the Trigger Check rule to the session.

  DotPoint3.JPG Open the Trigger Check Rule Properties:
With the Trigger Check rule highlighted (shown below):-
  • Click the Edit button. This will open the rule properties window
TriggerCheck.JPG

  DotPoint4.JPG Configure the Rule:
For this example we will leave all settings unchanged and simply identify the track trigger to be used.

In the Trigger Properties window (shown below):-

  • Click the Add trigger link
TriggerCheckProperties.JPG
LinkWiki.PNG

More information on the settings and options in this rule can be found on the Trainz Wiki Rules Page at:-


  DotPoint5.JPG Select the Trigger:
The Trigger Selection Window will list all the Track Triggers in your layout.
  1. Select the trigger you have just added
  2. Click on the Tick.PNG icon at the bottom of the selection window
TriggerList.JPG
Once the trigger has been added to the rule, click on the Tick.PNG icon in the Trigger Check properties window to accept the change.

Top

Adding an Instruction to the Trigger Event

To test your trigger event you will need to add at least one rule.

Adding a Child Rule

Steps.PNG

Steps
DotPoint1.JPG Add A Message Popup Rule:
When you are back in the Session Editor window:-
  1. Make sure that the new Trigger Check Rule is selected (highlighted)
  2. Click the Add button to add another new rule
  3. Scroll down the rule selection window to find and select the Message Popup rule
  4. Click on the Tick.PNG icon
TriggerAddMesPopup.JPG
The Message Popup Rule should now appear directly below the Trigger Check rule. It will display a red cross because it has not yet been configured.

  DotPoint2.JPG Indent the Popup Message Rule:
The Message Popup Rule has to be indented so that it becomes a Child of the Trigger Check Rule and is controlled by that rule.

SessionRuleIndent.JPG
With the Message Popup Rule highlighted:-

  • Click the Indent (right arrow) button.

This should indent the Message Popup rule one level inwards (as shown below).

SessionRuleIndented.JPG

This Message Popup Rule is now a Child Rule of the Trigger Check Rule and will only be executed after the track trigger has been activated by a train.

Top

Configuring the Message and Testing

Steps.PNG

Steps
DotPoint1.JPG Open the Message Popup Rule for Editing:
With the Message Popup Rule highlighted and indented (as shown above):-
  • Click the Edit button. The Message Popup Rule properties window will appear (as shown below)

  DotPoint2.JPG Configure the Message:
Set the properties as shown:-
  1. Check ON Close previous message popup windows
  2. Select Option Button Custom text
  3. Enter a short text message (you are limited to about 6 lines of text)
MessagePopupText.JPG
LinkWiki.PNG

More information on this rule can be found on the Trainz Wiki Page at:-


  DotPoint3.JPG (Optional) Add a Message Icon:
  • Click the link click here to set (shown left) and either
  • Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, or
  • Simply type "icon stop" in the text box to use one of the builtin icons.
  • Click on the Tick.PNG icon
IconStop.JPG
  • click on the Tick.PNG icon to exit the Message Popup Rule and return to the Session Editor

The completed Message Popup Rule
MessagePopupStop.JPG


  DotPoint4.JPG Test the Trigger:
  • Exit the Session Editor
  • Add a consist to your layout a short distance from the track 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 Trainz Wiki Page WikiLink.PNG How to Use Message Popup Rule (Applications).

Top

Alternatives to the Trigger Check Rule

RulesWiki.PNG There are other rules that can be used in place of the Trigger Check Rule and triggers. A few possibilities are listed below:-
  • Directional Trigger Check Rule - identical to the Trigger Check Rule but adds the ability to test the train direction. Requires the use of a special Directional Trigger. For an example of its use see the Trainz Wiki Page WikiLink.PNG Controlling Signals in Sessions.
  • Trackside Check Rule - very similar to the Trigger Check Rule but provides some different options.
  • Navigation Points (see the How to Guides link below) are more complex but provide more advanced controls and options.
  • Multiple Resource Check Rule - monitors and acts on changes in multiple industry or multiple wagon resource (commodity) levels.
  • Resource Verify Rule - monitors and acts on changes in a single industry or wagon resource (commodity) level.
  • Timecheck Rule - triggers an event at a set time.


CommandsWiki.png There is a driver command that can be used in place of the Trigger Check Rule.
  • Wait For Trigger - forces an AI controlled train to wait until a specified trigger has been activated by another train.


Related Links

LinkWiki.PNG
Top


Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz


This page was created by Trainz user pware in May 2018 and was last updated as shown below.


Personal tools