Latest revision as of 11:07, 4 October 2023

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22. It gives examples of how to use the various Navigation Point Rules in Sessions.

[edit] Application 1: Clearing Unused Navigation Sets

	The Scenario:
	A user decides to ignore navigation points at a location and drives straight through. When the consist passes over a trigger the unused navigation point sets are removed

Preconditions:

Navigation Display Rule creates the navigation point sets

Rules Used:

	Navigation Display Rule creates the navigation point sets (in Preconditions above)
	Trigger Check Rule to trigger the event
	Navigation Set Clear Rule to manually complete navigation sets

	Session Editor Screenshot:

Description:

Line 1 : Trigger Check the event is triggered by the consist leaving the location with the navigation points. This executes the following lines:-

Line 2 : Navigation Set Clear a navigation set is manually completed and any visible icons are removed. This can be performed on any sets that have already been completely or partially completed

Lines 3 and 4 repeat the step in Line 2 for the other navigation sets

[edit] Application 2: Checking for Incomplete Sets

	The Scenario:
	A check is made to see if all the navigation points in a navigation set have been completed. If not then the set will be manually completed and a message displayed

Preconditions:

Navigation Display Rule creates the navigation point sets

Rules Used:

	Navigation Display Rule creates the navigation point sets (in Preconditions above)
	Trigger Check Rule to trigger the event
	Navigation Set Check Rule to check if a navigation set has been completed
	Navigation Set Clear Rule to manually complete navigation sets
	Message Popup Rule to open a message window on the screen

	Session Editor Screenshot:

Description:

Line 1 : Trigger Check the event is triggered by the consist leaving the location with the navigation points. This executes the following lines:-

Line 2 : Navigation Set Check the identified navigation set is checked to see if all its points have been completed. If NOT then the following lines will be executed simultaneously:-

Line 3 : Navigation Set Clear the navigation set is cleared so all of its navigation points will be cleared (completed)

Line 4 : Message Popup Rule a suitable message is displayed on the screen

[edit] Application 3: Wait for Loading to be Completed

	The Scenario:
	A user controlled train arrives at a Navigation Point positioned at a coal loader. Coal loading proceeds. The Navigation Point remains in place until the last wagon is loaded

Preconditions:

	Navigation Display Rule creates the navigation point set. The Navigation Point is created with its Style set to manual which means it will be completed by another rule and not the arrival of the consist

Rules Used:

Navigation Display Rule creates the navigation point sets (in Preconditions above)

Trigger Check Rule to trigger the message event

Multiple Resource Check Rule to monitor the load level in the last wagon

The Multiple Resouce Check Rule is configured to watch the load of coal in the last wagon of the consist exceeding a set value that is close to the maximum for that wagon (apologies for the colour scheme)

Navigation Point Complete Rule to manually complete a navigation point

Message Popup Rule to open a message window on the screen

The more obvious Wait on Navigation Point Rule is not used because the Navigation Point will be completed manually some time after the consist has arrived at the location. By using the Trigger Check Rule instead (the Navigation Point is attached to a trigger), the navigation icon remains on the screen until the loading has been completed and then it will be manually cleared.

	Session Editor Screenshot:

Description:

Line 1 : Trigger Check the event is triggered by the arrival of the consist at the coal loader (the Navigation Point). This executes the following lines:-

Line 2 : Multiple Resource Check when the last wagon has been loaded the following lines are executed simultaneously:-

Line 3 : Navigation Point Complete the Navigation Point is completed and its icon is removed from the screen

Line 4 : Message Popup a "Loading completed" message appears on the screen

[edit] Application 4: User Path Selection

	The Scenario:
	A user controlled train stops at a navigation point in front of a junction and the driver is offered a choice of paths to allow a passing movement by an AI controlled train. Each path is indicated by different sets of navigation points. The path selected will determine other operations such as junction settings and AI train commands

Preconditions:

The Navigation Display Rule is used to create the navigation point sets

Three sets of navigation points are created, one for each location marked on the map diagram above
	Set A: at the junction, Point A, in the map diagram. The two signals are set to STOP, Switch 2 is locked in position and the user is presented with a choice of using the Main Line or the Loop Line
	Set B: Point B on the Main Line in the map diagram. Switch 2 is set to the Loop Line and the AI train is given its instructions to pass on the Loop
	Set C: Point C on the Loop Line in the map diagram. Switch 2 is set to the Main Line and the AI train is given its instructions to pass on the Main

Rules Used:

	Navigation Display Rule creates the navigation point sets (in Preconditions above)
	Navigation Set Hide/Show Rule to hide and display the navigation point sets
	Wait on Navigation Point Rule to trigger the message event
	Navigation Set Clear Rule to manually terminate a navigation point set
	Message Popup Rule to open a message window on the screen
	Set Junctions Rule to set and lock junctions
	Set Signal Extended Rule to set signals
	Wait Rule to introduce a short delay
	Driver Schedule Rule to give commands to the AI controlled train

Session Editor Screenshot:

[edit] Creating the Navigation Point Sets

	Notes:
	Each set is created separately using separate copies of the Navigation Display Rule
	Sets B and C are hidden from view using the Navigation Set Show/Hide Rule
	Each navigation point is attached to a track trigger - Point 1 in Set A is attached to a trigger placed in front of Switch 1 in the map diagram

