How to Use Track Triggers

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m
(87 intermediate revisions by one user not shown)
Line 1: Line 1:
='''What are Track Triggers?'''=
+
The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000> <!-- BEGIN Nav Buttons Table NO SKIPS -->
<tr>
+
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=629>&#160;</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 width=50>&#160;</td> <!-- Skip Down -->
 +
<td width=50>&#160;</td> <!-- Skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>[[image:NextDown.png|link=#stepWhat|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=350>
 +
__TOC__
 +
</td>
 +
<td>
 +
<table bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Track Triggers''' are track markers that are invisible in '''Driver''' but visible in '''Surveyor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>They are used to activate some '''Session Rules''' and '''Driver Commands'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>They can be placed in a Route layer or in a Session layer</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table NO SKIPS -->
 +
<tr valign="top">
 +
<td width=629><span id="stepWhat"></span>
 +
='''What are Track Triggers?'''=
 +
</td>
 +
<td width=50>&#160;</td> <!-- Skip Down -->
 +
<td width=50>&#160;</td> <!-- Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>[[image:NextDown.png|link=#stepRoute|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons 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 '''Trigger Check Rule''' or a similar rule that is monitoring the track trigger.  
+
<table width=1000>
 
+
<tr valign="top">
 +
<td colspan=2>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 [[image: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.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>Shown below left is a standard '''Track Trigger''' and below right is a '''Directional Track Trigger'''. They are just two examples of several types of track triggers. In both cases:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTrigger.JPG]]</td>
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
<td><br>
+
<td>they are visible in Surveyor and invisible in Driver</td>
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
+
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the "green wings" show their '''Effect Radius''', the region where a consist will trigger an "event". The number in brackets show that radius in metres
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:redDot10x10.png|link=]]</td>
 +
<td>the '''Directional Track Trigger''' will normally only be triggered if the consist is moving in the direction indicated by the arrow</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:RedDot10x10.png|link=]]</td>
 +
<td>the standard '''Track Trigger''' will be triggered regardless of the direction of movement</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=500 align="center">[[image:TrackTrigger.JPG|link=]]<br>
 +
'''"Standard" Track Trigger'''</td>
 +
<td width=500 align="center">[[image:TrackDTrigger.png|link=]]<br>
 +
'''Directional Track Trigger'''</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table NO SKIPS -->
 +
<tr valign="top">
 +
<td width=629><span id="stepRoute"></span>
 +
='''Route or Session?'''=
 +
</td>
 +
<td width=50>&#160;</td> <!-- Skip Down -->
 +
<td width=50>&#160;</td> <!-- Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepWhat|alt=Next Up|Next Up]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepAdding|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Track Triggers''' can be placed in a '''Route Layer''' or in a '''Session Layer'''</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>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</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>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 triggers in each Session</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding=2 bgcolor="Aquamarine">
 +
<tr valign="top">
 +
<td>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>Information on Route and Session layers can be found at:-<br>
 +
* '''[[How to Use Layers]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SECTION w SKIPS -->
 +
<tr valign="top">
 +
<td width=629><span id="stepAdding"></span>
 
='''Adding a Track Trigger'''=
 
='''Adding a Track Trigger'''=
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipAddS10|Skip Down]]</td>
 +
<td width=50>&#160;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepRoute|alt=Next Up|Next Up]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepCreating|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
 +
<table bgcolor=#000000 width=900>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 width=896>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
A '''Track Trigger''' has two important properties:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTriggerMode.JPG]]</td>
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>its name which is needed for all commands and rules that use the '''Track Trigger''', and</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>its '''Trigger Effect Radius''' (the green "wings" shown in the image above with the radius value, in metres, shown below the trigger name). This controls how closely an AI train has to approach the trigger to activate it (smaller radius = closer to the trigger)</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top" bgcolor=#ffffe0>
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>A "standard" '''Track Trigger''' has no visible direction and, while it can be rotated, this has '''NO EFFECT''' on its operation. The '''Directional Track Trigger''' does have a direction because it is only triggered by trains travelling in a specific direction</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipAddS10"></span>
 +
=='''In Surveyor Classic (S10)'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipAddS20|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#stepAdding|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 
 +
===Adding a Track Trigger (S10)===
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=410>[[image:TrackTriggerMode.JPG|link=]]</td>
 
<td><br>
 
<td><br>
<table cellpadding="4" bgcolor=#ffffff>
+
<table bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>
<td><font size="3">'''Steps:'''</font><br>
+
<table bgcolor=#ffffff cellpadding=2>
A '''Track Trigger''' is placed on the track by:-
+
<tr valign="top">
*clicking the '''Track''' tool,
+
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To add a '''Trigger Mark:-</td>
*clicking the '''Trackmark Mode''' button,
+
*selecting the '''Trigger''' object from the list of installed objects,
+
*clicking the '''Add Object''' button,
+
*then clicking the track position where the track trigger is to be placed.</td>
+
 
</tr>
 
</tr>
</table></td>
+
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>Open the '''Tracks Tool''' Flyout or press the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;F4&#160;</span> key</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Trackmark Mode''' button or press the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;V&#160;</span> key</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Trigger''' shown in the asset list</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;+&#160;</span> '''Add Object''' button - it may already be selected - or press the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;A&#160;</span> key</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the track location where the marker is to be placed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>This will place the Track Trigger on the track and open its properties window.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
='''Configuring a Track Trigger'''=
+
<table width=1000>
 +
<tr valign="top">
 +
<td>As soon as a new track trigger has been placed, its properties window will open on the screen. It will initially be given a default name and assigned to the currently active layer.</td>
 +
</tr>
 +
</table>
 +
<br>
 +
===Set the Trigger Name and Layer (S10)===
  
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.
+
<table width=1000>
 +
<tr valign="top">
 +
<td width=500>[[image:TrackTriggerProperties.JPG|link=]]</td>
 +
</tr>
 +
</table>
  
<table>
+
<table width=1000 bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTriggerProperties.JPG]]</td>
 
 
<td>
 
<td>
<table cellpadding="4" bgcolor=#ffffff>
+
<table width=996 bgcolor=#ffffff cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>To change the track trigger name <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the name text entry box, delete the highlighted default name and enter a new name</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 '''[[How to Use Layers|Using Layers]]''' for information on layers).
+
*To confirm the changes click on the '''Tick''' button on the bottom right of the window.</td>
+
 
</tr>
 
