How to Use Message Popup Rule (Applications)

From TrainzOnline
Jump to: navigation, search

This document gives examples of how to use the Message Popup Rule in TANE Sessions. For information of how to configure this rule in TANE see the Trainz Wiki Page WikiLink.PNG Message Popup Rule

Contents


DotPoint.JPG The WikiLink.PNG Message Popup Rule is a T:ANE Session Rule that creates onscreen messages for users in Driver Mode.
DotPoint.JPG The WikiLink.PNG Close Message Popup Rule is a T:ANE Session Rule that closes onscreen messages for users in Driver Mode.

This page gives practical examples of how these rules can be used in a session to create messages that appear after an event and automatically close after another event.

Application 1: Timed Message

Binoculars.PNG The Scenario:

A Message Popup is activated by a track trigger event and is automatically closed by a timed event.

RulesWiki.PNG Rules Used:


Screenshot.PNG Session Editor Screenshot:

Message Popup.jpg


Explanation.PNG Description:

  • Line 1: Trigger Check The event is triggered when a consist passes over a track trigger but any event could be used, such as a Navigation Point, a TimeCheck, a Wait On ... or Wait For ..., etc. As long as the following rules are child rules of the trigger event.
    • Line 2: Simultaneous List This forces all the following child rules to be executed at the same time. Events such as the Trigger Check that execute their child rules in order would not work in this example because everything else would be forced to wait until the Message Popup has been closed. Using the Simultaneous List Rule avoids this problem. Events that execute their child rules simultaneously would not need the Simultaneous List Rule (see next example).
      • Line 3: Message Popup This places the message window on the screen and waits for it to be closed either manually (by the user) or by another rule.
      • Line 4: Wait This forces a wait for a set time period, in this case 20 seconds but any time interval can be set. At the end of that period the Wait Rule will execute its own set of child rules.
        • Line 5: Close Message Popup The message window is closed.


Application 2: Navigation Point and Train Stopped Event Message

Binoculars.PNG The Scenario:

A Message Popup is activated by a navigation event and is automatically closed by a train stopped event.

Conditions.PNG Preconditions:


RulesWiki.PNG Rules Used:


Screenshot.PNG Session Editor Screenshot:

Message Popup2.JPG


Explanation.PNG Description:

  • Line 1: Wait on Navigation Point The event is triggered when a consist reaches a preset navigation point. This rule executes all its child rules simultaneously so no Simultaneous List Rule is required in this example.
    • Line 2: Message Popup This places the message window on the screen and waits for it to be closed either manually (by the user) or by another rule.
    • Line 3: Wait on Train Stop/Start When the consist comes to a stop then it will execute its own set of child rules.
      • Line 4: Close Message Popup The message window is closed.

In this example, the Close Message Popups Rule could be replaced by lines 2, 3, 4 and 5 from the Timed Message example shown above to produce a new message when the train stops moving and that message would be closed after a set time interval.




Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz

Personal tools