Revision as of 09:48, 6 September 2019

The information in this Wiki Page applies to both TANE and TRS19 and gives examples of how to use the various Navigation Point Rules in Sessions. For information on how to configure these rules see the Trainz Wiki Page Navigation Point Rules

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:

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

Application 2: Checking for Incomplete Navigation 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:

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

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.

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

Rules Used:

• Trigger Check Rule to trigger the message event.
• Multiple Resource Check Rule to monitor the load level in the last wagon.
• 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).
  • 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.

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.

Three sets of navigation points are created, one for each location 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: 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.
• 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.

Rules Used:

• Navigation Display Rule creates the navigation point sets.
• 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:

Creating the Navigation Point Sets

• Each set is created separately and sets B and C are hidden.
• 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. Sets B and C are similar.

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

Description:

• 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

Description:

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

Trainz Wiki

More Tutorials and Guides to Using Trainz How to Guides Driver Commands List Session Rules List (Alphabetical) with Parameters Session Rules List (Categories) With Parameters