</tr>
</table></td>
+
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>To change its assigned layer <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the layer text entry box (or use its scroll arrowheads) and select a new layer - see the '''Trainz Wiki Page''' [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Layers|How to Use layers]]''' for more details on layers</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>To confirm the changes <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon or the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Save Changes&#160;</span> button (depending on your '''Trainz''' version) at the bottom of the window</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
===Set the Effect Radius (S10)===
  
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).
+
At the bottom of the '''Track Tools''' flyout menu is an '''Advanced''' button. <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> this button to open the advanced tools.<br>
  
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>The '''Effect Radius''' sets the size of green "effect wings" attached both ends of the marker. This sets how close a consist has to approach the marker to trigger its "event". The smaller the radius the closer it must approach.</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="middle">
 +
<td width=400>[[image:TrackMarkRadiusTools.png|link=]]</td>
 +
<td>
 +
<table width=600 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To set a Track Trigger Effect Radius:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>In the '''Track Tools''' flyout, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Advanced''' button to open the Radius tools and properties. You will have a choice of 4 methods to set and adjust the Effect Radius</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TrackTriggerRadius.JPG]]</td>
+
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Options:</span> Choose one of:-</td>
<td><br>
+
</tr>
<table cellpadding="4" bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td width=25>[[image:Ablue.png|link=]]</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>To copy the '''Effect Radius''' of an existing '''Track Trigger'''
*Click the '''Advanced Tab''' to open its properties.  
+
<table>
*Enter a new radius value in metres.
+
<tr valign="top">
*Click the '''Set Trigger Radius''' button
+
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
*Click on the track trigger to assign its new radius.
+
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Get Effect Radius''' icon</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Track Trigger''' whose radius you want to copy - the radius will be copied into the Effect Radius Value text box (the default value is 20.00 metres)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>To apply the new value see option [[image:Cblue.png|link=]] below</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Bblue.png|link=]]</td>
 +
<td>To manually alter the '''Effect Radius''' value
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>Type the new value (in metres) into the Effect Radius Value text box</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>To apply the new value see option [[image:Cblue.png|link=]] below</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Cblue.png|link=]]</td>
 +
<td>To apply a value in the '''Effect Radius Value''' text box (from methods [[image:Ablue.png|link=]], [[image:Bblue.png|link=]] or [[image:Dblue.png|link=]]) to another '''Track Trigger'''
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Copy Radius Value''' icon</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Track Trigger''' that is to receive the new value (you can click on more than one)</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Dblue.png|link=]]</td>
 +
<td>To adjust the Effect Radius value up or down
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Adjust Effect Radius''' button</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>Select the '''Track Trigger'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> '''Forward''' (to increase the value) or '''Backward''' (to reduce the value)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td>The new value will be immediately applied to the selected Track Trigger as the mouse moves (but only one Track Trigger at a time)</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding="4" bgcolor=#ffffb0>
+
<table bgcolor=#000000 width=900>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:NotePad.PNG]]</td>
+
<td>
<td><font size="3">'''Notes:'''</font><br>
+
<table bgcolor=#ffffe0 width=896>
A small radius should only be used for slower moving trains. Fast trains may pass over a small radius track trigger without being detected.</td>
+
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>Once you have an Effect Radius entered in the value box, you can apply it to any number of Track Triggers by using method [[image:Cblue.png|link=]] shown above
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
</td></tr>
+
</td>
 +
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
='''Creating a Track Trigger Event'''=
+
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipAddS20"></span>
 +
=='''In Surveyor 2.0 (S20)'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#stepCreating|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#skipAddS10|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
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>
+
'''Surveyor 2.0''' is currently only available for '''Trainz Plus''' and '''TRS22 Platinum'''.<br>
  
The Trainz Wiki Link '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' contains detailed information on this rule.
+
===Adding a Track Trigger (S20)===
  
<table>
+
[[image:DotPoint1.JPG|link=]] In the '''Asset Palette''' either:-
 +
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:EditSessionMenu.JPG]]</td>
+
<td>
<td><br>
+
<table border=1>
<table cellpadding="4" bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td width=250 align="center">[[image:Ablue.png|link=]] <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Track Mesh Filter''' icon<br>
<td><font size="3">'''Steps:'''</font><br>
+
[[image:TrackMeshFilter.png|link=|alt=Track mesh]]
To add the '''Trigger Check Rule''' to a session:-
+
</td>
*Open the '''Surveyor Main Menu'''.
+
*Select the option '''Edit Session''' from the drop down menu list.</td>
+
 
</tr>
 
</tr>
</table></td>
+
</table>
 +
</td>
 +
<td width=50 align="center"><span style="font-size: 17px; font-weight: 700;">OR</span></td>
 +
<td>
 +
<table border=1>
 +
<tr valign="top">
 +
<td align="center">[[image:Bblue.png|link=]] <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Content Drop-down Box'''<br>
 +
[[image:FilterSelect.png|link=|alt=Filter List]]<br>
 +
Then select '''Track Objects'''<br>
 +
[[image:FilterSelectTrackType.png|link=|alt=Track Objects]]
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
<td>
 +
<table bgcolor=#000000 width=400 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 width=396 cellpadding=2>
 +
<tr valign="top">
 +
<td width=22>[[image:NotePad.PNG|link=]]</td>
 +
<td width=374><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
If the '''Assets Palette''' is not shown on the screen, then:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td rowspan="2">[[file:EditSessionWindowX.JPG]]</td>
+
<td width=175>[[image:WindowsMenu_S20.png|link=|alt=Windows Menu]]</td>
<td><br>
+
<td>
<table cellpadding="4" bgcolor=#ffffff>
+
<table bgcolor=#ffffff>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td colspan=2><span style="font-weight: 700; font-size: 15px;;">Steps:</span> To display palettes:-</td>
<td><font size="3">'''Steps:'''</font><br>
+
In the Edit Session window (shown left):-
+
*Click the '''Add''' button
+
In the Rule Selection window (shown below):-
+
*Scroll down the list to select the '''Trigger Check''' rule
+
*Click the '''Tick''' button.</td>
+
 
</tr>
 
</tr>
</table></td>
+
<tr valign="top">
 +
<td width=20>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>open the [[image:SurveyorWindowIcon.png|link=]] '''Window Menu''' from the menu icons at the top of the screen</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:RuleSelect.JPG]]</td>
+
<td>&#160;</td>
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BulletTick.png|link=]]</td>
 +
<td>visible palettes have ticks next to their names</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BulletNoTick.png|link=]]</td>
 +
<td>invisible (hidden) palettes have no ticks next to their names</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>if the '''Assets Palette''', or any required palette, does not have a tick next to its name then <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the name of the palette or on the empty [[image:BulletNoTick.png|link=]] box next to its name. This will add a [[image:BulletTick.png|link=]] and make the palette visible</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
There is a '''Trainz Wiki Page''' specifically covering the '''S20 Palettes''' at<br>[[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_S20_Palettes|How to Use the Surveyor 2.0 Palettes]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
This will add the '''Trigger Check''' rule to the session.
+
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2>[[image:PencilTips.PNG|link=]] <span style="font-size: 15px; font-weight: 700; color: white; background-color: blue;">&#160;Shortcut&#160;</span><br>
 +
If you already have a '''Track Trigger Mark''' placed in your route then:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=20>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>move the tool pointer over the existing trigger object and hold down the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Alt&#160;</span> key. The object name will appear in a '''ToolTip''' attached to the pointer</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px;"><span style="color: white; background-color: black;">&#160;Alt&#160;</span>&#160;+&#160;<span style="background-color: lightcyan;">Left Click</span></span> (hold down the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Alt&#160;</span> key and <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the trigger mark to identify it in the '''Assets Palette''' and to select the '''Placement Tool'''. Release the key.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>Jump to '''Step [[image:DotPoint5.JPG|link=]]''' below.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
[[image:DotPoint2.JPG|link=]] To narrow down the filter list, type "trig" ('''UPPER/lower''' case does not matter) in the '''Search Text Box'''<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:FilterSelectSearchTrigger.png|link=|alt=Text search]]</td>
 +
