How to Use Parent and Child Rules

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Ordered Lists)
m (Parent/Child Rule Example)
 
(57 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=300>
 +
__TOC__
 +
</td>
 +
<td>
 +
<table bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>Session Rules are the "programming tools" for constructing interactive sessions</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Parent Rules''' are the decision makers amongst the Session Rules</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 +
<table> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="stepWhat"></span>&nbsp;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>&nbsp;</td>
 +
<td width=75>[[image:NextDown.png|link=#stepOrdered|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 
='''What Are Parent and Child Rules?'''=
 
='''What Are Parent and Child Rules?'''=
  
Most '''Parent Rules''' are used as "decision makers" in TANE Sessions. They decide if or when other rules, the '''Child Rules''', will be executed. Some '''Parent Rules''' control how those '''Child Rules''' are executed.
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>Rules that act as '''Parent Rules''' can have one or more sub-rules or '''Child Rules''' under them</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Rules''' are edited and managed by the '''Session Editor''' in Surveyor</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding=4 bgcolor="Aquamarine">
 +
<tr valign="top">
 +
<td>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
More information on the '''Session Editor''' can be found on the '''Trainz Wiki Page''' at:-<br>
 +
*'''[[How to Use Session Editor|Using the Session Editor]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
Most '''Parent Rules''' are used as "decision makers" in '''Trainz Sessions'''. They decide if or when other rules, the '''Child Rules''', will be executed. Some '''Parent Rules''' control how those '''Child Rules''' are executed.</td>
 +
</tr>
 +
</table>
  
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000 bgcolor=#000000 cellpadding=2>
<tr valign="top>
+
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td>
<td>'''Rules that act as ''Parent Rules'' can have one or more sub-rules or ''Child Rules'' indented under them.'''</td>
+
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Only certain rules can be '''Parent Rules'''. See the Trainz Wiki page [[image:WikiLink.PNG|link=]] '''[[Parent Rule List|List of Parent Rules]]''' for details</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Most '''Parent Rules''' will either wait for a specific event or perform a test or a comparison. They will execute their '''Child Rules''' when the event occurs or the test/comparison is '''true'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Any rule can be a '''Child Rule''' including other '''Parent Rules'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding="4" bgcolor=#ffffb0>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:NotePad.PNG]]</td>
+
<td width=325>[[image:Parent_Child.PNG|link=]]</td>
<td><font size="3">'''Notes:'''</font><br>
+
<td>Session rules can be arranged in a hierarchical fashion, in a series of levels as shown in the example on the left. A '''Parent Rule''' can be used to group together a set of rules at a lower level in the hierarchy. The rules that are grouped together under a '''Parent Rule''' are the '''Child Rules'''.<br><br>
*Only certain rules can be Parent Rules. See the Trainz Wiki page '''[[Parent Rule List|List of Parent Rules]]''' for details.
+
 
*Most Parent Rules will ''either'' wait for a specific event or perform a test or a comparison. They will execute the child rules when the event occurs or the test/comparison is ''true''.
+
'''Child Rules''' can also be '''Parent Rules''' that group together other rules at an even lower level. This creates multiple levels in the hierarchy.<br><br>
*Any rule can be a Child Rule.</td>
+
 
 +
The '''Parent Rule''' at the head of each level in the hierarchy acts as a ''switch'' that directs the Trainz session to either ignore (skip over) or obey (execute) the '''Child Rules''' under its control.<br>
 +
 
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
<tr valign="top>
+
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>'''Rules that act as ''Child Rules'' are indented under a ''Parent Rule''.'''</td>
+
<td>Rules that act as '''Child Rules''' are indented under a '''Parent Rule'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table>
+
<table width=1000>
<tr>
+
<td valign="top">[[file:SessionRuleIndent.JPG|480px]]</td>
+
<td valign="top">
+
<table cellpadding="4" bgcolor=#ffffff>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:Steps.PNG]]</td>
+
<td width=480>[[image:SessionRuleIndent.JPG|480px]]</td>
<td><font size="3">'''Steps:'''</font><br>
+
<td>
To '''indent''' a rule,
+
<table bgcolor=#000000 cellpadding=2>
*highlight (select) it
+
<tr valign="top">
*click the '''Right Arrow ''Indent''''' tool at the bottom of the Session Editor
+
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To indent a rule:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span>) the rule to be indented</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Right Arrow ''Indent''''' tool at the bottom of the '''Session Editor'''</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
[[file:SessionRuleIndented.JPG|480px]]</td>
+
[[image:SessionRuleIndented.JPG|480px]]</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
==Parent/Child Rule Example==
 
==Parent/Child Rule Example==
<table>
+
In the following example, a '''Trigger Check Rule''' is acting as the ''switch'' that decides whether or not its child rules will be executed. If the Trigger is activated, for example by a particular train passing over its track trigger, then its child rules will be executed. Otherwise the '''Trigger Check Rule''' will wait indefinitely until that event occurs, or the session is terminated.
<tr>
+
 
<td>[[file:Message_Popup.jpg]]</td>
+
<table width=1000>
 +
<tr valign="top">
 +
<td width=600>[[image:Message_Popup.jpg|600px|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the cause of the trigger event is set in the properties of the '''Trigger Check Rule''' </td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the message shown is set in the properties of the '''Message Popup Rule''' </td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the duration of the wait is set in the properties of the '''Wait Rule''' </td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
In the screenshot above, the  
+
<table width=1000>
*'''Trigger Check Rule''' is a Parent Rule. It has rules indented below it.
+
<tr valign="top">
**'''Simultaneous List Rule''' is indented under the '''Trigger Check Rule''' so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
+
<td>In the screenshot above, the  
***'''Message Popup Rule''' is indented under the '''Simultaneous List Rule''' so it is a Child of that rule.
+
<table>
***'''Wait Rule''' is indented under the '''Simultaneous List Rule''' so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
+
<tr valign="top">
****'''Close Message Popup Rule''' is indented under the '''Wait Rule''' so it is a Child of that rule.
+
<td>'''Line''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;1&#160;</span>''': Trigger Check Rule''' is a Parent Rule. It has rules indented below it which are its Child Rules:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>
 +
:'''Line''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;2&#160;</span>''': Simultaneous List Rule''' is indented under the '''Trigger Check Rule''' so it is a Child of that rule. It is also a Parent Rule and it has its own Child Rules indented below it:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>
 +
::'''Line''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;3&#160;</span>''': Message Popup Rule''' is indented under the '''Simultaneous List Rule''' so it is a Child of that rule</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>
 +
::'''Line''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;4&#160;</span>''': Wait Rule''' is indented under the '''Simultaneous List Rule''' so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>
 +
:::'''Line''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;5&#160;</span>''': Close Message Popup Rule''' is indented under the '''Wait Rule''' so it is a Child of that rule</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
<font size="3">'''Sequence of Events'''</font>
+
<table width=1000>
<br>
+
<tr valign="top">
*When the consist identified in the '''Trigger Check Rule''', a Parent Rule, reaches the set trigger, the Trigger Event is activated and its Child Rules are executed.
+
<td colspan=2><span style="font-size: 17px;">'''Sequence of Events'''</span></td>
**The '''Simultaneous List Rule''', a Parent Rule, is then executed. It executes all its Child Rules immediately and simultaneously.
+
</tr>
***The '''Message Popup Rule''' is executed. This waits until its message window is closed. At the same time ...
+
<tr valign="top">
***The '''Wait Rule''' is executed. This is set to force a 20 second wait, after which its Child Rule ...
+
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
****The '''Close Message Popup Rule''' is executed. This closes the Message window created by the '''Message Popup Rule'''. Since it is the last rule under the '''Simultaneous List Rule''' it terminates that Parent Rule. Since it is the last rule under the '''Trigger Check Rule''', it also terminates that Parent Rule.
+
<td>When the consist identified in the '''Trigger Check Rule''', a Parent Rule, reaches the set trigger, the Trigger Event is activated and its Child Rules are executed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>The '''Simultaneous List Rule''', a Parent Rule, is then executed. It executes all its Child Rules immediately and simultaneously</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2>'''Simultaneously...'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>The '''Message Popup Rule''' is executed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>The '''Wait Rule''' is executed. This is set to force a 20 second wait, then ...</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>The '''Close Message Popup Rule''' is executed. This closes the Message window created by the '''Message Popup Rule'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td>Since the '''Close Message Popup Rule''' is the last child rule under the '''Wait Rule''', when it has completed its task (closing the message popup) it will terminate the '''Wait''' Parent Rule</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint6.JPG|link=]]</td>
 +
<td>Since it is also the last child rule under the '''Simultaneous List Rule''' it will terminate that Parent Rule</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint7.JPG|link=]]</td>
 +
<td>Finally, since it is the last child rule under the '''Trigger Check Rule''', it also terminates that Parent Rule</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
 +
<table> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="stepOrdered"></span>&nbsp;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepWhat|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepOthers|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
 
='''Ordered Lists vs Simultaneous Lists'''=
 
='''Ordered Lists vs Simultaneous Lists'''=
  
The majority of sibling Child Rules, rules that are at the same indent level under a Parent Rule, will be executed in order (an '''Ordered List''') or simultaneously (a '''Simultaneous List''').
+
<table width=1000>
 +
<tr valign="top">
 +
<td>The majority of sibling Child Rules, rules that are at the same indent level under a Parent Rule, will be executed in order (an '''Ordered List''') or simultaneously (a '''Simultaneous List''').</td>
 +
</tr>
 +
</table>
  
 
==Ordered Lists==
 
==Ordered Lists==
'''Rule details can be found at [[Session_Rule_List_with_Parameters#Ordered_List_Rule|Ordered List Rule]]'''
+
 
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>'''Ordered Lists are shown with numbered icons on each Child Rule which indicates the order in which they will be executed.'''</td>
+
<td>Details for this rule can be found at [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Ordered_List_Rule|Ordered List Rule]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Ordered Lists''' are shown with '''numbered icons''' on each '''Child Rule''' which indicates the order in which they will be executed</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
<br>
 +
<table width=1000>
 +
<tr align="top">
 +
<td width=500>[[image:OrderedListRule.JPG|500px|link=]]</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;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>an '''Ordered List''' can be set to repeat a set number of times</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>each '''Child Rule''' in the sequence must be completed before the next '''Child Rule''' can be executed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>an '''Ordered List''' is completed when the '''last''' Child Rule is completed</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>Because some rules will wait for an event (such as a mouse click, a set time or a time period, a trigger, etc) before they are completed, it is possible for the Ordered List to ''hang'' indefinitely waiting for the event to occur. This will stop that particular Child Rule from being completed and any following Child Rules from being started. So, if possible, place Child Rules that are event dependent at the end of an ordered list.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Setting the Options&#160;</span><br>
  
 +
The rule settings allow you to control how many times an '''Ordered List''' will run.<br>
 +
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=550>
 +
<table width=550 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To set the repeat options for an '''Ordered List''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the '''Ordered List''' in the '''Session Editor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Edit&#160;</span> button at the bottom of the '''Session Editor''' to open the '''Ordered List''' properties window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>Select an '''Option Button''':-
 
<table>
 
<table>
<tr>
+
<tr valign="top">
<td>[[file:OrderedListRule.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;">This process will repeat <u>1</u> time(s)</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;">This process will repeat forever</span></td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
</td>
<table cellpadding="4" bgcolor=#c1e7e7>
+
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td>[[image:DotPoint4.JPG|link=]]</td>
<td>'''Each Child Rule in the sequence must be completed before the next Child Rule can be executed.'''</td>
+
<td>to change the number of repeats to any required number <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''<u>1</u>''' and enter a new value. Click the [[image:Tick.PNG|Link=]] to accept the change</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td>to accept the new rule settings <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|Link=]] or the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Save Changes&#160;</span> button (depending on your version of '''Trainz''') in the rule properties window</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table width=450>
 +
<tr valign="top">
 +
<td>[[image:RuleRepeatsSetting.png|link=]]<br><br>
 +
[[image:RuleRepeatsEntry.png|link=]]</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding="4" bgcolor=#ffffb0>
+
<table bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:NotePad.PNG]]</td>
+
<td>
<td><font size="3">'''Notes:'''</font><br>
+
<table bgcolor=#ffffb0 cellpadding=2>
*Because some rules will wait for an event (such as a mouse click, timer, consist trigger, load trigger, etc) before they are completed, it is possible for the Ordered List to ''hang'' indefinitely waiting for the event.
+
<tr valign="top">
*An Ordered List is completed when the last Child Rule is completed.
+
<td width=25>[[image:NotePad.PNG|link=]]</td>
*If possible, place Child Rules that are event dependent at the end of an ordered list.</td>
+
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the '''minimum''' number is '''1''' which means that the '''Ordered List''' will execute '''once only'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the "repeat forever" option will force the list to restart again endlessly</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
</td>
 +
</tr>
 +
</table>
 +
<br>
 
==Simultaneous Lists==
 
==Simultaneous Lists==
'''Rule details can be found at [[Session_Rule_List_with_Parameters#Simultaneous_List_Rule|Simultaneous List Rule]]'''
+
 
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>'''Simultaneous Lists are shown with equality ("=") icons on each Child Rule which indicates that they will be executed at the same time.'''</td>
+
<td>Details for this rule can be found at [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Simultaneous_List_Rule|Simultaneous List Rule]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Simultaneous Lists''' are shown with '''equality (<span style="font-size: 15px;">=</span>) icons''' on each '''Child Rule''' which indicates that they will all be executed at the same time</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=500>[[image:SimultaneousListRule.JPG|500px|link=]]</td>
 +
<td width=500>
 +
<table width=500 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;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>a '''Simultaneous List''' can be set to complete when all the '''Child Rules''' have been completed, or when any one of the '''Child Rules''' has been completed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>while all '''Child Rules''' in a '''Simultaneous List''' will start at the same time, some will take longer to complete than others and some may wait for a particular event before they can complete</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Setting the Options&#160;</span><br>
  
 +
The rule settings allow you to control how a '''Simultaneous List''' will be terminated.<br>
 +
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=550>
 +
<table width=550 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To set the "completion" options for a '''Simultaneous List''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the '''Simultaneous List''' in the '''Session Editor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Edit&#160;</span> button at the bottom of the '''Session Editor''' to open the '''Simultaneous List''' properties window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>Depending on your version of '''Trainz''' 2 or 3 options are presented by cycling ("clicking") through the underlined text.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>Select an option:-
 
<table>
 
<table>
<tr>
+
<tr valign="top">
<td>[[file:SimultaneousListRule.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;"><u>all child rules have reached a completed state</u></span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;"><u>all child rules have reached a 'was completed' state</u></span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;"><u>one of the child rules has completed</u></span></td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>to accept the new rule settings <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|Link=]] or the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Save Changes&#160;</span> button (depending on your version of '''Trainz''') in the rule properties window</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table width=450>
 +
<tr valign="top">
 +
<td>[[image:RuleAllCompletedSetting.png|link=]]<br><br>
 +
[[image:RuleWasCompletedSetting.png|link=]]<br><br>
 +
[[image:RuleOneCompletedSetting.png|link=]]</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
*A Simultaneous List can be set to complete when:-
 
**all the Child Rules are completed, OR
 
**any one of the Child Rules has been completed.
 
 
<br>
 
<br>
 +
<table width=1000 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;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the first option, "'''all child rules have reached a completed state'''", means that the '''Simultaneous List''' will wait until ALL child rules have been completed before terminating. Some child rules may wait for an event, such as a trigger or a set time, before they terminate</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the second option, "'''all child rules have reached a 'was completed' state'''", is needed for the '''UDS''' feature in '''TRS19 Platinium''' and later versions that allows you to switch between '''Driver''' and '''Surveyor'''. If you make the switch back to Driver when some rules have been completed but others have not, then the completed child rules will not be restarted and the '''Simultaneous Rule''' will wait until all the child rules reach the '''was completed''' state before it terminates</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the third option, "'''one of the child rules has completed'''" will terminate the '''Simultaneous Rule''', and any child rules that have not yet completed, as soon as one child rule completes</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="stepOthers"></span>&nbsp;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepOrdered|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepRelated|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 
='''Other Types of Lists'''=
 
='''Other Types of Lists'''=
  
 
==Progressive Lists==
 
==Progressive Lists==
'''Rule details can be found at [[Session_Rule_List_with_Parameters#Progressive_List_Rule|Progressive List Rule]]'''
+
 
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>'''On the first run of a Progressive List, only the first Child Rule is executed. On the second run, the second Child Rule is executed, on the third run the third Child Rule is executed, etc.'''</td>
+
<td>Details for this rule can be found at [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Progressive_List_Rule|Progressive List Rule]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Progressive Lists''' are shown with '''numbered icons''' on each '''Child Rule''' which indicates the progressive order in which they will be executed on each cycle of the list</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
<br>
<table>
+
<table width=1000>
 
<tr>
 
<tr>
<td>[[file:ProgressiveListRules.JPG]]</td>
+
<td width=500>[[image:ProgressiveListRules.JPG|500px|link=]]</td>
 +
<td width=500>
 +
<table width=500 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;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>a '''Progressive List''' executes only a single child rule each time it runs</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>on the '''first run''' of a '''Progressive List''', only the '''first''' Child Rule is executed. On the '''second run''', the '''second''' Child Rule is executed. On the '''third''' run the '''third''' Child Rule is executed, etc. Until all the child rules have been executed</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Setting the Options&#160;</span><br>
  
A '''Progressive List''' can be set to:-
+
The rule settings allow you to control what happens after the last child rule in a '''Progressive List''' has been completed.<br>
*repeat the sequence after the last child rule has been executed, OR
+
*terminate (no further repeats) after the last child rule has been executed
+
  
==Random Lists==
+
<table width=1000>
'''Rule details can be found at [[Session_Rule_List_with_Parameters#Random_List_Rule|Random List Rule]]'''
+
<table cellpadding="4" bgcolor=#c1e7e7>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=550>
<td>'''A Random List will run <font color="red">ONLY ONCE</font> and will randomly select a single Child Rule to execute.'''</td>
+
<table width=550 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To set the "completion" options for a '''Progressive List''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the '''Progressive List''' in the '''Session Editor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Edit&#160;</span> button at the bottom of the '''Session Editor''' to open the '''Progressive List''' properties window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>You can select from 3 options by cycling ("clicking") through the underlined text.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>Select an option:-
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;"><u>... successive runs will do nothing</u></span> - after the last child rule has been completed the '''Progressive Rule''' will terminate</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;"><u>... last child .... will be used for all successive runs</u></span> - after the last child rule has been completed the '''Progressive Rule''' will repeat that child rule on all further runs</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightgrey;"><u>... the first child is chosen again</u></span> - after the last child rule has been completed the '''Progressive Rule''' will start with the first child rule again and it will repeat the sequence</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>to accept the new rule settings <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the [[image:Tick.PNG|Link=]] or the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Save Changes&#160;</span> button (depending on your version of '''Trainz''') in the rule properties window</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table width=450>
 +
<tr valign="top">
 +
<td>[[image:RuleProgressiveNoneSetting.png|link=]]<br><br>
 +
[[image:RuleProgressiveLastSetting.png|link=]]<br><br>
 +
[[image:RuleProgressiveNoneSetting.png|link=]]</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
==Random Lists==
  
<table>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>Details for this rule can be found at [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Random_List_Rule|Random List Rule]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Random Lists''' are shown with '''"dot" icons''' on each '''Child Rule''' which indicates that '''ONE''' of them will be selected at random</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 
<tr>
 
<tr>
<td>[[file:RandomListRules.JPG]]</td>
+
<td width=500>[[image:RandomListRules.JPG|500px|link=]]</td>
 +
<td width=500>
 +
<table width=500 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;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>a '''Random List''' will run '''ONCE ONLY'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>a child rule will be selected '''at random''' and once that child rule has been completed, the '''Random List''' will terminate</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>there are no control options for a '''Random List'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 
==Reset Lists==
 
==Reset Lists==
'''Rule details can be found at [[Session_Rule_List_with_Parameters#Reset_List_Rule|Reset List Rule]]'''
+
 
<table cellpadding="4" bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>'''A Reset List will execute continuously, it will never terminate. Each time through the list all the Child Rules will be reset and executed again.'''</td>
+
<td>Details for this rule can be found at [[image:WikiLink.PNG|link=]] '''[[Session_Rule_List_with_Parameters#Reset_List_Rule|Reset List Rule]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Reset Lists''' are shown with '''equality (<span style="font-size: 15px;">=</span>) icons''' on each '''Child Rule''' which indicates that they will all be executed at the same time</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
<br>
<table>
+
<table width=1000>
 
<tr>
 
<tr>
<td>[[file:ResetListRules.JPG]]</td>
+
<td width=500>[[image:ResetListRules.JPG|500px|link=]]</td>
 +
<td width=500>
 +
<table width=500 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;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>a '''Reset List''' will never terminate. It will run '''continuously'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>after the last child rule has been completed, all the child rules will be reset and executed again</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>there are no control options for a '''Reset List'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="stepRelated"></span>&nbsp;</td>
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepOthers|alt=Next Up|Top]]</td>
 +
<td width=75>&nbsp;</td>
 +
<td width=75>&nbsp;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
<br>
 +
<table> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=729><span id="bottom"></span>&nbsp;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 
----
 
----
 
----
 
----
<br>
 
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
+
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table width=500 cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width=80>[[image:TrainzWiki.png|link=]]</td>
 +
<td>
 +
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
 +
*'''<span class="plain;s">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 +
*'''[[Driver Commands List]]'''
 
*'''[[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]]'''
<br>
+
</td>
<font size="3">'''Route Creation Tutorials:'''</font>
+
</tr>
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
</table>
*'''[[How to Merge Routes|Merging Routes]]'''
+
</td>
*'''[[How to Use Bulk Asset Update/Replace Tool|Using the Bulk Asset Update/Replace Tool]]'''
+
<td>
*'''[[How to Use Layers|Using Layers]]'''
+
<table width=500 cellpadding=4 bgcolor="aquamarine">
</div>
+
<tr valign="top">
<br>
+
<td width=50>[[image:LinkWiki.PNG|link=]]</td>
<font size="3">'''Session Creation Tutorials:'''</font>
+
<td>
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
<span style="font-size: 17px;">'''Related Links'''</span><br>
*'''[[How to Use Message Popup Rule|Adding Message Popups]]'''
+
*'''[[How to Use Message Popup Rule|How to Use the Message Popup Rule]]'''
*'''[[How to Use Message Popup Rule (Applications)|Adding Message Popups - Applications]]'''
+
*'''[[How to Use Navigation Point Rules|How to Use Navigation Point Rules]]'''
*'''[[How to Use Navigation Point Rules|Adding Navigation Points]]'''
+
*'''[[How to Use Session Editor|How to Use the Session Editor]]'''
*'''[[How to Use Navigation Point Rules (Applications)|Adding Navigation Points - Applications]]'''
+
*'''[[Parent and Child Rules|Parent and Child Rules]]'''
*'''[[How to Use Driver Setup Rule|Configuring the Driver Setup Rule]]'''
+
</td>
*'''[[How to Control Junctions in Sessions|Controlling Junctions in Sessions]]'''
+
</tr>
*'''[[How to Control Signals in Sessions|Controlling Signals in Sessions]]'''
+
</table>
*'''[[How to Create a HTML Asset|Creating a HTML Asset (Session Introduction Page and In Game Messages)]]'''
+
</td>
*'''[[Parent Rule List|List of Parent Rules]]'''
+
</tr>
*'''[[How to Use Track Triggers|Using Track Triggers]]'''
+
</table>
*'''[[How to Use Variables in Sessions (Examples)|Using Variables in Sessions - Examples]]
+
----
</div>
+
This page was created by Trainz user '''<span class="plain;s">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in May 2018 and was last updated as shown below.
 
+
----
[[Category:How-to guides]]
+
[[Category:How-to guides]][[Category:Rules]]

Latest revision as of 09:35, 1 August 2024

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22.

Contents

BlueDot10x10.png Session Rules are the "programming tools" for constructing interactive sessions
BlueDot10x10.png Parent Rules are the decision makers amongst the Session Rules
  Top   Next Down Bottom

[edit] What Are Parent and Child Rules?

BlueDot10x10.png Rules that act as Parent Rules can have one or more sub-rules or Child Rules under them
BlueDot10x10.png Rules are edited and managed by the Session Editor in Surveyor


LinkWiki.PNG

More information on the Session Editor can be found on the Trainz Wiki Page at:-


Most Parent Rules are used as "decision makers" in Trainz Sessions. They decide if or when other rules, the Child Rules, will be executed. Some Parent Rules control how those Child Rules are executed.
NotePad.PNG Notes:
DotPoint.JPG Only certain rules can be Parent Rules. See the Trainz Wiki page WikiLink.PNG List of Parent Rules for details
DotPoint.JPG Most Parent Rules will either wait for a specific event or perform a test or a comparison. They will execute their Child Rules when the event occurs or the test/comparison is true
DotPoint.JPG Any rule can be a Child Rule including other Parent Rules


Parent Child.PNG Session rules can be arranged in a hierarchical fashion, in a series of levels as shown in the example on the left. A Parent Rule can be used to group together a set of rules at a lower level in the hierarchy. The rules that are grouped together under a Parent Rule are the Child Rules.

Child Rules can also be Parent Rules that group together other rules at an even lower level. This creates multiple levels in the hierarchy.

The Parent Rule at the head of each level in the hierarchy acts as a switch that directs the Trainz session to either ignore (skip over) or obey (execute) the Child Rules under its control.


BlueDot10x10.png Rules that act as Child Rules are indented under a Parent Rule


SessionRuleIndent.JPG
Steps: To indent a rule:-
DotPoint1.JPG select (Left Click) the rule to be indented
DotPoint2.JPG Left Click the Right Arrow Indent tool at the bottom of the Session Editor
SessionRuleIndented.JPG

[edit] Parent/Child Rule Example

In the following example, a Trigger Check Rule is acting as the switch that decides whether or not its child rules will be executed. If the Trigger is activated, for example by a particular train passing over its track trigger, then its child rules will be executed. Otherwise the Trigger Check Rule will wait indefinitely until that event occurs, or the session is terminated.

Message Popup.jpg
DotPoint.JPG the cause of the trigger event is set in the properties of the Trigger Check Rule
DotPoint.JPG the message shown is set in the properties of the Message Popup Rule
DotPoint.JPG the duration of the wait is set in the properties of the Wait Rule
In the screenshot above, the
Line  1 : Trigger Check Rule is a Parent Rule. It has rules indented below it which are its Child Rules:-
Line  2 : Simultaneous List Rule is indented under the Trigger Check Rule so it is a Child of that rule. It is also a Parent Rule and it has its own Child Rules indented below it:-
Line  3 : Message Popup Rule is indented under the Simultaneous List Rule so it is a Child of that rule
Line  4 : Wait Rule is indented under the Simultaneous List Rule so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
Line  5 : Close Message Popup Rule is indented under the Wait Rule so it is a Child of that rule


Sequence of Events
DotPoint1.JPG When the consist identified in the Trigger Check Rule, a Parent Rule, reaches the set trigger, the Trigger Event is activated and its Child Rules are executed
DotPoint2.JPG The Simultaneous List Rule, a Parent Rule, is then executed. It executes all its Child Rules immediately and simultaneously
Simultaneously...
DotPoint3.JPG The Message Popup Rule is executed
DotPoint3.JPG The Wait Rule is executed. This is set to force a 20 second wait, then ...
DotPoint4.JPG The Close Message Popup Rule is executed. This closes the Message window created by the Message Popup Rule
DotPoint5.JPG Since the Close Message Popup Rule is the last child rule under the Wait Rule, when it has completed its task (closing the message popup) it will terminate the Wait Parent Rule
DotPoint6.JPG Since it is also the last child rule under the Simultaneous List Rule it will terminate that Parent Rule
DotPoint7.JPG Finally, since it is the last child rule under the Trigger Check Rule, it also terminates that Parent Rule


  Top Next Up Next Down Bottom

[edit] Ordered Lists vs Simultaneous Lists

The majority of sibling Child Rules, rules that are at the same indent level under a Parent Rule, will be executed in order (an Ordered List) or simultaneously (a Simultaneous List).

[edit] Ordered Lists

BlueDot10x10.png Details for this rule can be found at WikiLink.PNG Ordered List Rule
BlueDot10x10.png Ordered Lists are shown with numbered icons on each Child Rule which indicates the order in which they will be executed


OrderedListRule.JPG
NotePad.PNG Notes:

DotPoint.JPG an Ordered List can be set to repeat a set number of times
DotPoint.JPG each Child Rule in the sequence must be completed before the next Child Rule can be executed
DotPoint.JPG an Ordered List is completed when the last Child Rule is completed


PencilTips.PNG Because some rules will wait for an event (such as a mouse click, a set time or a time period, a trigger, etc) before they are completed, it is possible for the Ordered List to hang indefinitely waiting for the event to occur. This will stop that particular Child Rule from being completed and any following Child Rules from being started. So, if possible, place Child Rules that are event dependent at the end of an ordered list.


 Setting the Options 

The rule settings allow you to control how many times an Ordered List will run.

Steps: To set the repeat options for an Ordered List:-
DotPoint1.JPG select (Left Click on) the Ordered List in the Session Editor
DotPoint2.JPG select (Left Click on) the  Edit  button at the bottom of the Session Editor to open the Ordered List properties window
DotPoint3.JPG Select an Option Button:-
BlueDot10x10.png This process will repeat 1 time(s)
BlueDot10x10.png This process will repeat forever
DotPoint4.JPG to change the number of repeats to any required number Left Click on the 1 and enter a new value. Click the Link= to accept the change
DotPoint5.JPG to accept the new rule settings Left Click on the Link= or the  Save Changes  button (depending on your version of Trainz) in the rule properties window
RuleRepeatsSetting.png

RuleRepeatsEntry.png


NotePad.PNG Notes:

DotPoint.JPG the minimum number is 1 which means that the Ordered List will execute once only
DotPoint.JPG the "repeat forever" option will force the list to restart again endlessly


[edit] Simultaneous Lists

BlueDot10x10.png Details for this rule can be found at WikiLink.PNG Simultaneous List Rule
BlueDot10x10.png Simultaneous Lists are shown with equality (=) icons on each Child Rule which indicates that they will all be executed at the same time


SimultaneousListRule.JPG
NotePad.PNG Notes:

DotPoint.JPG a Simultaneous List can be set to complete when all the Child Rules have been completed, or when any one of the Child Rules has been completed
DotPoint.JPG while all Child Rules in a Simultaneous List will start at the same time, some will take longer to complete than others and some may wait for a particular event before they can complete


 Setting the Options 

The rule settings allow you to control how a Simultaneous List will be terminated.

Steps: To set the "completion" options for a Simultaneous List:-
DotPoint1.JPG select (Left Click on) the Simultaneous List in the Session Editor
DotPoint2.JPG select (Left Click on) the  Edit  button at the bottom of the Session Editor to open the Simultaneous List properties window
Depending on your version of Trainz 2 or 3 options are presented by cycling ("clicking") through the underlined text.
DotPoint3.JPG Select an option:-
BlueDot10x10.png all child rules have reached a completed state
BlueDot10x10.png all child rules have reached a 'was completed' state
BlueDot10x10.png one of the child rules has completed
DotPoint4.JPG to accept the new rule settings Left Click on the Link= or the  Save Changes  button (depending on your version of Trainz) in the rule properties window
RuleAllCompletedSetting.png

RuleWasCompletedSetting.png

RuleOneCompletedSetting.png


NotePad.PNG Notes:

DotPoint.JPG the first option, "all child rules have reached a completed state", means that the Simultaneous List will wait until ALL child rules have been completed before terminating. Some child rules may wait for an event, such as a trigger or a set time, before they terminate
DotPoint.JPG the second option, "all child rules have reached a 'was completed' state", is needed for the UDS feature in TRS19 Platinium and later versions that allows you to switch between Driver and Surveyor. If you make the switch back to Driver when some rules have been completed but others have not, then the completed child rules will not be restarted and the Simultaneous Rule will wait until all the child rules reach the was completed state before it terminates
DotPoint.JPG the third option, "one of the child rules has completed" will terminate the Simultaneous Rule, and any child rules that have not yet completed, as soon as one child rule completes


  Top Next Up Next Down Bottom

[edit] Other Types of Lists

[edit] Progressive Lists

BlueDot10x10.png Details for this rule can be found at WikiLink.PNG Progressive List Rule
BlueDot10x10.png Progressive Lists are shown with numbered icons on each Child Rule which indicates the progressive order in which they will be executed on each cycle of the list


ProgressiveListRules.JPG
NotePad.PNG Notes:

DotPoint.JPG a Progressive List executes only a single child rule each time it runs
DotPoint.JPG on the first run of a Progressive List, only the first Child Rule is executed. On the second run, the second Child Rule is executed. On the third run the third Child Rule is executed, etc. Until all the child rules have been executed


 Setting the Options 

The rule settings allow you to control what happens after the last child rule in a Progressive List has been completed.

Steps: To set the "completion" options for a Progressive List:-
DotPoint1.JPG select (Left Click on) the Progressive List in the Session Editor
DotPoint2.JPG select (Left Click on) the  Edit  button at the bottom of the Session Editor to open the Progressive List properties window
You can select from 3 options by cycling ("clicking") through the underlined text.
DotPoint3.JPG Select an option:-
BlueDot10x10.png ... successive runs will do nothing - after the last child rule has been completed the Progressive Rule will terminate
BlueDot10x10.png ... last child .... will be used for all successive runs - after the last child rule has been completed the Progressive Rule will repeat that child rule on all further runs
BlueDot10x10.png ... the first child is chosen again - after the last child rule has been completed the Progressive Rule will start with the first child rule again and it will repeat the sequence
DotPoint4.JPG to accept the new rule settings Left Click on the Link= or the  Save Changes  button (depending on your version of Trainz) in the rule properties window
RuleProgressiveNoneSetting.png

RuleProgressiveLastSetting.png

RuleProgressiveNoneSetting.png


[edit] Random Lists

BlueDot10x10.png Details for this rule can be found at WikiLink.PNG Random List Rule
BlueDot10x10.png Random Lists are shown with "dot" icons on each Child Rule which indicates that ONE of them will be selected at random


RandomListRules.JPG
NotePad.PNG Notes:

DotPoint.JPG a Random List will run ONCE ONLY
DotPoint.JPG a child rule will be selected at random and once that child rule has been completed, the Random List will terminate
DotPoint.JPG there are no control options for a Random List


[edit] Reset Lists

BlueDot10x10.png Details for this rule can be found at WikiLink.PNG Reset List Rule
BlueDot10x10.png Reset Lists are shown with equality (=) icons on each Child Rule which indicates that they will all be executed at the same time


ResetListRules.JPG
NotePad.PNG Notes:

DotPoint.JPG a Reset List will never terminate. It will run continuously
DotPoint.JPG after the last child rule has been completed, all the child rules will be reset and executed again
DotPoint.JPG there are no control options for a Reset List


  Top Next Up    


 


[edit] Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz

LinkWiki.PNG

Related Links


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


Personal tools