How to Use Navigation Point Rules

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m
m (→‎Trainz Wiki)
 
(14 intermediate revisions by one user not shown)
Line 1: Line 1:
−
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.
+
The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''. It describes how to configure the various '''Navigation Point Rules'''.
  
−
<table>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td>
+
<td width=250>
−
__TOC__
+
__TOC__
 
</td>
 
</td>
−
<td width=700>
+
<td>
 +
<table bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Navigation Points''' are icons that appear at set track locations or on set rail vehicles that indicate destinations for user driven trains and tasks to be performed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The navigation points are created and controlled by the set of Session rules that are described in this document</td>
 +
</tr>
 +
</table>
 +
<br>
 
<table cellpadding=4 bgcolor="Aquamarine">
 
<table cellpadding=4 bgcolor="Aquamarine">
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:LinkWiki.PNG|link=]]</td>
+
<td>[[image:LinkWiki.PNG|link=]]</td>
 
<td>
 
<td>
−
For information on how to configure these rules in '''Trainz''' see the '''Trainz Wiki Page''' at:-<br>
+
For examples of how to use these rules in '''Trainz''' Sessions, see the '''Trainz Wiki Page''' at:-<br>
−
:*'''[[How to Use Navigation Point Rules]]'''
+
* '''[[How to Use Navigation Point Rules (Applications)]]'''
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 19: Line 30:
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<br>
+
 
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepUnused"></span>&nbsp;</td>
+
<td width=729><span id="stepDisplay"></span>&#160;</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>&nbsp;</td>
+
<td width=75>&#160;</td>
−
<td width=75>[[file:NextDown.png|link=#stepIncomplete|alt=Next Down|Next Down]]</td>
+
<td width=75>[[image:NextDown.png|link=#stepHide|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>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
  
−
='''Application 1: Clearing Unused Navigation Sets'''=
+
='''Navigation Display Rule'''=
−
 
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
−
<table cellpadding=4 bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:magnifier.png|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''The Scenario:'''</span><br>
+
<td>The '''Navigation Set Hide/Show Rule''' is added to a Session and configured using the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in Surveyor</td>
−
----</td>
+
 
</tr>
 
</tr>
−
</table>
 
−
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.
 
−
<br><br>
 
−
<table cellpadding=4 bgcolor=#ffffff>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:conditions.PNG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Preconditions:'''</span><br>
+
<td>The [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Navigation Display Rule|Navigation Display Rule]]''' create a '''set of Navigation Points'''</td>
−
----</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Display_Rule|Navigation Display Rule]]''' creates the navigation point sets.
 
 
<br>
 
<br>
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000 bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:RulesWiki.PNG|link=]]</td>
+
<td>
−
<td width="640"><span style="font-size: 17px;">'''Rules Used:'''</span><br>
+
<table width=996 bgcolor=#ffffb0 cellpadding=2>
−
----</td>
+
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 +
----
 +
</td>
 
</tr>
 
</tr>
−
</table>
 
−
*'''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' to trigger the event.
 
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Set_Clear_Rule|Navigation Set Clear Rule]]''' to manually complete navigation sets.
 
−
<br>
 
−
<table cellpadding=4 bgcolor=#ffffff>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:screenshot.PNG|link=]]</td>
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Session Editor Screenshot:'''</span><br>
+
<td>A navigation set must be created by the '''Navigation Display Rule''' before it can be used by the other navigation rules</td>
−
----</td>
+
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Multiple sets can be created by adding additional copies of this rule - one copy for each set</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>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</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<table>
+
</td>
−
<tr>
+
−
<td>[[file:NavClearSets.JPG|link=]]</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:explanation.PNG|link=]]</td>
+
<td width=640>[[image:NavDisplaySetDialogUpper.JPG|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Description:'''</span><br>
+
<td>
−
----</td>
+
<table width=360 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table width=356 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>
 +
----
 +
