Revision as of 08:05, 21 September 2023

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22. It describes how to configure the various Navigation Point Rules.

For examples of how to use these rules in Trainz Sessions, see the Trainz Wiki Page at:-

How to Use Navigation Point Rules (Applications)

Navigation Display Rule

	The Navigation Set Hide/Show Rule is added to a Session and configured using the Session Editor in Surveyor
	The Navigation Display Rule create a set of Navigation Points

	Notes:
	A navigation set must be created by the Navigation Display Rule before it can be used by the other navigation rules
	Multiple sets can be created by adding additional copies of this rule - one copy for each set
	This rule creates the navigation set and displays it. If you have created multiple sets then all of them will be displayed unless you use the Navigation Set Hide/Show Rule to hide those sets you do not want to be seen immediately

Notes:

The Upper section of the Rule Dialogue Box identifies the Navigation Display Set and how it will operate

Settings:

For the Navigation Set:

Set ID: Each Navigation Point Set must have a unique ID code. This consists of any text characters EXCEPT the SPACE character and UPPER CASE characters

Train (optional): You can add a specific locomotive that this Navigation Point set will be applied to

Navigation mode: Select one of three options:-

All points must be completed in sequence - the order of the points listed below is the order in which they must be executed. No exceptions

Points will be completed in sequence, but can be skipped - the order of the points below is the order in which they must be executed but points can be skipped. You cannot go back to complete a missed point

All points must be completed but in any order - the order is not important but no points can be missed. All the Navigation Points in the set will be displayed when this option is selected

Notes:

The lower section of the Rule Dialogue Box defines the individual Navigation Points in this Navigation Display Set

Settings:

For each Navigation Point:

Location: - this can be a trackmark, a trigger, track object or a rolling stock vehicle

Icon: - a graphic icon to be displayed representing the Navigation point. Icons are selected from a preset list

Display text: - a short message up to 25 characters long

Style: - the operational style of the Navigation Point. Select one of:-

	Automatic - the Navigation Point will be completed and disappear when the consist reaches its location
	Manual - the Navigation Point must be completed by another rule
	Require Stop - the Navigation Point will be completed and disappear when the consist stops at its location

Navigation points can be added and deleted, but their order cannot be changed

	Add Navigation Point - new points are added by a Left Click on the + icon. The new point will be inserted in the line below
	Delete Navigation Point - existing points can be deleted by Left Click on the x icon

Navigation Set Hide/Show Rule

	The Navigation Set Hide/Show Rule is added to a Session and configured using the Session Editor in Surveyor
	The Navigation Set Hide/Show Rule hides and displays the navigation sets created by the Navigation Display Rule

Notes:

All Navigation Sets created by the Navigation Display Rule are visible in Driver by default. If you want to hide any sets until they are needed then use this rule to Hide them immediately after the sets have been created.

Settings:

Hide/Show: Left Click to select one of these two options:-

	Hide will make the entire set invisible
	Show will display the next navigation point or more depending on the Navigation Mode (see Navigation Display Rule above) that has been selected for this particular set

Set ID: The unique Navigation Point Set ID code for the set to be hidden or shown. This must be the same ID as entered in the

Navigation Display Rule and consists of any text characters EXCEPT the SPACE character and UPPER CASE characters

Navigation Set Clear Rule

	The Navigation Set Clear Rule is added to a Session and configured using the Session Editor in Surveyor
	The Navigation Set Clear Rule clears or completes any uncompleted Navigation Points in a set created by the Navigation Display Rule

Notes:

Visible Navigation Sets will be cleared automatically when they have been completed. However, you can clear an unfinished set at any time using this rule.

Settings:

Set ID: The unique Navigation Point Set ID code for the set to be cleared. This must be the same ID as entered in the

Navigation Display Rule and consists of any text characters EXCEPT the SPACE character and UPPER CASE characters

Navigation Point Complete Rule

	The Navigation Point Complete Rule is added to a Session and configured using the Session Editor in Surveyor
	The Navigation Point Complete Rule clears or completes the selected Navigation Point in a set created by the Navigation Display Rule. This rule is used to complete Navigation Points with their Style property set to manual

Notes:

Navigation Points with their Style: set to Automatic or Require Stop will be cleared automatically when they have been completed. Those set to Manual must be cleared by using this rule.

Settings:

	Navigation Point Number A valid number identifying the particular Navigation Point to be completed. If the number entered does not exist then the rule will be ignored
	Set ID: The unique Navigation Point Set ID code for the set. This must be the same ID as entered in the Navigation Display Rule and consists of any text characters EXCEPT the SPACE character and UPPER CASE characters

Navigation Set Check Rule

The Navigation Set Check Rule checks if the specified Navigation set has been completed or not completed then executes any following child rules.
The Navigation Set Check Rule is added to a Session and configured using the Session Editor in Surveyor. It is a Parent Rule.


	Settings: Set ID: The unique Navigation Point Set ID code for the set to be checked. This must be the same ID as entered in the Navigation Display Rule and consists of any text characters EXCEPT the SPACE character and UPPER CASE characters Complete/Incomplete: Left Click to select one of these two options. The selected Navigation Point Set will be tested to see if it has been Completed (all of its Navigation Points have been cleared/completed) or if it is Incomplete (not all of its Navigation Points have been cleared/completed)

Wait on Navigation Point Rule