<td><br>[[image:DotPoint3.JPG|link=]] This will list all the '''Track Objects''' containing the text "trig" in the filter list.<br>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerCheck.JPG]]</td>
+
<td>[[image:FilterSelectTrigger.png|link=|alt=Filtered list]]</td>
<td><br>
+
<td valign="middle">[[image:DotPoint4.JPG|link=]] <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the item name '''Trigger'''.<br><br>
<table cellpadding="4" bgcolor=#ffffff>
+
If you are not sure about an asset then <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Double Left Click</span> on the name to bring up its image and description.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
[[image:DotPoint5.JPG|link=]] Place the '''Track Trigger''' on the track.<br>
 +
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td colspan=2>
<td><font size="3">'''Steps:'''</font><br>
+
<table>
With the '''Trigger Check''' rule highlighted (shown left):-
+
<tr valign="top">
*Click the '''Edit''' button. This will open its properties window.</td>
+
<td width=535>[[image:Tools_S20.png|link=|alt=Tools and keymap for S20]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 +
----
 +
</td>
 
</tr>
 
</tr>
</table></td>
+
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>To add a track trigger, or any object, you will need to select the '''Placement Tool'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>To edit a track trigger once it has been placed you will usually use either the '''Free Move Tool''' or the '''Fine Adjustment Tool'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=480>[[image:TriggerAdd_S20.png|link=|alt=Add priority marker]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To add a Track Trigger:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>Select the '''Placement Tool''' (or press the <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;E&#160;</span> key) from the '''Tools Palette'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the track at the position where you want to place the trigger</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>Once placed a '''Track Trigger''' can be easily moved if needed.</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
For this example we will leave all settings unchanged and simply identify the track trigger to be used.  
+
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
To delete a '''Track Trigger''' (or any asset):-
 +
<table bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td colspan=2"><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select either the:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td rowspan="2" width="640">[[file:TriggerCheckProperties.JPG]]<br>
+
<td width=25>[[image:Ablue.png|link=]]</td>
 +
<td>'''Free Move Tool''' (or press <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;S&#160;</span>) <span style="font-weight: 700; font-size: 15px;">OR</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Bblue.png|link=]]</td>
 +
<td>'''Fine Adjustment Tool''' (or press <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;D&#160;</span>)</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''Track Trigger'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>press the <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Delete&#160;</span> key</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
Once the trigger has been identified, click the '''Tick''' button in the '''Trigger Check''' properties window (shown above) to accept the change.</td>
+
<table bgcolor=#000000>
<td><br>
+
<table cellpadding="4" bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td>
<td><font size="3">'''Steps:'''</font><br>
+
<table bgcolor=#ffffe0>
In the Trigger Properties window (shown left):-
+
<tr valign="top">
*Click the '''''<u>Add trigger</u>''''' link
+
<td>[[image:PencilTips.PNG|link=]]</td>
In the Trigger Selection window (shown below):-
+
<td>If you need to rotate the '''Track Trigger''' to face the opposite direction (and this would apply only to '''Directional Track Triggers''') then:-
*Select the trigger you have just added
+
<table bgcolor=#ffffff>
*Click the '''Tick''' button on the selection list</td>
+
<tr valign="top">
 +
<td colspan=2"><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 
</tr>
 
</tr>
</table></td>
+
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select the Track Trigger and <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on its '''Context Menu Icon''' (or press the <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;T&#160;</span> key)</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:TriggerList.JPG]]
+
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>from the popup menu select the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Rotate Trackside&#160;</span> option</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>'''Note:''' the direction a "standard" '''Track Trigger''' faces has no effect on its operation</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
='''Adding an Instruction to the Trigger Event'''=
 
To test your trigger event you will need to add at least one rule.<br><br>
 
  
==Adding a Child Rule==
+
===Change Its Name (S20)===
  
<table>
+
The name of the marker is only useful for finding it in the route. It is not used for any operational purpose.<br>
 +
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
<td rowspan="2">[[file:TriggerAddMesPopup.JPG]]</td>
+
<td width=480>[[image:TriggerName_S20.png|link=]]</td>
<td><br>
+
<td>
When you are back in the '''Session Editor''' window:-
+
<table bgcolor=#000000 cellpadding=2>
*Click the '''Add''' button to add a new rule.
+
<tr valign="top">
*Scroll down the rule selection window to select the '''Message Popup''' rule
+
<td>
*Click the '''Tick''' button.
+
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To change the name of a '''Track Trigger''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint3Blue.png|link=]]</td>
 +
<td>using either the '''Free Move Tool''' or the '''Fine Adjustment Tool''' select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the '''Track Trigger''' to be renamed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4Blue.png|link=]]</td>
 +