The '''Upper''' section of the Rule Dialogue Box identifies the '''Navigation Display Set''' and how it will operate</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''Line 1: Trigger Check''' the event is triggered by the consist leaving the location with the navigation points.
 
−
**'''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 process for any other navigation sets.
 
  
−
<table> <!-- BEGIN Nav Buttons Table -->
+
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepIncomplete"></span>&nbsp;</td>
+
<td colspan=2>'''For the Navigation Set:'''</td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
−
<td width=75>[[file:NextUp.png|link=#stepUnused|alt=Next Up|Top]]</td>
+
−
<td width=75>[[file:NextDown.png|link=#stepWait|alt=Next Down|Next Down]]</td>
+
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
 
</tr>
 
</tr>
−
</table> <!-- END Nav Buttons Table -->
 
−
 
−
='''Application 2: Checking for Incomplete Navigation Sets'''=
 
−
 
−
<table cellpadding=4 bgcolor=#ffffff>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:magnifier.png|link=]]</td>
+
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''The Scenario:'''</span><br>
+
<td>'''Set ID:''' Each Navigation Point Set must have a '''unique ID code'''. This consists of any text characters <span style="background-color: red; color: white; font-weight: 700; font-size: 15px">&#160;EXCEPT&#160;</span> the '''SPACE''' character and '''UPPER CASE''' characters</td>
−
----</td>
+
 
</tr>
 
</tr>
−
</table>
 
−
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.
 
−
<br><br>
 
−
<table cellpadding=4 bgcolor=#ffffff>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:conditions.PNG|link=]]</td>
+
<td>[[image:BlackDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Preconditions:'''</span><br>
+
<td>'''Train (optional):''' You can add a specific locomotive that this Navigation Point set will be applied to</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Navigation mode:''' Select '''one''' of three options:-
 +
<table>
 +
<tr valign="top">
 +
<td>[[image:PortalOptionButtonEmpty.PNG|link=]] '''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</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:PortalOptionButtonEmpty.PNG|link=]] '''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</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:PortalOptionButtonEmpty.PNG|link=]] '''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</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Display_Rule|Navigation Display Rule]]''' creates the navigation point sets.
+
 
−
<br>
+
<table width=1000>
−
<table cellpadding=4 bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:RulesWiki.PNG|link=]]</td>
+
<td width=640>[[image:NavDisplaySetDialogLower.JPG|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Rules Used:'''</span><br>
+
<td>
−
----</td>
+
<table width=360 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table width=356 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>
 +
----
 +
The '''lower''' section of the Rule Dialogue Box defines the individual '''Navigation Points''' in this '''Navigation Display Set'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' to trigger the event.
+
</td>
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Set_Check_Rule|Navigation Set Check Rule]]''' to check if a navigation set has been completed.
+
</tr>
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Set_Clear_Rule|Navigation Set Clear Rule]]''' to manually complete navigation sets.
+
</table>
−
*'''[[Session_Rule_List_with_Parameters#Message_Popup_Rule|Message Popup Rule]]''' to open a message window on the screen.
+
</td>
−
<br>
+
</tr>
−
<table cellpadding=4 bgcolor=#ffffff>
+
</table>
 +
 
 +
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:screenshot.PNG|link=]]</td>
+
<td>
−
<td width="640"><span style="font-size: 17px;">'''Session Editor Screenshot:'''</span><br>
+
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
−
</table>
+
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 
<table>
 
