How to Use Track Triggers

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (Trainz Wiki)
m
Line 1: Line 1:
  
='''What are Triggers?'''=
+
='''What are Track Triggers?'''=
  
 
----
 
----
Line 6: Line 6:
 
<tr>
 
<tr>
 
<td>[[file:DotPoint.JPG]]</td>
 
<td>[[file:DotPoint.JPG]]</td>
<td>'''Triggers are track markers that are invisible in ''Driver Mode'' but visible in ''Surveyor Mode''.'''</td>
+
<td>'''Track triggers are track markers that are invisible in ''Driver Mode'' but visible in ''Surveyor Mode''.'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
----
 
----
  
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 trigger.  
+
Track triggers can be programmed to respond when a train (any train or a specific train) passes over them in Driver Mode. The response comes from executing a set of '''Session Rules''' that have been attached to a '''Trigger Check Rule''' or a similar rule that is monitoring the track trigger.  
  
 
<table>
 
<table>
Line 17: Line 17:
 
<td>[[file:TrackTrigger.JPG]]</td>
 
<td>[[file:TrackTrigger.JPG]]</td>
 
<td><br>
 
<td><br>
Shown at left is a '''Track Trigger''' placed on a track in '''Surveyor Mode'''. The trigger is not visible in '''Driver Mode'''. The "5.00m" shown below the trigger name is the trigger detection radius
+
Shown at left is a '''Track Trigger''' placed on a track in '''Surveyor Mode'''. It is NOT visible in '''Driver Mode'''. The "5.00m" shown below the trigger name is the trigger detection radius
 
</tr>
 
</tr>
 
</table>
 
</table>
  
='''Adding a Trigger'''=
+
='''Adding a Track Trigger'''=
  
 
<table>
 
<table>
Line 32: Line 32:
 
*Select the '''Trigger''' object from the list of installed objects
 
*Select the '''Trigger''' object from the list of installed objects
 
*Click the '''Add Object''' button  
 
*Click the '''Add Object''' button  
*Click the track position where the trigger is to be placed.
+
*Click the track position where the track trigger is to be placed.
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
='''Configuring a Trigger'''=
+
='''Configuring a Track Trigger'''=
  
As soon as a new trigger has been placed, its properties window (shown below) will open on the screen. It will be given a default name and assigned to the currently active layer.
+
As soon as a new track trigger has been placed, its properties window (shown below) will open on the screen. It will be given a default name and assigned to the currently active layer.
  
 
<table>
 
<table>
Line 45: Line 45:
 
<td>[[file:TrackTriggerProperties.JPG]]</td>
 
<td>[[file:TrackTriggerProperties.JPG]]</td>
 
<td>
 
<td>
*To change the trigger name click on the name box, delete the highlighted default name and enter a new name.
+
*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.
 
*To change the assigned layer click on the layer box and select a new layer.
Line 56: Line 56:
 
</table>
 
</table>
  
Triggers have a "detection radius" that controls how close a train has to approach to trigger the event. The smaller the radius the closer the train. This radius is set in the '''Advanced Properties''' section of the '''Tools''' window (shown below).
+
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. This radius is set in the '''Advanced Properties''' section of the '''Tools''' window (shown below).
  
 
<table>
 
<table>
Line 65: Line 65:
 
*Enter a new radius value in metres.
 
*Enter a new radius value in metres.
 
*Click the '''Set Trigger Radius''' button
 
*Click the '''Set Trigger Radius''' button
*Click on the trigger that has been placed on the track to assign its new radius.
+
*Click on the track trigger to assign its new radius.
 
<br>
 
<br>
 
'''Note:'''<br>
 
'''Note:'''<br>
A small radius should only be used for slower moving trains. Fast trains may pass over a small radius trigger without being detected.
+
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>
 
</td></tr>
 
</table>
 
</table>
  
='''Creating a Trigger Event'''=
+
='''Creating a Track Trigger Event'''=
  
Trigger events are handled by the '''Trigger Check Rule''' (or a similar rule) which is added to a session in the '''Session Editor'''.<br>
+
Track trigger events are handled by the '''Trigger Check Rule''' (or a similar rule) which is added to a Session in the '''Session Editor'''.<br>
  
 
The Trainz Wiki Link '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' contains detailed information on this rule.
 
The Trainz Wiki Link '''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' contains detailed information on this rule.
Line 115: Line 115:
 
</table>
 
</table>
 
<br>
 
<br>
For this example we will leave all settings unchanged and simply identify the trigger to be used.  
+
For this example we will leave all settings unchanged and simply identify the track trigger to be used.  
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
Line 201: Line 201:
 
Again, click the '''Tick''' icon to exit the '''Message Popup Rule''' then exit the Session Editor.<br>
 
Again, click the '''Tick''' icon to exit the '''Message Popup Rule''' then exit the Session Editor.<br>
  
Add a consist to your layout a short distance from the trigger (but further away than its radius), save the Surveyor Session, and then test in '''Driver Mode'''.
+
Add a consist to your layout a short distance from the track trigger (but further away than its radius), save the Surveyor Session, and then test in '''Driver Mode'''.
  
 
Another example of using the '''Trigger Check Rule''' can be found in the '''Message Popup Rule Applications''' link below.
 