<td>in the '''Info Palette''' (you may need to make this palette visible - see the '''Notes:''' for '''Step''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: red;">&#160;1&#160;</span> above) <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> in the '''Name:''' entry box. Enter a name for the '''Track Trigger''' and press the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Enter&#160;</span> key</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</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.  
+
===Set its Effect Radius (S20)===
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>The '''Effect Radius''' sets the size of green "effect wings" attached both ends of the marker. This sets how close a consist has to approach the marker to trigger its "event". The smaller the radius the closer it must approach.</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=480>[[image:TriggerRadius_S20.png|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To adjust the effect radius of a Track Trigger:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint5Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> '''Forward''' or '''Backward''' on the '''Green Dot''' next to the '''Track Trigger''' to increase or reduce its '''Trigger Effect Radius'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 +
===Move a Track Trigger Along the Track (S20)===
 +
 +
Priority Marks can be moved along the track or to other tracks.<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=480>[[image:triggerMove_S20.png|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To move the Priority Mark:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint6Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> '''Forward''' or '''Backward''' on the '''Yellow Dot''' next to the '''Priority Mark''' to move it along the track or to another track</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 +
===Move the Track Trigger Vertically (S20)===
 +
 +
<table  width=1000>
 +
<tr valign="top">
 +
<td>Track Triggers can be physically placed above (or below) the track. This feature allows them to be placed, for example, above the track so that they will not be hidden in Surveyor if a consist is parked on a marker.</td>
 +
</tr>
 +
</table>
 +
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=480>[[image:TriggerFineAdjustVertical_S20.png|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To move a Track Trigger vertically:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td>This option is only available with the '''Fine Adjustment Tool''' - the <span style="font-weight: 700; font-size: 17px; color: white;background-color: black;">&#160;D&#160;</span> key</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint7Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> '''Forward''' or '''Backward''' on the <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;Blue&#160;</span> '''Vertical Axis Line''' above the Track Trigger to it up or down</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>If you need to return the '''Track Trigger''' to its original position then:-
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To correctly reattach the Track Trigger to the track:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select the object and open (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) its '''Context Menu Icon''' (or press the <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;T&#160;</span> key)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>from the popup menu select <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Reattach to Track&#160;</span></td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 +
===Move the Track Trigger Horizontally (S20)===
 +
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>Track Triggers can be physically placed left or right alongside the track. This feature allows them to be placed, for example, beside the track so that they will not be hidden in Surveyor if a consist is parked on a marker.</td>
 +
</tr>
 +
</table>
 +
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=480>[[image:TriggerFineAdjustHorizontal_S20.png|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To move a Track Trigger horizontally:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td>This option is only available with the '''Fine Adjustment Tool''' - the <span style="font-weight: 700; font-size: 17px; color: white;background-color: black;">&#160;D&#160;</span> key</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint8Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> '''Forward''' or '''Backward''' on the <span style="font-weight: 700; font-size: 15px; color: white; background-color: red;">&#160;Red&#160;</span> '''Horizontal Axis Line''' attached to the track Trigger to move it left or right</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint9Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> '''Forward''' or '''Backward''' on the <span style="font-weight: 700; font-size: 15px; color: white; background-color: green;">&#160;Green&#160;</span> '''Horizontal Axis Line''' attached to the Track Trigger to move it forward or back</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>If you need to return the Priority Mark to its original position then:-
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To correctly reattach the Track Trigger to the track:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select the object and open (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) its '''Context Menu Icon''' (or press the <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;T&#160;</span> key)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>from the popup menu select <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Reattach to Track&#160;</span></td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#000000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
The <span style="font-weight: 700; font-size: 15px; color: white; background-color: green;">&#160;Green&#160;</span> '''Horizontal Axis Line''' shown as [[image:DotPoint9Blue.png|link=]] in the image pointing forward from the '''TrackTrigger''' will move it forward/backward regardless of whether it is on the track or not. It has the same effect as [[image:DotPoint6Blue.png|link=]] <span style="font-weight: 700; font-size: 15px;">Move a Track Trigger Along the Track</span>. However, by using this tool it is possible to move the '''Track trigger''' beyond the end of the track if that is ever required.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 +
===Assign a Track Trigger to a New Layer (S20)===
 +
 +
<table width=1000 cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td colspan=2>The '''Info Palette''' will show the layer assigned to the currently selected object. To the left of the layer name is a small arrowhead object.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:TrackmarkInfo_S20.png|link=|alt=Info palette]]<br><br>
 +
[[image:TrackmarkLayerInfo_S20.png|link=|alt=Layer control]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To assign a Track Trigger to a layer:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>In the '''Info Palette''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the small arrowhead next to the layer name. This will open the layer properties for the selected object</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Layer''' drop down box to select a new layer for the object</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>if required, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Binding''' drop down box to select a new binding layer for the object. It cannot be bound to its own layer</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>if required, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Lock Layer&#160;</span> button to lock the selected layer. If the layer is already locked then this will be shown as an <span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Unlock Layer&#160;</span> button</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#ff0000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:Stop.PNG|link=]]</td>
 +
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td rowspan="2" width="640">[[file:SessionRuleIndent.JPG]]
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>You will not be allowed to place a track object in a layer that is higher up the list than the layer containing the track</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Moving an object from one layer group to another (e.g. from the '''Route Layer Group''' to the '''Session Layer Group''') will change where the object is saved (in the Route or in the Session)</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
<br>
 
<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>
+
<table cellpadding=2 bgcolor="Aquamarine">
<td><br>
+
<tr valign="top">
With the '''Message Popup Rule''' highlighted (shown left):-
+
<td>[[image:LinkWiki.PNG|link=]]</td>
*Click the '''''Indent''''' (''right arrow'') button.
+
<td>Information on layers can be found at:-<br>
This should indent the '''Message Popup''' rule one level in (shown below).<br>
+
* '''[[How to Use Layers]]'''
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table>
<td>[[file:SessionRuleIndented.JPG]]
+
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SECTION w SKIPS -->
 +
<tr valign="top">
 +
<td width=629><span id="stepCreating"></span>
 +
='''Creating a Track Trigger Event'''=
 +
</td>
 +
<td width=50>&#160;</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipAddS20|Skip Up]]</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepAdding|alt=Next Up|Next Up]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepEvent|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
==Configuring the Message==
+
<table width=1000>
 +
<tr valign="top">
 +
<td>When a consist enters the '''Effect Radius''' of a '''Track Trigger''' it will create an "event" that can be detected and responded to by some Session Rules and some Driver Commands. One such rule is the '''Trigger Check Rule''' which is added to a Session in the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]'''.</td>
 +
</tr>
 +
</table>
  
With the '''Message Popup Rule''' highlighted and indented:-
+
<table cellpadding=2 bgcolor="Aquamarine">
*Click the '''Edit''' button. The '''Message Popup Rule''' properties window will appear (shown below).
+
<tr valign="top">
 +
<td>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
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 width=1000 cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><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:-
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>Open the '''Surveyor Main Menu''' in '''TANE''' (shown below left) or the '''Surveyor Edit Menu''' in '''TRS19''' and later '''Trainz''' versions (shown below right)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td>Select the option <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Edit Session&#160;</span> from the drop down menu list</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:EditSessionMenu.JPG|link=]]</td>
 +
<td>[[image:SessionEditMenuSP1.png|link=]]<br></td>
 +
</tr>
 +
</table> <!-- END Step 1 table -->
 +
</td>
 +
</tr>
 +
</table>
  
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Add the Trigger Check Rule:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>&#160;</td>
 +
<td>
 +
<table width=485> <!-- BEGIN Step 2 table -->
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint3Blue.png|link=]]</td>
 +
<td>In the '''Edit Session''' window (shown below left) <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Add&#160;</span> button</td>
 +
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table width=485>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint4Blue.png|link=]]</td>
 +
<td>In the Rule Selection window (shown below right):-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td width="640">[[file:MessagePopupText.JPG]]<br><br>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
The finished '''Message Popup'''.<br>
+
<td>Scroll down the list to select the '''Trigger Check''' rule, and</td>
[[file:MessagePopupStop.JPG]]
+
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
<td><br>Set the properties as shown:-
+
</tr>
*Check '''ON''' ''Close previous message popup windows''
+
</table>
*Select '''Option Button''' ''Custom text''
+
</td>
*Enter a short text message (you are limited to about 6 lines of text)
+
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:EditSessionWindowX.JPG|link=|480px]]</td>
 +
<td>[[image:RuleSelect.JPG|link=]]</td>
 +
</tr>
 +
<tr>
 +
<td colspan=2><br>This will add the '''Trigger Check''' rule to the session.</td>
 +
</tr>
 +
</table> <!-- END Step 2 table -->
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Open the Trigger Check Rule Properties:</span>
 +
<table> <!-- BEGIN Step 3 table -->
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint5Blue.png|link=]]</td>
 +
<td>With the '''Trigger Check''' rule highlighted (shown below) <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Edit&#160;</span> button. This will open the rule properties window
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>[[image:TriggerCheck.JPG|link=]]</td>
 +