<table>
−
<tr>
+
<tr valign="top">
−
<td>[[file:NavSetCheck.JPG|link=]]</td>
+
<td colspan=2>'''For each Navigation Point:'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Location:''' - this can be a trackmark, a trigger, track object or a rolling stock vehicle</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Icon:''' - a graphic icon to be displayed representing the Navigation point. Icons are selected from a preset list</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Display text:''' - a short message up to 25 characters long</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Style:''' - the operational style of the Navigation Point. Select '''one''' of:-
 +
<table>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Automatic''' - the Navigation Point will be completed and disappear when the consist reaches its location</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Manual''' - the Navigation Point must be completed by another rule</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Require Stop''' - the Navigation Point will be completed and disappear when the consist stops at its location</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<br>
+
</td>
−
<table cellpadding=4 bgcolor=#ffffff>
+
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:explanation.PNG|link=]]</td>
+
<td colspan=2>Navigation points can be added and deleted, but their order cannot be changed
−
<td width="640"><span style="font-size: 17px;">'''Description:'''</span><br>
+
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Add Navigation Point''' - new points are added by a <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''+''' icon. The new point will be inserted in the line below</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Delete Navigation Point''' - existing points can be deleted by <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''x''' icon</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''Line 1: Trigger Check''' the event is triggered by the consist leaving the location with the navigation points.
+
</td>
−
**'''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:-
+
</tr>
−
***'''Line 3: Navigation Set Clear''' the navigation set is cleared so all of its navigation points will be cleared (completed).
+
</table>
−
***'''Line 4: Message Popup Rule''' a suitable message is displayed on the screen.
+
  
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepWait"></span>&nbsp;</td>
+
<td width=729><span id="stepHide"></span>&#160;</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=#stepIncomplete|alt=Next Up|Top]]</td>
+
<td width=75>[[image:NextUp.png|link=#stepDisplay|alt=Next Up|Top]]</td>
−
<td width=75>[[file:NextDown.png|link=#stepPath|alt=Next Down|Next Down]]</td>
+
<td width=75>[[image:NextDown.png|link=#stepClear|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>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
  
−
='''Application 3: Wait for Loading to be Completed'''=
+
='''Navigation Set Hide/Show Rule'''=
  
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:magnifier.png|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''The Scenario:'''</span><br>
+
<td>The '''Navigation Set Hide/Show Rule''' is added to a Session and configured using the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in Surveyor</td>
−
----</td>
+
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Navigation Set Hide/Show Rule|Navigation Set Hide/Show Rule]]''' hides and displays the navigation sets created by the '''Navigation Display Rule'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
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.
+
 
−
<br><br>
+
<table width=1000>
−
<table cellpadding=4 bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:conditions.PNG|link=]]</td>
+
<td width=500>[[image:NavPointHideDialog.JPG|500px|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Preconditions:'''</span><br>
+
<td>
−
----</td>
+
<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>
 +
----
 +
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.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Display_Rule|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.
 
  
 +
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 
<table>
 
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Hide/Show:''' <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> to select one of these two options:-
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td> '''Hide''' will make the entire set invisible</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Show''' will display the next navigation point or more depending on the '''Navigation Mode''' (see [[image:PageLink.PNG|link=]] '''[[#stepDisplay|Navigation Display Rule]]''' above) that has been selected for this particular set</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''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 [[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">&#160;EXCEPT&#160;</span> the '''SPACE''' character and '''UPPER CASE''' characters</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 
<tr>
 
<tr>
−
<td>[[file:NavManualSet.JPG|link=]]</td>
+
<td colspan="2">
 +
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
−
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).
+
<table> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="stepClear"></span>&#160;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepHide|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepComplete|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>
+
='''Navigation Set Clear Rule'''=
 +
 
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''Navigation Set Clear 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>
 
<tr>
−
<td>[[file:MultResCheck.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Navigation Set Clear Rule|Navigation Set Clear Rule]]''' clears or completes any uncompleted Navigation Points in a set created by the '''Navigation Display Rule'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:RulesWiki.PNG|link=]]</td>
+
<td width=500>[[image:NavSetClearDialog.JPG|500px|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Rules Used:'''</span><br>
+
<td>
−
----</td>
+
<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>
 +
----
 +
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.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''[[Session_Rule_List_with_Parameters#Trigger_Check_Rule|Trigger Check Rule]]''' to trigger the message event.
 
−
*'''[[Session_Rule_List_with_Parameters#Multiple_Resource_Check_Rule|Multiple Resource Check Rule]]''' to monitor the load level in the last wagon.
 
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Point_Complete_Rule|Navigation Point Complete Rule]]''' to manually complete a navigation point.
 
−
*'''[[Session_Rule_List_with_Parameters#Message_Popup_Rule|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.
+
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
−
<br><br>
+
<tr>
−
<table cellpadding=4 bgcolor=#ffffff>
+
<td colspan="2">
−
<tr valign="top">
+
−
<td width="58">[[file:screenshot.PNG|link=]]</td>
+
−
<td width="640"><span style="font-size: 17px;">'''Session Editor Screenshot:'''</span><br>
+
 
----</td>
 
----</td>
 
</tr>
 
</tr>
−
</table>
+
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 
<table>
 
<table>
−
<tr>
+
<tr valign="top">
−
<td>[[file:NavPointComplete.JPG|link=]]</td>
+
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''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 [[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">&#160;EXCEPT&#160;</span> the '''SPACE''' character and '''UPPER CASE''' characters</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<br>
+
</td>
−
<table cellpadding=4 bgcolor=#ffffff>
+
</tr>
−
<tr valign="top">
+
<tr>
−
<td width="58">[[file:explanation.PNG|link=]]</td>
+
<td colspan="2">
−
<td width="640"><span style="font-size: 17px;">'''Description:'''</span><br>
+
 
----</td>
 
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''Line 1: Trigger Check''' the event is triggered by the arrival of the consist at the coal loader (the Navigation Point).
 
−
**'''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.
 
  
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepPath"></span>&nbsp;</td>
+
<td width=729><span id="stepComplete"></span>&#160;</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=#stepWait|alt=Next Up|Top]]</td>
+
<td width=75>[[image:NextUp.png|link=#stepClear|alt=Next Up|Top]]</td>
−
<td width=75>[[file:NextDown.png|link=#bottom|alt=Next Down|Next Down]]</td>
+
<td width=75>[[image:NextDown.png|link=#stepCheck|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>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
  
−
='''Application 4: User Path Selection'''=
+
='''Navigation Point Complete Rule'''=
  
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:magnifier.png|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''The Scenario:'''</span><br>
+
<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>
−
----</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>
 
</tr>
 
</table>
 
</table>
−
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.
 
 
<br>
 
<br>
−
 
+
<table width=1000>
 +
<tr valign="top">
 +
<td width=500>[[image:NavPointCompleteDialog.JPG|500px|link=]]</td>
 +
<td>
 +
<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">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 
<table>
 
<table>
 +
<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">&#160;EXCEPT&#160;</span> the '''SPACE''' character and '''UPPER CASE''' characters</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 
<tr>
 
<tr>
−
<td>[[file:NavSidingMap.JPG|link=]]</td>
+
<td colspan="2">
 +
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
−
Three sets of navigation points are created, one for each location on the map diagram above.  
+
<table> <!-- BEGIN Nav Buttons Table -->
−
*'''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
+
<tr valign="top">
−
*'''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 width=729><span id="stepCheck"></span>&#160;</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 width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepComplete|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepWait|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
−
<br>
+
='''Navigation Set Check Rule'''=
−
<table cellpadding=4 bgcolor=#ffffff>
+
 
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:RulesWiki.PNG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Rules Used:'''</span><br>
+
<td>The '''Navigation Set Check Rule''' is added to a Session and configured using the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in Surveyor. It is a [[image:WikiLink.PNG|link=]] '''[[How_to_Use_Parent_and_Child_Rules|Parent Rule]]'''</td>
−
----</td>
+
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Navigation Set Check Rule|Navigation Set Check Rule]]''' checks if the specified '''Navigation Set''' has been completed, or not completed, then executes any following child rules</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Display_Rule|Navigation Display Rule]]''' creates the navigation point sets.
 
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Set_Hide/Show_Rule|Navigation Set Hide/Show Rule]]''' to hide and display the navigation point sets.
 
−
*'''[[Session_Rule_List_with_Parameters#Wait_on_Navigation_Point_Rule|Wait on Navigation Point Rule]]''' to trigger the message event.
 
−
*'''[[Session_Rule_List_with_Parameters#Navigation_Set_Clear_Rule|Navigation Set Clear Rule]]''' to manually terminate a navigation point set.
 
−
*'''[[Session_Rule_List_with_Parameters#Message_Popup_Rule|Message Popup Rule]]''' to open a message window on the screen.
 
−
*'''[[Session_Rule_List_with_Parameters#Set_Junctions_Rule|Set Junctions Rule]]''' to set and lock junctions.
 
−
*'''[[Session_Rule_List_with_Parameters#Set_Signal_Extended_Rule|Set Signal Extended Rule]]''' to set signals.
 
−
*'''[[Session_Rule_List_with_Parameters#Wait_Rule|Wait Rule]]''' to introduce a short delay.
 
−
*'''[[Session_Rule_List_with_Parameters#Driver_Schedule_Rule|Driver Schedule Rule]]''' to give commands to the AI controlled train.
 
 
<br>
 
<br>
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:screenshot.PNG|link=]]</td>
+
<td width=500>[[image:NavSetCheckDialog.JPG|500px|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Session Editor Screenshot:'''</span><br>
+
<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; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
This rule allows you to check if all the '''Navigation Points''' in an identified '''Navigation Point Set''' have been completed or not. It is a '''Parent Rule''' so it can be used to perform other actions (execute '''Child Rules''') based on the result of the check</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
===Creating the Navigation Point Sets===
+
</td>
−
 
+
</tr>
−
<table>
+
</table>
−
<tr>
+
</td>
−
<td>[[file:NavDisplaySets.JPG|link=]]</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
  
−
*Each set is created separately and sets '''B''' and '''C''' are hidden.
+
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
−
*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.
+
−
 
+
−
<table>
+
 
<tr>
 
<tr>
−
<td>[[file:NavPointSet.JPG|link=]]</td>
+
<td colspan="2">
 +
----</td>
 
</tr>
 
</tr>
−
<tr>
+
<tr valign="top">
−
<td>Navigation Point Set '''A'''. Sets '''B''' and '''C''' are similar.</td>
+
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''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 [[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">&#160;EXCEPT&#160;</span> the '''SPACE''' character and '''UPPER CASE''' characters</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''Complete/Incomplete:''' <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> 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)</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
 
+
</td>
−
===At Navigation Set A Point 1 The Junction===
+
</tr>
−
 
+
−
<table>
+
 
<tr>
 
<tr>
−
<td>[[file:NavSetsChoose.JPG|link=]]</td>
+
<td colspan="2">
 +
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<br>
+
 
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:explanation.PNG|link=]]</td>
+
<td width=729><span id="stepWait"></span>&#160;</td>
−
<td width="640"><span style="font-size: 17px;">'''Description:'''</span><br>
+
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−
----</td>
+
<td width=75>[[image:NextUp.png|link=#stepCheck|alt=Next Up|Top]]</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 
</tr>
 
</tr>
−
</table>
+
</table> <!-- END Nav Buttons Table -->
−
*'''Line 1: Wait on Navigation Point''' The event is triggered when the consist reaches (and stops at) '''Navigation Point 1''' in '''Set A'''.
+
−
**'''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.
+
  
−
===At Navigation Set B Point 1 The Stop signal on the Main Line===
+
='''Wait on Navigation Point Rule'''=
  
−
<table>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
−
<tr>
+
<tr valign="top">
−
<td>[[file:NavMainSet.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''Wait on Navigation Point Rule''' is added to a Session and configured using the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in Surveyor. It is a [[image:WikiLink.PNG|link=]] '''[[How_to_Use_Parent_and_Child_Rules|Parent Rule]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Wait on Navigation Point Rule|Wait on Navigation Point Rule]]''' waits until the specified Navigation Point in the specified set has been completed then executes any following child rules</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:explanation.PNG|link=]]</td>
+
<td width=500>[[image:NavPointWaitDialog.JPG|500px|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Description:'''</span><br>
+
<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; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
This rule allows you to set a '''Wait''' condition until a particular '''Navigation Point''' in a specific '''Navigation Point Set''' has been completed. It is a '''Parent Rule''' so it can be used to perform other actions (execute '''Child Rules''') when the specific '''Navigation Point''' has been completed</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''Line 1: Wait on Navigation Point''' The event is triggered when the consist reaches (and stops at) '''Navigation Point 1''' in '''Set B'''.
 
−
**'''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 ...
 
−
***'''Line 6: Driver Schedule''' The AI train is given commands to move to the next destination via the Loop Line.
 
  
−
===At Navigation Set C Point 1 The Stop Signal on the Loop Line===
+
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
−
 
+
−
<table>
+
 
<tr>
 
<tr>
−
<td>[[file:NavLoopSet.JPG|link=]]</td>
+
<td colspan="2">
 +
----</td>
 
</tr>
 
</tr>
−
</table>
 
−
<table cellpadding=4 bgcolor=#ffffff>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td width="58">[[file:explanation.PNG|link=]]</td>
+
<td>[[image:Gears.PNG|link=]]</td>
−
<td width="640"><span style="font-size: 17px;">'''Description:'''</span><br>
+
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 +
<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 '''Navigation Display Rule''' and consists of any text characters '''EXCEPT''' the ''SPACE'' character and ''UPPER CASE'' characters</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 
----</td>
 
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
*'''Line 1: Wait on Navigation Point''' The event is triggered when the consist reaches (and stops at) '''Navigation Point 1''' in '''Set C'''.
 
−
**'''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 ...
 
−
***'''Line 6: Driver Schedule''' The AI train is given commands to move to the next destination via the Main Line.
 
  
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="bottom"></span>&nbsp;</td>
+
<td width=729><span id="bottom"></span>&#160;</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=#stepPath|alt=Next Up|Top]]</td>
+
<td width=75>[[image:NextUp.png|link=#stepWait|alt=Next Up|Top]]</td>
−
<td width=75></td>
+
<td width=75>&#160;</td>
−
<td width=75></td>
+
<td width=75>&#160;</td>
 
</tr>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
 
----
 
----
 
----
 
----
 +
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
−
<table cellpadding=4 bgcolor=#ffffff>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:TrainzWiki.png|link=]]</td>
+
<td>
 +
<table width=500 cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width=80>[[image:TrainzWiki.png|link=]]</td>
 
<td>
 
<td>
 
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
 
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
Line 399: Line 627:
 
*'''[[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]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table width=500 cellpadding=4 bgcolor="aquamarine">
 +
<tr valign="top">
 +
<td width=50>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
<span style="font-size: 17px;">'''Related Links'''</span><br>
 +
'''[[How to Use Session Editor|How to Use the Session Editor]]'''
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>

Latest revision as of 08:17, 23 November 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.

Contents
BlueDot10x10.png Navigation Points are icons that appear at set track locations or on set rail vehicles that indicate destinations for user driven trains and tasks to be performed
BlueDot10x10.png The navigation points are created and controlled by the set of Session rules that are described in this document


LinkWiki.PNG

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

[edit] Navigation Display Rule

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


NotePad.PNG Notes:
DotPoint.JPG A navigation set must be created by the Navigation Display Rule before it can be used by the other navigation rules
DotPoint.JPG Multiple sets can be created by adding additional copies of this rule - one copy for each set
DotPoint.JPG 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


NavDisplaySetDialogUpper.JPG
NotePad.PNG Notes:
The Upper section of the Rule Dialogue Box identifies the Navigation Display Set and how it will operate
Gears.PNG Settings:
For the Navigation Set:
BlackDot10x10.png 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
BlackDot10x10.png Train (optional): You can add a specific locomotive that this Navigation Point set will be applied to
BlackDot10x10.png Navigation mode: Select one of three options:-
PortalOptionButtonEmpty.PNG 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
PortalOptionButtonEmpty.PNG 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
PortalOptionButtonEmpty.PNG 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
NavDisplaySetDialogLower.JPG
NotePad.PNG Notes:
The lower section of the Rule Dialogue Box defines the individual Navigation Points in this Navigation Display Set
Gears.PNG Settings:
For each Navigation Point:
BlackDot10x10.png Location: - this can be a trackmark, a trigger, track object or a rolling stock vehicle
BlackDot10x10.png Icon: - a graphic icon to be displayed representing the Navigation point. Icons are selected from a preset list
BlackDot10x10.png Display text: - a short message up to 25 characters long
BlackDot10x10.png Style: - the operational style of the Navigation Point. Select one of:-
BlackDot10x10.png Automatic - the Navigation Point will be completed and disappear when the consist reaches its location
BlackDot10x10.png Manual - the Navigation Point must be completed by another rule
BlackDot10x10.png 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
BlackDot10x10.png Add Navigation Point - new points are added by a Left Click on the + icon. The new point will be inserted in the line below
BlackDot10x10.png Delete Navigation Point - existing points can be deleted by Left Click on the x icon
  Top Next Up Next Down Bottom

[edit] Navigation Set Hide/Show Rule

BlueDot10x10.png The Navigation Set Hide/Show Rule is added to a Session and configured using the WikiLink.PNG Session Editor in Surveyor
BlueDot10x10.png The WikiLink.PNG Navigation Set Hide/Show Rule hides and displays the navigation sets created by the Navigation Display Rule
NavPointHideDialog.JPG
NotePad.PNG 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.
Gears.PNG Settings:
BlackDot10x10.png Hide/Show: Left Click to select one of these two options:-
BlackDot10x10.png Hide will make the entire set invisible
BlackDot10x10.png Show will display the next navigation point or more depending on the Navigation Mode (see PageLink.PNG Navigation Display Rule above) that has been selected for this particular set
BlackDot10x10.png 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 PageLink.PNG Navigation Display Rule and consists of any text characters  EXCEPT  the SPACE character and UPPER CASE characters
  Top Next Up Next Down Bottom

[edit] Navigation Set Clear Rule

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


NavSetClearDialog.JPG
NotePad.PNG 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.
Gears.PNG Settings:
BlackDot10x10.png 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 PageLink.PNG Navigation Display Rule and consists of any text characters  EXCEPT  the SPACE character and UPPER CASE characters
  Top Next Up Next Down Bottom

[edit] Navigation Point Complete Rule

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


NavPointCompleteDialog.JPG
NotePad.PNG 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.
Gears.PNG Settings:
BlackDot10x10.png 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
BlackDot10x10.png Set ID: The unique Navigation Point Set ID code for the set. This must be the same ID as entered in the PageLink.PNG Navigation Display Rule and consists of any text characters  EXCEPT  the SPACE character and UPPER CASE characters
  Top Next Up Next Down Bottom

[edit] Navigation Set Check Rule

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


NavSetCheckDialog.JPG
NotePad.PNG Notes:
This rule allows you to check if all the Navigation Points in an identified Navigation Point Set have been completed or not. It is a Parent Rule so it can be used to perform other actions (execute Child Rules) based on the result of the check
Gears.PNG Settings:
BlackDot10x10.png 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 PageLink.PNG Navigation Display Rule and consists of any text characters  EXCEPT  the SPACE character and UPPER CASE characters
BlackDot10x10.png 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)
  Top Next Up   Bottom

[edit] Wait on Navigation Point Rule

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


NavPointWaitDialog.JPG
NotePad.PNG Notes:
This rule allows you to set a Wait condition until a particular Navigation Point in a specific Navigation Point Set has been completed. It is a Parent Rule so it can be used to perform other actions (execute Child Rules) when the specific Navigation Point has been completed
Gears.PNG Settings:
BlackDot10x10.png 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
BlackDot10x10.png 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
  Top Next Up    

[edit] Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz
LinkWiki.PNG

Related Links
How to Use the Session Editor

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

Retrieved from "https://online.ts2009.com/mediaWiki/index.php?title=How_to_Use_Navigation_Point_Rules&oldid=39371"
Personal tools