Another example of using the '''Trigger Check Rule''' can be found in the '''Message Popup Rule Applications''' link below.
Line 217: Line 217:
 
----
 
----
 
----
 
----
 
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
 
*'''<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>'''
Line 231: Line 230:
 
*'''[[How to Control Junctions in Sessions]]'''
 
*'''[[How to Control Junctions in Sessions]]'''
 
*'''[[How to Control Signals in Sessions]]'''
 
*'''[[How to Control Signals in Sessions]]'''
*'''[[How to Use Variables in Sessions (Examples)]]'''
+
*'''[[How to Use Variables in Sessions (Examples)]]
 
*'''[[Message Popup Rule Applications]]'''
 
*'''[[Message Popup Rule Applications]]'''
 
*'''[[Message Popup Example|Message Popup Rule Examples]]'''
 
*'''[[Message Popup Example|Message Popup Rule Examples]]'''
Line 239: Line 238:
 
**'''[[Parent Rule List]]'''
 
**'''[[Parent Rule List]]'''
 
</div>
 
</div>
 
[[Category:How-to guides]]
 

Revision as of 17:46, 15 June 2018

Contents

What are Track Triggers?


DotPoint.JPG Track triggers are track markers that are invisible in Driver Mode but visible in Surveyor Mode.

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.

TrackTrigger.JPG

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

Adding a Track Trigger

TrackTriggerMode.JPG

The Track Trigger is placed on the track using:-

  • the Track tool, and
  • the Trackmark Mode button.
  • Select the Trigger object from the list of installed objects
  • Click the Add Object button
  • Click the track position where the track trigger is to be placed.

Configuring a Track Trigger

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

TrackTriggerProperties.JPG
  • To change the track trigger name click on the name box, delete the highlighted default name and enter a new name.
  • To change the assigned layer click on the layer box and select a new layer.
  • Leave the "Bound Layer" at <none>.
  • To confirm the changes click on the Tick icon on the bottom right of the window.

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. This radius is set in the Advanced Properties section of the Tools window (shown below).

TrackTriggerRadius.JPG
  • Click the Advanced Tab to open its properties.
  • Enter a new radius value in metres.
  • Click the Set Trigger Radius button
  • Click on the track trigger to assign its new radius.


Note:
A small radius should only be used for slower moving trains. Fast trains may pass over a small radius track trigger without being detected.

Creating a Track Trigger Event

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

The Trainz Wiki Link Trigger Check Rule contains detailed information on this rule.

EditSessionMenu.JPG

To add the Trigger Check Rule to a session:-

  • Open the Surveyor Main Menu.
  • Select the option Edit Session from the drop down menu list.
EditSessionWindowX.JPG

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 icon.
RuleSelect.JPG


This will add the Trigger Check rule to the session.

TriggerCheck.JPG

With the Trigger Check rule highlighted (shown left):-

  • Click the Edit button. This will open its properties window.


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

TriggerCheckProperties.JPG


Once the trigger has been identified, click the Tick icon in the Trigger Check properties window (shown above) to accept the change.

In the Trigger Properties window (shown left):-

  • Click the Add trigger link

In the Trigger Selection window (shown below):-

  • Select the trigger you have just added
  • Click the Tick icon on the selection list
TriggerList.JPG


Adding an Instruction to the Trigger Event

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

Adding a Child Rule

TriggerAddMesPopup.JPG

When you are back in the Session Editor window:-

  • Click the Add button to add a new rule.
  • Scroll down the rule selection window to select the Message Popup rule
  • Click the Tick 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.

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

SessionRuleIndent.JPG

With the Message Popup Rule highlighted (shown left):-

  • Click the Indent (right arrow) button.

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

SessionRuleIndented.JPG


Configuring the Message

With the Message Popup Rule highlighted and indented:-

  • Click the Edit button.
MessagePopupText.JPG

The finished Message Popup.
MessagePopupStop.JPG


In the Message Popup Properties window (shown left), set the properties as shown:-
  • Check ON Close previous message popup windows
  • Select Option Button Custom text
  • Enter a short text message (you are limited to about 6 lines of text)


To add an icon to the message:-

  • Click the link click here to set (shown left) and either
    • Scroll down the Texture Asset Selection List (shown below) to find a suitable icon, or
    • Simply type "icon stop" in the text box to use one of the builtin icons.
  • Click the Tick icon.

IconStop.JPG


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

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

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

Alternatives to the Trigger Check Rule

There are alternative rules that can be used in place of the Trigger Check Rule and triggers. A few possibilities are listed below:-

  • Directional Trigger Check Rule - identical to the Trigger Check Rule but adds the ability to test the train direction. Requires the use of a special Directional Trigger. For an example of its use see the link Controlling Signals in Sessions below.
  • Trackside Check Rule - very similar to the Trigger Check Rule but provides some different options.
  • Navigation Points (see links below) are more complex but provide more advanced controls and options.
  • Multiple Resource Check Rule - monitors and acts on changes in multiple industry or multiple wagon resource (commodity) levels.
  • Resource Verify Rule - monitors and acts on changes in a single industry or wagon resource (commodity) level.
  • Timecheck Rule - triggers an event at a set time.


Trainz Wiki

Route Creation Tutorials:

Session Creation Tutorials:

Personal tools