</tr>
 +
</table> <!-- END Step 3 table -->
 +
</td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint4.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Configure the Rule:</span><br>
 +
<table> <!-- BEGIN Step 4 table -->
 +
<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):-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint6Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''''<span style="text-decoration: underline;">Add trigger</span>''''' link</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>[[image:TriggerCheckProperties.JPG|link=]]</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table cellpadding=2 bgcolor="Aquamarine"> <!-- BEGIN Table 4 Wiki Table -->
 +
<tr valign="top">
 +
<td>[[image: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>
 +
</table> <!-- END Table 4 Wiki Table -->
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 4 table -->
 +
</td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint5.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Select the Trigger:</span><br>
 +
The '''Trigger Selection Window''' will open and list all the '''Track Triggers''' in your Route.
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint7Blue.png|link=]]</td>
 +
<td>Select the Track Trigger you have just added</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint8Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon at the bottom of the selection window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>[[image:TriggerList.JPG|link=]]</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint9Blue.png|link=]]</td>
 +
<td>Once the Track Trigger has been added to the rule, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon in the '''Trigger Check''' properties window to accept the change and close the Session Editor.</td>
 +
</tr>
 +
</table> <!-- END Step 5 table -->
 +
</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
To add an icon to the message:-
+
<table width=1000> <!-- BEGIN Nav Buttons Table -->
*Click the link '''''<u>click here to set</u>''''' (shown left) and either
+
<tr valign="top">
**Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, or
+
<td width=629><span id="stepEvent"></span>
**Simply type "icon stop" in the text box to use one of the builtin icons.
+
='''Adding an Instruction to the Trigger Event'''=
*Click the '''Tick''' button.<br>
+
</td>
[[file:IconStop.JPG]]
+
<td width=50>[[image:SkipDown.png|link=#skipConfigure|Skip Down]]</td>
 +
<td width=50>&#160;</td> <!-- Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepCreating|alt=Next Up|Next Up]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepAlternatives|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 
 +
=='''Adding a Child Rule'''==
 +
 
 +
To test your trigger event you will need to add some Session Rules.
 +
 
 +
<table width=1000 cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Add A Message Popup Rule:</span>
 +
<table> <!-- BEGIN Step 1 table -->
 +
<tr valign="top">
 +
<td>When you are back in the '''Session Editor''' window:-
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>Make sure that the new '''Trigger Check Rule''' is selected (highlighted)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Add&#160;</span> button to add another new rule</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3Blue.png|link=]]</td>
 +
<td>Scroll down the rule selection window to find and select the '''Message Popup''' rule</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>[[image:TriggerAddMesPopup.JPG|link=]]</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan=2>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>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 1 table -->
 +
</td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Indent the Popup Message Rule:</span><br>
 +
<table> <!-- BEGIN Step 2 table -->
 +
<tr valign="top">
 +
<td colspan=2>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>
 +
[[image:SessionRuleIndent.JPG|link=]]</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>With the '''Message Popup Rule''' highlighted <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''''Indent''''' (''right arrow'') button. This should indent the '''Message Popup''' rule one level inwards (as shown below).
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>[[image:SessionRuleIndented.JPG|link=]]</td>
 +
</tr>
 +
<tr>
 +
<td colspan=2><br>
 +
The '''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>
 +
</table> <!-- END Steps Table -->
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipConfigure"></span>
 +
=='''Configuring the Message and Testing'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#stepAlternatives|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#stepEvent|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
Again, click the '''Tick''' button to exit the '''Message Popup Rule''' then exit the Session Editor.<br>
+
<table width=1000 cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><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">
 +
<td>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>With the '''Message Popup Rule''' highlighted and indented (as shown above) <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Edit&#160;</span> button. The '''Message Popup Rule''' properties window will appear (as shown below)</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
</table> <!-- END Step 1 table -->
 +
</td>
 +
</tr>
 +
</table>
  
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'''.
+
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table width=500>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Configure the Message:</span>
 +
<table> <!-- BEGIN Step 2 table -->
 +
<tr valign="top">
 +
<td>Set the properties as shown:-
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>Check '''ON''' ''Close previous message popup windows''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td>Select '''Option Button''' ''Custom text''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3Blue.png|link=]]</td>
 +
<td>Enter a short text message</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=475 colspan=2>[[image:MessagePopupText.JPG|475px|link=]]</td>
 +
</tr>
 +
</table> <!-- END Step 2 table -->
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table width=500>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">(Optional) Add a Message Icon:</span>
 +
<table> <!-- BEGIN Step 3 table -->
 +
<tr valign="top">
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the link '''''<span style="text-decoration: underline;">click here to set</span>''''' (shown left) and either:-
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:Ablue.png|link=]]</td>
 +
<td>Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, <span style="font-weight: 700; font-size: 15px;">OR</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Bblue.png|link=]]</td>
 +
<td>Simply type "icon stop" in the text box to use one of the builtin icons</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon to select the icon</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:IconStop.JPG|link=]]</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
  
Another example of using the '''Trigger Check Rule''' can be found in the '''Message Popup Rule Applications''' link below.
+
<table width=1000>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint4.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|link=]] icon to exit the '''Message Popup Rule''' and return to the '''Session Editor'''</td>
 +
</tr>
 +
</table>
 +
<!-- END Step 2 Wikilink Table -->
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>The completed Message Popup Rule<br>
 +
[[image:MessagePopupStop.JPG|link=]]</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
 +
<table cellpadding=2 bgcolor="Aquamarine"> <!-- BEGIN Step 2 Wikilink Table -->
 +
<tr valign="top">
 +
<td>[[image: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>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Test the Trigger:</span><br>
 +
<table> <!-- BEGIN Step 4 table -->
 +
<tr valign="top">
 +
<td>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>Exit the '''Session Editor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<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'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 4 table -->
 +
</td>
 +
</tr>
 +
</table> <!-- END Steps Table -->
 +
<br>
 +
Another example of using the '''Trigger Check Rule''' can be found in the '''Trainz Wiki Page''' [[image:WikiLink.PNG|link=]] '''[[How to Use Message Popup Rule (Applications)]]'''.
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=629><span id="stepAlternatives"></span>
 
='''Alternatives to the Trigger Check Rule'''=
 
='''Alternatives to the Trigger Check Rule'''=
 +
</td>
 +
<td width=50>&#160;</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipConfigure|Skip Up]]</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepEvent|alt=Next Up|Next Up]]</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
There are alternative rules that can be used in place of the '''Trigger Check Rule''' and triggers. A few possibilities are listed below:-
+
<table cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width=50>[[image:RulesWiki.PNG|link=]]</td>
 +
<td width=950>There are other '''Session Rules''' that can be used in place of the '''Trigger Check Rule''' and triggers. A few possibilities are listed below:-
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''[[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''' [[image:WikiLink.PNG|link=]] '''[[How to Control Signals in Sessions|Controlling Signals in Sessions]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''[[Session_Rule_List_with_Parameters#Trackside_Check_Rule|Trackside Check Rule]]''' - very similar to the '''Trigger Check Rule''' but provides some different options</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''Navigation Points''' (see the '''How to Guides''' link below) are more complex but provide more advanced controls and options</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''[[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</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''[[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</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''[[Session_Rule_List_with_Parameters#Timecheck Rule|Timecheck Rule]]''' - triggers an event at a set time.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width=50>[[image:CommandsWiki.png|link=]]</td>
 +
<td width=950>There is a '''driver command''' that can be used in place of the '''Trigger Check Rule''':-
 +
<table>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''[[Driver_Commands_List#WaitForTrigger|Wait For Trigger]]''' - forces an AI controlled train to wait until a specified trigger has been activated by another train</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</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 link '''Controlling Signals in Sessions''' below.
+
<table width=1000> <!-- BEGIN Nav Buttons Table -->
*'''[[Session_Rule_List_with_Parameters#Trackside_Check_Rule|Trackside Check Rule]]''' - very similar to the '''Trigger Check Rule''' but provides some different options.
+
<tr valign="top">
*'''Navigation Points''' (see links below) are more complex but provide more advanced controls and options.
+
<td width=729><span id="bottom"></span>&#160;</td>
*'''[[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.
+
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
*'''[[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.
+
<td width=75>[[image:NextUp.png|link=#stepAlternatives|alt=Next Up|Next Up]]</td>
*'''[[Session_Rule_List_with_Parameters#Timecheck Rule|Timecheck Rule]]''' - triggers an event at a set time.
+
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 
----
 
----
 
----
 
----
<br>
 
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table width=500 cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width=80>[[image:TrainzWiki.png|link=]]</td>
 +
<td>
 +
<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]]'''
<br>
+
</td>
<font size="3">'''Route Creation Tutorials:'''</font>
+
</tr>
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
</table>
*'''[[How to Merge Routes|Merging Routes]]'''
+
</td>
*'''[[How to Use Bulk Asset Update/Replace Tool|Using the Bulk Asset Update/Replace Tool]]'''
+
<td>
*'''[[How to Use Layers|Using Layers]]'''
+
<table width=500 cellpadding=4 bgcolor="aquamarine">
</div>
+
<tr valign="top">
<br>
+
<td width=50>[[image:LinkWiki.PNG|link=]]</td>
<font size="3">'''Session Creation Tutorials:'''</font>
+
<td>
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
<span style="font-size: 17px;">'''Related Links'''</span><br>
*'''[[How to Use Message Popup Rule|Adding Message Popups]]'''
+
* '''[[How to Use Track Direction Markers]]'''
*'''[[How to Use Message Popup Rule (Applications)|Adding Message Popups - Applications]]'''
+
* '''[[How to Use Track Markers]]'''
*'''[[How to Use Navigation Point Rules|Adding Navigation Points]]'''
+
* '''[[How to Use Track Priority Markers]]'''
*'''[[How to Use Navigation Point Rules (Applications)|Adding Navigation Points - Applications]]'''
+
</td>
*'''[[How to Use Driver Setup Rule|Configuring the Driver Setup Rule]]'''
+
</tr>
*'''[[How to Control Junctions in Sessions|Controlling Junctions in Sessions]]'''
+
</table>
*'''[[How to Control Signals in Sessions|Controlling Signals in Sessions]]'''
+
</td>
*'''[[How to Create a HTML Asset|Creating a HTML Asset (Session Introduction Page and In Game Messages)]]'''
+
</tr>
*'''[[Parent Rule List|List of Parent Rules]]'''
+
</table>
*'''[[How to Use Parent and Child Rules|Parent and Child Rules]]'''
+
----
*'''[[How to Use Variables in Sessions (Examples)|Using Variables in Sessions - Examples]]
+
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.
</div>
+
----
 
+
[[Category:How-to guides]][[Category:Rules]]
[[Category:How-to guides]]
+

Revision as of 20:30, 28 November 2023

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

          Next Down Bottom

Contents

BlueDot10x10.png Track Triggers are track markers that are invisible in Driver but visible in Surveyor
BlueDot10x10.png They are used to activate some Session Rules and Driver Commands
BlueDot10x10.png They can be placed in a Route layer or in a Session layer


What are Track Triggers?

    Top   Next Down Bottom
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.
Shown below left is a standard Track Trigger and below right is a Directional Track Trigger. They are just two examples of several types of track triggers. In both cases:-
DotPoint.JPG they are visible in Surveyor and invisible in Driver
DotPoint.JPG the "green wings" show their Effect Radius, the region where a consist will trigger an "event". The number in brackets show that radius in metres
RedDot10x10.png the Directional Track Trigger will normally only be triggered if the consist is moving in the direction indicated by the arrow
RedDot10x10.png the standard Track Trigger will be triggered regardless of the direction of movement
TrackTrigger.JPG
"Standard" Track Trigger
TrackDTrigger.png
Directional Track Trigger


Route or Session?

    Top Next Up Next Down Bottom
BlueDot10x10.png Track Triggers can be placed in a Route Layer or in a Session Layer


NotePad.PNG Notes:

DotPoint.JPG 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
DotPoint.JPG 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 triggers in each Session


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


Adding a Track Trigger

Skip Down   Top Next Up Next Down Bottom
NotePad.PNG Notes:

A Track Trigger has two important properties:-

DotPoint.JPG its name which is needed for all commands and rules that use the Track Trigger, and
DotPoint.JPG its Trigger Effect Radius (the green "wings" shown in the image above with the radius value, in metres, shown below the trigger name). This controls how closely an AI train has to approach the trigger to activate it (smaller radius = closer to the trigger)
PencilTips.PNG A "standard" Track Trigger has no visible direction and, while it can be rotated, this has NO EFFECT on its operation. The Directional Track Trigger does have a direction because it is only triggered by trains travelling in a specific direction


In Surveyor Classic (S10)

Skip Down Skip Up        

Adding a Track Trigger (S10)

TrackTriggerMode.JPG
Steps: To add a Trigger Mark:-
DotPoint1.JPG Open the Tracks Tool Flyout or press the  F4  key
DotPoint2.JPG Left Click on the Trackmark Mode button or press the  V  key
DotPoint3.JPG Left Click on the Trigger shown in the asset list
DotPoint4.JPG Left Click the  +  Add Object button - it may already be selected - or press the  A  key
DotPoint5.JPG Left Click on the track location where the marker is to be placed
This will place the Track Trigger on the track and open its properties window.


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


Set the Trigger Name and Layer (S10)

TrackTriggerProperties.JPG
DotPoint1.JPG To change the track trigger name Left Click on the name text entry box, delete the highlighted default name and enter a new name
DotPoint2.JPG To change its assigned layer Left Click on the layer text entry box (or use its scroll arrowheads) and select a new layer - see the Trainz Wiki Page WikiLink.PNG How to Use layers for more details on layers
DotPoint3.JPG To confirm the changes Left Click on the Tick.PNG icon or the  Save Changes  button (depending on your Trainz version) at the bottom of the window


Set the Effect Radius (S10)

At the bottom of the Track Tools flyout menu is an Advanced button. Left Click this button to open the advanced tools.

The Effect Radius sets the size of green "effect wings" attached both ends of the marker. This sets how close a consist has to approach the marker to trigger its "event". The smaller the radius the closer it must approach.


TrackMarkRadiusTools.png
Steps: To set a Track Trigger Effect Radius:-
DotPoint1.JPG In the Track Tools flyout, Left Click on the Advanced button to open the Radius tools and properties. You will have a choice of 4 methods to set and adjust the Effect Radius
Options: Choose one of:-
Ablue.png To copy the Effect Radius of an existing Track Trigger
DotPoint2.JPG Left Click the Get Effect Radius icon
DotPoint3.JPG Left Click on the Track Trigger whose radius you want to copy - the radius will be copied into the Effect Radius Value text box (the default value is 20.00 metres)
DotPoint4.JPG To apply the new value see option Cblue.png below
Bblue.png To manually alter the Effect Radius value
DotPoint2.JPG Type the new value (in metres) into the Effect Radius Value text box
DotPoint3.JPG To apply the new value see option Cblue.png below
Cblue.png To apply a value in the Effect Radius Value text box (from methods Ablue.png, Bblue.png or Dblue.png) to another Track Trigger
DotPoint2.JPG Left Click the Copy Radius Value icon
DotPoint3.JPG Left Click on the Track Trigger that is to receive the new value (you can click on more than one)
Dblue.png To adjust the Effect Radius value up or down
DotPoint2.JPG Left Click the Adjust Effect Radius button
DotPoint3.JPG Select the Track Trigger
DotPoint4.JPG Left Click and Drag Forward (to increase the value) or Backward (to reduce the value)
DotPoint5.JPG The new value will be immediately applied to the selected Track Trigger as the mouse moves (but only one Track Trigger at a time)


PencilTips.PNG Once you have an Effect Radius entered in the value box, you can apply it to any number of Track Triggers by using method Cblue.png shown above


In Surveyor 2.0 (S20)

Skip Down Skip Up        

Surveyor 2.0 is currently only available for Trainz Plus and TRS22 Platinum.

Adding a Track Trigger (S20)

DotPoint1.JPG In the Asset Palette either:-

Ablue.png Left Click on the Track Mesh Filter icon

Track mesh

OR
Bblue.png Left Click on the Content Drop-down Box

Filter List
Then select Track Objects
Track Objects

NotePad.PNG Notes:

If the Assets Palette is not shown on the screen, then:-

Windows Menu
Steps: To display palettes:-
DotPoint1.JPG open the SurveyorWindowIcon.png Window Menu from the menu icons at the top of the screen
 
BulletTick.png visible palettes have ticks next to their names
BulletNoTick.png invisible (hidden) palettes have no ticks next to their names
DotPoint2.JPG if the Assets Palette, or any required palette, does not have a tick next to its name then Left Click on the name of the palette or on the empty BulletNoTick.png box next to its name. This will add a BulletTick.png and make the palette visible

There is a Trainz Wiki Page specifically covering the S20 Palettes at
WikiLink.PNG How to Use the Surveyor 2.0 Palettes


PencilTips.PNG  Shortcut 
If you already have a Track Trigger Mark placed in your route then:-
DotPoint1Blue.png move the tool pointer over the existing trigger object and hold down the  Alt  key. The object name will appear in a ToolTip attached to the pointer
DotPoint2Blue.png  Alt  + Left Click (hold down the  Alt  key and Left Click on the trigger mark to identify it in the Assets Palette and to select the Placement Tool. Release the key.
Jump to Step DotPoint5.JPG below.


DotPoint2.JPG To narrow down the filter list, type "trig" (UPPER/lower case does not matter) in the Search Text Box

Text search
DotPoint3.JPG This will list all the Track Objects containing the text "trig" in the filter list.
Filtered list DotPoint4.JPG Left Click on the item name Trigger.

If you are not sure about an asset then Double Left Click on the name to bring up its image and description.

DotPoint5.JPG Place the Track Trigger on the track.

Tools and keymap for S20
NotePad.PNG Notes:

DotPoint.JPG To add a track trigger, or any object, you will need to select the Placement Tool
DotPoint.JPG To edit a track trigger once it has been placed you will usually use either the Free Move Tool or the Fine Adjustment Tool
Add priority marker
Steps: To add a Track Trigger:-
DotPoint1Blue.png Select the Placement Tool (or press the  E  key) from the Tools Palette
DotPoint2Blue.png Left Click on the track at the position where you want to place the trigger
Once placed a Track Trigger can be easily moved if needed.


NotePad.PNG Notes:

To delete a Track Trigger (or any asset):-

Steps:
DotPoint1.JPG select either the:-
Ablue.png Free Move Tool (or press  S ) OR
Bblue.png Fine Adjustment Tool (or press  D )
DotPoint2.JPG Left Click on the Track Trigger
DotPoint3.JPG press the  Delete  key


PencilTips.PNG If you need to rotate the Track Trigger to face the opposite direction (and this would apply only to Directional Track Triggers) then:-
Steps:
DotPoint1.JPG select the Track Trigger and Left Click on its Context Menu Icon (or press the  T  key)
DotPoint2.JPG from the popup menu select the  Rotate Trackside  option
Note: the direction a "standard" Track Trigger faces has no effect on its operation


Change Its Name (S20)

The name of the marker is only useful for finding it in the route. It is not used for any operational purpose.

TriggerName S20.png
Steps: To change the name of a Track Trigger:-
DotPoint3Blue.png using either the Free Move Tool or the Fine Adjustment Tool select (Left Click on) the Track Trigger to be renamed
DotPoint4Blue.png in the Info Palette (you may need to make this palette visible - see the Notes: for Step  1  above) Left Click in the Name: entry box. Enter a name for the Track Trigger and press the  Enter  key

Set its Effect Radius (S20)

The Effect Radius sets the size of green "effect wings" attached both ends of the marker. This sets how close a consist has to approach the marker to trigger its "event". The smaller the radius the closer it must approach.


TriggerRadius S20.png
Steps: To adjust the effect radius of a Track Trigger:-
DotPoint5Blue.png Left Click and Drag Forward or Backward on the Green Dot next to the Track Trigger to increase or reduce its Trigger Effect Radius

Move a Track Trigger Along the Track (S20)

Priority Marks can be moved along the track or to other tracks.

TriggerMove S20.png
Steps: To move the Priority Mark:-
DotPoint6Blue.png Left Click and Drag Forward or Backward on the Yellow Dot next to the Priority Mark to move it along the track or to another track

Move the Track Trigger Vertically (S20)

Track Triggers can be physically placed above (or below) the track. This feature allows them to be placed, for example, above the track so that they will not be hidden in Surveyor if a consist is parked on a marker.
TriggerFineAdjustVertical S20.png
Steps: To move a Track Trigger vertically:-
NotePad.PNG This option is only available with the Fine Adjustment Tool - the  D  key
DotPoint7Blue.png Left Click and Drag Forward or Backward on the  Blue  Vertical Axis Line above the Track Trigger to it up or down
PencilTips.PNG If you need to return the Track Trigger to its original position then:-
Steps: To correctly reattach the Track Trigger to the track:-
DotPoint1.JPG select the object and open (Left Click on) its Context Menu Icon (or press the  T  key)
DotPoint2.JPG from the popup menu select  Reattach to Track 

Move the Track Trigger Horizontally (S20)

Track Triggers can be physically placed left or right alongside the track. This feature allows them to be placed, for example, beside the track so that they will not be hidden in Surveyor if a consist is parked on a marker.
TriggerFineAdjustHorizontal S20.png
Steps: To move a Track Trigger horizontally:-
NotePad.PNG This option is only available with the Fine Adjustment Tool - the  D  key
DotPoint8Blue.png Left Click and Drag Forward or Backward on the  Red  Horizontal Axis Line attached to the track Trigger to move it left or right
DotPoint9Blue.png Left Click and Drag Forward or Backward on the  Green  Horizontal Axis Line attached to the Track Trigger to move it forward or back
PencilTips.PNG If you need to return the Priority Mark to its original position then:-
Steps: To correctly reattach the Track Trigger to the track:-
DotPoint1.JPG select the object and open (Left Click on) its Context Menu Icon (or press the  T  key)
DotPoint2.JPG from the popup menu select  Reattach to Track 


NotePad.PNG Notes:

The  Green  Horizontal Axis Line shown as DotPoint9Blue.png in the image pointing forward from the TrackTrigger will move it forward/backward regardless of whether it is on the track or not. It has the same effect as DotPoint6Blue.png Move a Track Trigger Along the Track. However, by using this tool it is possible to move the Track trigger beyond the end of the track if that is ever required.

Assign a Track Trigger to a New Layer (S20)

The Info Palette will show the layer assigned to the currently selected object. To the left of the layer name is a small arrowhead object.
Info palette

Layer control
Steps: To assign a Track Trigger to a layer:-
In the Info Palette:-
DotPoint1.JPG Left Click the small arrowhead next to the layer name. This will open the layer properties for the selected object
DotPoint2.JPG Left Click the Layer drop down box to select a new layer for the object
DotPoint3.JPG if required, Left Click the Binding drop down box to select a new binding layer for the object. It cannot be bound to its own layer
DotPoint4.JPG if required, Left Click the  Lock Layer  button to lock the selected layer. If the layer is already locked then this will be shown as an  Unlock Layer  button


Stop.PNG WARNING:
DotPoint.JPG You will not be allowed to place a track object in a layer that is higher up the list than the layer containing the track
DotPoint.JPG Moving an object from one layer group to another (e.g. from the Route Layer Group to the Session Layer Group) will change where the object is saved (in the Route or in the Session)


LinkWiki.PNG Information on layers can be found at:-


Creating a Track Trigger Event

  Skip Up Top Next Up Next Down Bottom
When a consist enters the Effect Radius of a Track Trigger it will create an "event" that can be detected and responded to by some Session Rules and some Driver Commands. One such rule is the Trigger Check 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:
DotPoint1.JPG Open the Session Editor:
To add the Trigger Check Rule to a session:-
DotPoint1Blue.png Open the Surveyor Main Menu in TANE (shown below left) or the Surveyor Edit Menu in TRS19 and later Trainz versions (shown below right)
DotPoint2Blue.png Select the option  Edit Session  from the drop down menu list
EditSessionMenu.JPG SessionEditMenuSP1.png
DotPoint2.JPG Add the Trigger Check Rule:
 
DotPoint3Blue.png In the Edit Session window (shown below left) Left Click on the  Add  button
DotPoint4Blue.png In the Rule Selection window (shown below right):-
BlueDot10x10.png Scroll down the list to select the Trigger Check rule, and
BlueDot10x10.png Left 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:
DotPoint5Blue.png With the Trigger Check rule highlighted (shown below) Left 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):-
DotPoint6Blue.png Left Click on 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 open and list all the Track Triggers in your Route.

DotPoint7Blue.png Select the Track Trigger you have just added
DotPoint8Blue.png Left Click on the Tick.PNG icon at the bottom of the selection window
TriggerList.JPG
DotPoint9Blue.png Once the Track Trigger has been added to the rule, Left Click on the Tick.PNG icon in the Trigger Check properties window to accept the change and close the Session Editor.


Adding an Instruction to the Trigger Event

Skip Down   Top Next Up Next Down Bottom

Adding a Child Rule

To test your trigger event you will need to add some Session Rules.

Steps:
DotPoint1.JPG Add A Message Popup Rule:
When you are back in the Session Editor window:-
DotPoint1Blue.png Make sure that the new Trigger Check Rule is selected (highlighted)
DotPoint2Blue.png Left Click the  Add  button to add another new rule
DotPoint3Blue.png Scroll down the rule selection window to find and select the Message Popup rule
TriggerAddMesPopup.JPG
DotPoint4Blue.png Left Click on the Tick.PNG icon
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
DotPoint1Blue.png With the Message Popup Rule highlighted Left Click on the Indent (right arrow) button. This should indent the Message Popup rule one level inwards (as shown below).
SessionRuleIndented.JPG

The 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.


Configuring the Message and Testing

Skip Down Skip Up        
Steps:
DotPoint1.JPG Open the Message Popup Rule for Editing:
DotPoint1Blue.png With the Message Popup Rule highlighted and indented (as shown above) Left 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:-
DotPoint1Blue.png Check ON Close previous message popup windows
DotPoint2Blue.png Select Option Button Custom text
DotPoint3Blue.png Enter a short text message
MessagePopupText.JPG
DotPoint3.JPG (Optional) Add a Message Icon:
DotPoint1Blue.png Left Click the link click here to set (shown left) and either:-
Ablue.png Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, OR
Bblue.png Simply type "icon stop" in the text box to use one of the builtin icons
DotPoint2Blue.png Left Click on the Tick.PNG icon to select the icon
IconStop.JPG
DotPoint4.JPG Left 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


LinkWiki.PNG

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


DotPoint5.JPG Test the Trigger:
DotPoint1Blue.png Exit the Session Editor
DotPoint2Blue.png 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


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).

Alternatives to the Trigger Check Rule

  Skip Up Top Next Up   Bottom
RulesWiki.PNG There are other Session Rules that can be used in place of the Trigger Check Rule and triggers. A few possibilities are listed below:-
DotPoint.JPG 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
DotPoint.JPG Trackside Check Rule - very similar to the Trigger Check Rule but provides some different options
DotPoint.JPG Navigation Points (see the How to Guides link below) are more complex but provide more advanced controls and options
DotPoint.JPG Multiple Resource Check Rule - monitors and acts on changes in multiple industry or multiple wagon resource (commodity) levels
DotPoint.JPG Resource Verify Rule - monitors and acts on changes in a single industry or wagon resource (commodity) level
DotPoint.JPG 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:-
DotPoint.JPG Wait For Trigger - forces an AI controlled train to wait until a specified trigger has been activated by another train
  Top Next Up    


Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz

LinkWiki.PNG

Related Links


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


Personal tools