The Wait on Navigation Point Rule waits until the specified Navigation Point in the specified set has been completed then executes any following child rules.
The Wait on Navigation Point Rule is added to a Session and configured using the Session Editor in Surveyor. It is a Parent Rule.


	Settings: Navigation Point Number A valid number identifying the particular Navigation Point to be completed. If the number entered does not exist then the rule will be ignored Set ID: The unique Navigation Point Set ID code for the set. This must be the same ID as entered in the Navigation Display Rule and consists of any text characters EXCEPT the SPACE character and UPPER CASE characters

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 394: / Line 394: @@
 ='''Navigation Point Complete Rule'''=
-The [[file:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Navigation Point Complete Rule|Navigation Point Complete Rule]]''' clears or completes the selected Navigation Point in a set created by the '''Navigation Display Rule'''. This rule is used to complete Navigation Points with their ''Style'' property set to '''manual'''.
+<table width=1000 bgcolor="lightcyan" cellpadding=2>
-<br>
+<tr valign="top">
-The '''Navigation Point Complete Rule''' is added to a Session and configured using the [[file:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in Surveyor.
+<td width=10>[[image:BlueDot10x10.png|link=]]</td>
+<td>The '''Navigation Point Complete Rule''' is added to a Session and configured using the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in Surveyor</td>
+</tr>
+<tr valign="top">
+<td>[[image:BlueDot10x10.png|link=]]</td>
+<td>The [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Navigation Point Complete Rule|Navigation Point Complete Rule]]''' clears or completes the selected '''Navigation Point''' in a set created by the [[image:PageLink.PNG|link=]] '''[[#stepDisplay|Navigation Display Rule]]'''. This rule is used to complete Navigation Points with their ''Style'' property set to '''manual'''</td>
+</tr>
+</table>
 <br>
+<table width=1000>
-<table>
 <tr valign="top">
-<td>[[file:NavPointCompleteDialog.JPG|link=]]</td>
+<td width=500>[[image:NavPointCompleteDialog.JPG|500px|link=]]</td>
 <td>
-<table cellpadding=4 bgcolor=#eeeeee>
+<table width=500 bgcolor=#000000 cellpadding=2>
+<tr valign="top">
+<td>
+<table width=496 bgcolor=#ffffb0 cellpadding=2>
+<tr valign="top">
+<td width=25>[[image:NotePad.PNG|link=]]</td>
+<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
+----
+'''Navigation Points''' with their '''Style:''' set to '''Automatic''' or '''Require Stop''' will be cleared automatically when they have been completed. Those set to '''Manual''' must be cleared by using this rule.</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width=1000 cellpadding=4 bgcolor=#eeeeee>
 <tr>
 <td colspan="2">
@@ Line 409: / Line 432: @@
 </tr>
 <tr valign="top">
-<td>[[file:Gears.PNG|link=]]</td>
+<td>[[image:Gears.PNG|link=]]</td>
-<td><span style="font-size: 17px;">'''Settings:'''</span><br>
+<td><span style="font-size: 17px;">'''Settings:'''</span>
-*'''Navigation Point Number'''  A valid number identifying the particular Navigation Point to be completed. If the number entered does not exist then the rule will be ignored
+<table>
-*'''Set ID:''' The unique Navigation Point '''Set ID''' code for the set. This must be the same ID as entered in the '''Navigation Display Rule''' and consists of any text characters '''EXCEPT''' the ''SPACE'' character and ''UPPER CASE'' characters</td>
+<tr valign="top">
+<td width=10>[[image:BlackDot10x10.png|link=]]</td>
+<td>'''Navigation Point Number'''  A valid number identifying the particular Navigation Point to be completed. If the number entered does not exist then the rule will be ignored</td>
+</tr>
+<tr valign="top">
+<td>[[image:BlackDot10x10.png|link=]]</td>
+<td>'''Set ID:''' The unique Navigation Point '''Set ID''' code for the set. This must be the same ID as entered in the [[image:PageLink.PNG|link=]] '''[[#stepDisplay|Navigation Display Rule]]''' and consists of any text characters <span style="background-color: red; color: white; font-weight: 700; font-size: 15px">&nbsp;EXCEPT&nbsp;</span> the '''SPACE''' character and '''UPPER CASE''' characters</td>
+</tr>
+</table>
+</td>
 </tr>
 <tr>
 <td colspan="2">
 ----</td>
-</tr>
-</table></td>
 </tr>
 </table>
@@ Line 425: / Line 455: @@
 <tr valign="top">
 <td width=729><span id="stepCheck"></span>&nbsp;</td>
-<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
-<td width=75>[[file:NextUp.png|link=#stepComplete|alt=Next Up|Top]]</td>
+<td width=75>[[image:NextUp.png|link=#stepComplete|alt=Next Up|Top]]</td>
-<td width=75>[[file:NextDown.png|link=#stepWait|alt=Next Down|Next Down]]</td>
+<td width=75>[[image:NextDown.png|link=#stepWait|alt=Next Down|Next Down]]</td>
-<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 </tr>
 </table>								<!-- END Nav Buttons Table -->

How to Use Navigation Point Rules

Revision as of 08:05, 21 September 2023

Contents

Navigation Display Rule

Navigation Set Hide/Show Rule

Navigation Set Clear Rule

Navigation Point Complete Rule

Navigation Set Check Rule

Wait on Navigation Point Rule

Trainz Wiki

Views

Personal tools

Navigation

Search

Toolbox