Navigation Point Set A is shown below. Sets B and C are similar.

[edit] At Navigation Set A Point 1 The Junction

Description:

Line 1 : Wait on Navigation Point The event is triggered when the consist reaches (and stops at) Navigation Point 1 in Set A. When triggered, this simultaneously executes the following lines:-

Line 2 : Navigation Set Hide/Show The Navigation Set B is made visible

Line 3 : Navigation Set Hide/Show The Navigation Set C is made visible

Line 4 : Set Junctions The junction Switch 2 is locked against user and AI control

Line 5 : Set Signals Extended Signal A is set to STOP

Line 6 : Set Signals Extended Signal B is set to STOP

Line 7 : Message Popup A message browser window is shown giving instruction to the user to set Switch 1 to the Loop Line or the Main Line and then move the consist forward to the next signal

[edit] At Navigation Set B Point 1 The Stop signal on the Main Line

Description:

Line 1 : Wait on Navigation Point The event is triggered when the consist reaches (and stops at) Navigation Point 1 in Set B. When triggered, this simultaneously executes the following lines:-

Line 2 : Navigation Set Clear The Navigation Set C is deleted and its visible Navigation Point disappears from the screen as the Loop Line path was not selected

Line 3 : Message Popup A message browser window is shown giving instruction to the user to wait until the passing train has cleared Switch 1

Line 4 : Set Junctions The junction Switch 2 is set to the Loop Line but is still locked against user and AI control

Line 5 : Wait A wait of 20 seconds then the following line is executed:-

Line 6 : Driver Schedule The AI train is given commands to move to the next destination via the Loop Line

[edit] At Navigation Set C Point 1 The Stop Signal on the Loop Line

Description:

Line 1 : Wait on Navigation Point The event is triggered when the consist reaches (and stops at) Navigation Point 1 in Set C. When triggered, this simultaneously executes the following lines:-

Line 2 : Navigation Set Clear The Navigation Set C is deleted and its visible Navigation Point disappears from the screen as the Main Line path was not selected

Line 3 : Message Popup A message browser window is shown giving instruction to the user to wait until the passing train has cleared Switch 1

Line 4 : Set Junctions The junction Switch 2 is set to the Main Line but is still locked against user and AI control

Line 5 : Wait A wait of 20 seconds then the following line is executed:-

Line 6 : Driver Schedule The AI train is given commands to move to the next destination via the Main Line

[edit] Trainz Wiki

More Tutorials and Guides to Using Trainz

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

@@ Line 374: / Line 374: @@
 </table>
+<table width=1000 cellpadding=2 bgcolor=#ffffff>
+<tr valign="top">
+<td width=60 rowspan=4>[[image:conditions.PNG|link=]]</td>
+<td colspan=2><span style="font-size: 17px;">'''Preconditions:'''</span></td>
+</tr>
+<tr valign="top">
+<!-- <td>&#160;</td> -->
+<td>
+<table>
+<tr valign="top">
+<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
+<td>'''The [[Session_Rule_List_with_Parameters#Navigation_Display_Rule|Navigation Display Rule]]''' is used to create the navigation point sets
 <table width=1000>
 <tr valign="top">
@@ Line 380: / Line 392: @@
 <tr valign="top">
 <td width=10>[[image:BlueDot10x10.png|link=]]</td>
-<td>'''Set A:''' at the junction, Point '''A''' in the map diagram. The two signals are set to STOP, '''Switch 2''' is locked in position and the user is presented with a choice of using the Main Line or the Loop Line</td>
+<td>'''Set A:''' at the junction, Point '''A''', in the map diagram. The two signals are set to STOP, '''Switch 2''' is locked in position and the user is presented with a choice of using the Main Line or the Loop Line</td>
 </tr>
 <tr valign="top">
 <td>[[image:BlueDot10x10.png|link=]]</td>
-<td>'''Set B:''' at the end signal on the Main Line. '''Switch 2''' is set to the Loop Line and the AI train is given its instructions to pass on the Loop</td>
+<td>'''Set B:''' Point '''B''' on the Main Line in the map diagram. '''Switch 2''' is set to the Loop Line and the AI train is given its instructions to pass on the Loop</td>
 </tr>
 <tr valign="top">
 <td>[[image:BlueDot10x10.png|link=]]</td>
-<td>'''Set C:''' at the end signal on the Loop Line. '''Switch 2''' is set to the Main Line and the AI train is given its instructions to pass on the Main</td>
+<td>'''Set C:''' Point '''C''' on the Loop Line in the map diagram. '''Switch 2''' is set to the Main Line and the AI train is given its instructions to pass on the Main</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td>
 </tr>
 </table>

How to Use Navigation Point Rules (Applications)

Latest revision as of 11:07, 4 October 2023

Contents

[edit] Application 1: Clearing Unused Navigation Sets

[edit] Application 2: Checking for Incomplete Sets

[edit] Application 3: Wait for Loading to be Completed

[edit] Application 4: User Path Selection

[edit] Creating the Navigation Point Sets

[edit] At Navigation Set A Point 1 The Junction

[edit] At Navigation Set B Point 1 The Stop signal on the Main Line

[edit] At Navigation Set C Point 1 The Stop Signal on the Loop Line

[edit] Trainz Wiki

Views

Personal tools

Navigation

Search

Toolbox