How to Use the UDS Interface

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (→‎What is the UDS Interface?)
m
 
(34 intermediate revisions by one user not shown)
Line 1: Line 1:
−
The information in this Wiki Page applies to '''TRS19 Platinum Edition''' and '''Trainz Plus'''. Older versions of '''Trainz''', including '''T:ANE''' and '''TRS19 (standard)''', do not have the '''UDS''' feature described in this document. A more detailed description of the '''UDS''' can be found on this Wiki at '''[[Unified_Driver_Surveyor]]'''.
+
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
The information in this Wiki Page applies to '''TRS19 Platinum Edition''', '''Trainz Plus''' and '''TRS22'''. Older versions of '''Trainz''', including '''T:ANE''' and '''TRS19 (standard)''', do not have the '''UDS''' feature described in this document. A more detailed description of the '''UDS''' can be found on the Trainz Wiki Page [[image:WikiLink.PNG|link=]] '''[[Unified_Driver_Surveyor]]'''.</td>
 +
</tr>
 +
</table>
  
−
<!-- 29/6/2021 - 26 -->
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''UDS''' (<span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;U&#160;</span>nified <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;D&#160;</span>river <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;S&#160;</span>urveyor) Interface allows you to switch instantly between '''Surveyor''' and '''Driver''' modes without having to reload</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=225>
 
__TOC__
 
__TOC__
−
<table> <!-- BEGIN Nav Buttons Table -->
+
</td>
 +
<td>
 +
<table width=775 bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729>&nbsp;</td>
+
<td>
−
<td width=46>&nbsp;</td>
+
<table bgcolor=#ffffff cellpadding=2>
−
<td width=75>&nbsp;</td>
+
<tr valign="top">
−
<td width=75>[[file:NextDown.png|link=#stepSwitch|alt=Next Down|Next Down]]</td>
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td>The '''UDS''' is only found in '''TRS19 Platinum Edition''', '''Trainz Plus''' and '''TRS22'''</td>
 
</tr>
 
</tr>
−
</table> <!-- END Nav Buttons Table -->
 
−
='''What is the UDS Interface?'''=
 
−
<table cellpadding="4" bgcolor=#c1e7e7>
 
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
−
<td>The '''UDS''' provides a means of quickly switching from '''Driver''' mode to '''Surveyor''' mode and back to '''Driver''' again without having to restart a running session after each switch</td>
+
<td>It provides a method of quickly switching from '''Driver''' mode to '''Surveyor''' mode and back to '''Driver''' again without having to restart a running session after each switch</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
−
<td>It is only found in '''TRS19 Platinum Edition''' and '''Trainz Plus'''</td>
+
<td>After switching from '''Driver''' to '''Surveyor''' and editing you can save your edits before switching back into '''Driver''' but it is '''<u>recommended</u>''' that you save your work as a new session (unless you really do want to '''overwrite''' the original session)</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
−
<td>It replaces the '''Quick Drive''' feature found in '''TRS19 Standard'''</td>
+
<td>The '''<u>virtual location</u>''' of all consists is now stored as part of the '''Session''' even if the consists themselves are placed in the '''Route'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>The '''Session Editor''' has a feature that allows you to reset any or all of the Session Rules before restarting a session</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
'''UDS''' stands for '''U'''nified '''D'''river '''S'''urveyor and is an "interface" or option built into '''TRS19 Platinum Edition''' and '''Trainz Plus''' that allows you to jump seamlessly from '''Driver''' into '''Surveyor''' and then back into '''Driver''' again to resume a session at the point where you left it. There is no need to restart a '''Driver''' session from the very beginning.
+
<table width=1000> <!-- BEGIN Nav Buttons Table -->
−
<table bgcolor=#ffffb0 width=900>
+
<tr valign="top">
 +
<td width=629><span id="stepWhatIs"></span>
 +
='''What is the UDS Interface?'''=
 +
</td>
 +
<td width=50>&#160;</td> <!-- for Skip Down -->
 +
<td width=50>&#160;</td> <!-- for Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>&nbsp;</td>
 +
<td width=75>[[image:NextDown.png|link=#stepSwitch|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 width=1000>
 +
<tr valign="top">
 +
<td>
 +
'''UDS''' stands for <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;U&#160;</span>'''nified''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;D&#160;</span>'''river''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;S&#160;</span>'''urveyor''' and is an "interface" or option built into '''TRS19 Platinum Edition''', '''Trainz Plus''' and '''TRS22''' that allows you to jump seamlessly from '''Driver''' into '''Surveyor''' and then back into '''Driver''' again to resume a session at the point where you left it. There is no need to restart a '''Driver''' session from the very beginning.</td>
 +
</tr>
 +
</table>
 +
<br><br>
 +
 
 +
<table bgcolor=#ffffb0 width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td><span style="font-weight: 700; font-size:17px;">The Scenario:</span><br>
 
<td><span style="font-weight: 700; font-size:17px;">The Scenario:</span><br>
 +
----
 
You are in '''Driver''' mode testing out a route and session when you discover a problem.</td>
 
You are in '''Driver''' mode testing out a route and session when you discover a problem.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<table bgcolor=#ffffb0 width=900>
+
 
 +
<table bgcolor=#ffffb0 width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=450>[[image:UDS-Scenario1.png|link=]]<td>
+
<td width=450>[[image:UDS-Scenario1.png|link=]]</td>
−
<td width=450>Previously (before '''UDS''') your only options would be to:-
+
<td width=550>Previously (before the '''UDS''') your only options would be to choose one of the following:-
−
#ignore the problem (if possible) to continue the session in '''Driver''' and fix the problem later, or
+
<span style="font-weight: 700; font-size: 15px;">Options:</span><br>
−
#immediately halt the session to fix it now
+
<table>
−
In both cases you would have to:-
+
<tr valign="top">
−
#terminate '''Driver''' and exit back to the '''Main Menu'''
+
<td width=25>[[image:Ablue.png|link=]]</td>
−
#load the route into '''Surveyor''' and try to recall exactly where the problem is located
+
<td>ignore the problem (if possible) to continue the session in '''Driver''' and fix the problem later, <span style="font-weight: 700; font-size: 15px;">OR</span></td>
−
#locate and fix the problem
+
</tr>
−
#save and exit '''Surveyor'''
+
<tr valign="top">
−
#restart the session in '''Driver''' from the beginning (a bit tough if you were 2 hrs or more into the session)
+
<td>[[image:Bblue.png|link=]]</td>
 +
<td>immediately halt the session to fix the problem now</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
In both cases you would have to:-<br>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<span style="font-weight: 700; font-size: 15px;">Steps:</span> To fix the problem<br>
 +
<table>
 +
<tr valign="top">
 +
<td width=20>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>terminate '''Driver''' and exit back to the '''Main Menu'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>load the route into '''Surveyor''' and try to recall exactly where the problem is located</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>locate and fix the problem</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>save and exit '''Surveyor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td>restart the session in '''Driver''' from the beginning (a bit tough if you were 2 hrs or more into the session)</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</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|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 
<td>The '''UDS''' interface allows you to switch, via a menu option, directly to '''Surveyor''' without having to stop and exit '''Driver''' mode first</td>
 
<td>The '''UDS''' interface allows you to switch, via a menu option, directly to '''Surveyor''' without having to stop and exit '''Driver''' mode first</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table bgcolor=#ffffb0 width=900>
+
<table bgcolor=#ffffb0 width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
−
Using '''UDS''' you switch from '''Driver''' to '''Surveyor''' with the currently active '''Driver''' consist still as the focus and at the place it was located when you switched into '''Surveyor''' from '''Driver'''.</td>
+
When using the '''UDS''' you switch from '''Driver''' to '''Surveyor''' with the currently active '''Driver''' consist still as the focus and at the place it was located when you switched into '''Surveyor''' from '''Driver'''.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
<table bgcolor=#ffffb0 width=900>
+
 
 +
<table bgcolor=#ffffb0 width=1000>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=450>[[image:UDS-Scenario2.png|link=]]<td>
+
<td width=450>[[image:UDS-Scenario2.png|link=]]</td>
−
<td width=450>All the '''Surveyor''' tools and options are available for you to use, including the '''Session Editor''' (more on that later).
+
<td width=550>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>All the '''Surveyor''' tools and options are available for you to use, including the '''Session Editor''' (more on that later)</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=450>[[image:UDS-Scenario3.png|link=]]<td>
+
<td width=450>[[image:UDS-Scenario3.png|link=]]</td>
−
<td width=450>You use the '''Surveyor''' tools to fix the problem, such as deleting (as shown left), moving or adding a scenery object.<br><br>
+
<td width=550>
−
You can then (if you wish) save the edited route and/or session (again there will be more on that later).
+
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>You use the '''Surveyor''' tools to fix the problem, such as deleting (as shown left), moving or adding a scenery object.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>You can then (if you wish) save the edited route and/or session (again there will be more on that later)</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td width=450>[[image:UDS-Scenario4.png|link=]]<td>
+
<td width=450>[[image:UDS-Scenario4.png|link=]]</td>
−
<td width=450>You then switch back into '''Driver''' to continue driving the session with the problem fixed.
+
<td width=550>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>You then switch back into '''Driver''' to continue driving the session with the problem fixed</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 85: Line 194:
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepSwitch"></span>&nbsp;</td>
+
<td width=629><span id="stepSwitch"></span>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
='''Switching Modes'''=
−
<td width=75>[[file:NextUp.png|link=#top|alt=Next Up|Next Up]]</td>
+
</td>
−
<td width=75>[[file:NextDown.png|link=#stepSaving|alt=Next Down|Next Down]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Down -->
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepWhatIs|alt=Next Up|Next Up]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepSaving|alt=Next Down|Next Down]]</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 -->
  
−
='''Switching Modes'''=
+
<table width=1000>
−
<table cellpadding="4">
+
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td>
−
<td><span style="font-weight: 700; font-size: 17px;">When in Driver Mode and Switching to Surveyor</span></td>
+
<table width=400>
−
<td>&nbsp;</td>
+
<tr valign="top">
 +
<td width=20>[[image:DotPoint.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 17px;">Driver Mode to Surveyor</span></td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>&nbsp;</td>
+
<td width=20>&nbsp;</td>
−
<td>[[image:UDS-DriverToSurveyor.png|link=]]</td>
+
<td width=380>[[image:UDS-DriverToSurveyor.png|link=]]</td>
−
<td>Open the '''Tools Menu''' and select '''Surveyor Mode'''<br>
+
</tr>
−
<table cellpadding="4" bgcolor=#fcbcbc>
+
</table>
 +
</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px;">Steps:</span> To switch from '''Driver''' to '''Surveyor''':-
 +
<table>
 +
<tr valign="top">
 +
<td>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>Open the [[image:SurveyorToolsIcon_S20.png|link=]]&#160;'''Tools Menu''' and select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Surveyor Mode&#160;</span> '''OR''' press <span style="font-weight: 700; font-size: 15px;"><span style="color: white; background-color: black;">&#160;Ctrl&#160;</span>&#160;+&#160;<span style="color: white; background-color: black;">&#160;F1&#160;</span></span><br></td>
 +
</tr>
 +
</table>
 +
<table bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td colspan=2><span style="font-size: 17px; font-weight: 700;">Warning:</span></td>
 
<td colspan=2><span style="font-size: 17px; font-weight: 700;">Warning:</span></td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:Stop.PNG|link=]]</td>
+
<td>[[image:Stop.PNG|link=]]</td>
−
<td>When you switch to '''Surveyor mode''' the '''Pause''' option (at the top of the '''Tools menu''') will be automatically turned ON. If you turn this option OFF in '''Surveyor mode''' then any consists that were moving in '''Driver mode''' (and were then paused when you switched) will start moving again. This will almost certainly cause problems such as derailments.</td>
+
<td>When you switch to '''Surveyor mode''' the '''Pause''' option (at the top of the '''Tools menu''') will be automatically turned '''ON'''. If you turn this option '''OFF''' in '''Surveyor mode''' then any consists that were moving in '''Driver mode''' (and were then paused when you switched) will start moving again. This will almost certainly cause problems such as derailments.
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
It also means that ALL other animation effects (smoke, procedural track switch blades, animated scenery assets, etc) will also be paused.
+
It also means that '''<u>ALL</u>''' other animation effects (smoke, procedural track switch blades, animated scenery assets, sounds, etc) will also be '''PAUSED'''.
 
</td>
 
</td>
 
</tr>
 
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table width=400>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td width=20>[[image:DotPoint.JPG|link=]]</td>
−
<td><span style="font-weight: 700; font-size: 17px;">When in Surveyor Mode and Switching to Driver</span></td>
+
<td><span style="font-weight: 700; font-size: 17px;">Surveyor Mode to Driver</span></td>
 
<td>&nbsp;</td>
 
<td>&nbsp;</td>
 
</tr>
 
</tr>
Line 124: Line 266:
 
<td>&nbsp;</td>
 
<td>&nbsp;</td>
 
<td>[[image:UDS-SurveyorToDriver.png|link=]]</td>
 
<td>[[image:UDS-SurveyorToDriver.png|link=]]</td>
−
<td>Open the '''Tools Menu''' and select '''Driver Mode'''<br>
+
</tr>
−
<br>
+
</table>
−
If the '''Paused''' option is ON in '''Surveyor mode''' (the default condition unless you have turned it OFF) then the simulation will be paused and the '''Paused''' message will appear on the screen when you switch to '''Driver mode'''. Hit the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&nbsp;P&nbsp;</span> key to '''Unpause''' and resume the simulation.</td>
+
</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px;">Steps:</span> To switch from '''Surveyor''' to '''Driver''':-
 +
<table>
 +
<tr valign="top">
 +
<td>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>Open the [[image:SurveyorToolsIcon_S20.png|link=]]&#160;'''Tools Menu''' and select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Driver Mode&#160;</span> '''OR''' press <span style="font-weight: 700; font-size: 15px;"><span style="color: white; background-color: black;">&#160;Ctrl&#160;</span>&#160;+&#160;<span style="color: white; background-color: black;">&#160;F2&#160;</span></span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>If the '''Paused''' option is '''ON''' in '''Surveyor mode''' (the default condition unless you have turned it '''OFF''') then the simulation will be paused and the '''Paused''' message will appear on the screen when you switch to '''Driver mode'''. Hit the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&nbsp;P&nbsp;</span> key to '''Unpause''' and resume the simulation.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table cellpadding="4" bgcolor=#ffffb0>
+
<table bgcolor=#000000>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:NotePad.PNG|link=]]</td>
+
<td>
−
<td>The '''Undo''' command (<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Z&nbsp;</span>) can be used in '''Surveyor Mode''' but not in '''Driver Mode'''.</td>
+
<table bgcolor=#ffffb0>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]] The '''Undo''' command (<span style="font-weight: 700; font-size: 15px;"><span style="color: white; background-color: black;">&#160;Ctrl&#160;</span>&#160;+&#160;<span style="color: white; background-color: black;">&#160;Z&#160;</span></span>) can be used in '''Surveyor Mode''' but not in '''Driver Mode'''.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 139: Line 311:
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepSaving"></span>&nbsp;</td>
+
<td width=629><span id="stepSaving"></span>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
='''Saving'''=
−
<td width=75>[[file:NextUp.png|link=#stepSwitch|alt=Next Up|Top]]</td>
+
</td>
−
<td width=75>[[file:NextDown.png|link=#stepReset|alt=Next Down|Next Down]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Down -->
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepSwitch|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepReset|alt=Next Down|Next Down]]</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 -->
  
−
='''Saving'''=
+
<table bgcolor=#000000 width=1000>
−
<table cellpadding="4" bgcolor=#ffffb0>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:NotePad.PNG|link=]]</td>
+
<td>
−
<td>An important change that has been introduced by the '''UDS''' is that train vehicle '''placement''' is now saved as part of the '''Session''', even if those vehicles have been placed in '''Route Layers'''.</td>
+
<table bgcolor=#ffffb0 width=996>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
An important change that has been introduced by the '''UDS''' is that train vehicle '''placement''' is now saved as part of the '''Session''', even if those vehicles have been placed in '''Route Layers'''.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:PencilTips.PNG|link=]]</td>
+
<td colspan=2>
−
<td>For this reason, in '''TRS19 Platinum Edition''' and in '''Trainz Plus''' it is '''<u>strongly recommended</u>''' that all consists be placed into a '''Session Layer''' and become part of a '''Session''' instead of the '''Route'''</td>
+
<table bgcolor=#ffffe0>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>It is '''<u>strongly recommended</u>''' that all consists be placed into a '''Session Layer''' and become part of a '''Session''' instead of the '''Route'''
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
<table cellpadding="4" bgcolor=#fcbcbc>
+
<table bgcolor=#ff0000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td colspan=2><span style="font-size: 17px; font-weight: 700;">Warning:</span></td>
 
<td colspan=2><span style="font-size: 17px; font-weight: 700;">Warning:</span></td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:Stop.PNG|link=]]</td>
+
<td>[[image:Stop.PNG|link=]]</td>
−
<td>If you decide to save your '''Surveyor''' edits and select the option to
+
<td>If you decide to save your '''Surveyor''' edits and select the option to<br>
−
[[image:UDS-OverwriteExistingSession.png|link=]]<br>
+
[[image:UDS-OverwriteExistingSession.png|link=]]<br><br>
−
then you will "overwrite" (a nicer way of saying '''destroy''') your starting or original session
+
then you will '''OVERWRITE''' (a nicer way of saying '''DESTROY''') your starting or original '''Session'''
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
−
Most of the problems users seem to be experiencing with the '''UDS''', judging from the posts in the Trainz Forums, is when saving their edited '''Driver''' session after switching to '''Surveyor''' mode. <br>
+
<table width=1000>
−
 
+
−
<table cellpadding="4" bgcolor=#c1e7e7>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td>
−
<td>Using '''Driver Mode''' involves driving consists (either manually or through the AI) and activating rules. '''These will change the session parameters'''</td>
+
Most of the problems users seem to be experiencing with the '''UDS''', judging from the posts in the Trainz Forums, is when saving their edited '''Driver''' session after switching to '''Surveyor''' mode.</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<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>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Using '''Driver Mode''' involves driving consists (either manually or through the AI) and activating session rules. '''This will change the session parameters'''</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 
<td>'''Overwriting the Session will save the consist locations and Session Rules in their new positions/conditions'''</td>
 
<td>'''Overwriting the Session will save the consist locations and Session Rules in their new positions/conditions'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
When you are in '''Driver Mode''' at least one of the consists will probably be moving. Some of the Session rules may have already been completed while others may still be running or waiting for events (e.g. triggers to be activated).
+
</td>
−
 
+
</tr>
−
If, after switching to '''Surveyor Mode''', you then choose to save using the '''Overwrite existing session''' option then you will be replacing your original starting Session with a new one with the consists saved in their new positions and the Session rules saved in their new states. So when you later load and restart the Session things will not be the same as they were in the original or starting Session.
+
</table>
 
<br>
 
<br>
−
<br>
+
<table width=1000>
−
<span style="font-size: 17px;"><span style="background-color: yellow; font-weight: 700">&nbsp;Unless you have a particular reason for overwriting the original Session </span>&nbsp;then the '''recommended''' save options are:-</span><br>
+
<tr valign="top">
−
<table width=900>
+
<td>When you are in '''Driver Mode''' at least one of the consists will probably be moving. Some of the Session rules may have already been completed while others may still be running or waiting for events (e.g. triggers to be activated).
 +
 
 +
If, after switching to '''Surveyor Mode''', you then choose to save using the '''Overwrite existing session''' option then you will be replacing your original starting Session with a new one with the consists saved in their new positions and the Session rules saved in their new states. So when you later load and restart the Session things will not be the same as they were in the original or starting Session.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-size: 17px; background-color: yellow; font-weight: 700">&nbsp;Unless you have a particular reason for overwriting the original Session then the recommended save options are:-</span></td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td colspan=2>[[Image:line740.png|link=]]</td>
 
<td colspan=2>[[Image:line740.png|link=]]</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Option&nbsp;</span>[[image:DotPoint1.JPG|link=]]&nbsp;<span style="font-weight: 700; font-size: 17px;">Do not save session</span></td>
+
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Option&nbsp;</span>[[image:Ablue.png|link=]]&nbsp;<span style="font-weight: 700; font-size: 17px;">Do Not Save the Session</span></td>
 
</tr>
 
</tr>
 +
<tr valign="top">
 +
<td>
 +
<table width=290>
 
<tr valign="top">
 
<tr valign="top">
 
<td width=20>&nbsp;</td>
 
<td width=20>&nbsp;</td>
−
<td>[[image:UDS-DoNotSaveSession.png|link=]]<br>
+
<td width=270>[[image:UDS-DoNotSaveSession.png|link=]]</td>
−
This will only save the '''Route''' using its existing name. This will save any edits that you have made to the '''Route''' but not to the '''Session'''.<br>
+
</tr>
 +
</table>
 
</td>
 
</td>
 +
<td>
 +
<table 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 save the '''Route''' only:-</td>
 
</tr>
 
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the checkbox <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Do not save session&#160;</span> </td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
This will save the '''Route''' only, using its existing name and it will overwrite the original route. This will save any edits that you have made to the '''Route''' but not to the '''Session'''.
 +
</td>
 +
</tr>
 +
</table>
 +
 +
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td colspan=2>[[Image:line740.png|link=]]</td>
 
<td colspan=2>[[Image:line740.png|link=]]</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Option&nbsp;</span>[[image:DotPoint2.JPG|link=]]&nbsp;<span style="font-weight: 700; font-size: 17px;">Create new session</span></td>
+
<td colspan=2><span style="font-weight: 700; font-size: 17px;">Option&nbsp;</span>[[image:Bblue.png|link=]]&nbsp;<span style="font-weight: 700; font-size: 17px;">Create a New Session</span></td>
 
</tr>
 
</tr>
 +
<tr valign="top">
 +
<td>
 +
<table width=290>
 
<tr valign="top">
 
<tr valign="top">
 
<td width=20>&nbsp;</td>
 
<td width=20>&nbsp;</td>
−
<td>[[image:UDS-CreateNewSession.png|link=]]<br>
+
<td>[[image:UDS-CreateNewSession.png|link=]]</td>
−
This will save the '''Route''' using its existing name. It will also save the '''Session''' using a new name you enter in the text box below the option ('''Stage 3''' in the example shown). The original '''Session''' will not be altered. This is useful when you want to test out changes to consists, industry settings, Rules, driver commands, etc but do not want to destroy the original '''Session'''.<br>
+
</tr>
 +
</table>
 +
</td>
 +
<td>
 +
<table 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 save the '''Route''' and a '''NEW Session''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the checkbox <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Create new session&#160;</span> </td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>Enter a name for the new session</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
This will save the '''Route''' using its existing name and it will overwrite the original route. It will also save the '''Session''' using the name you enter in the text box below the checkbox ('''Stage 3''' in the example shown). The original '''Session''' will not be altered. This is useful when you want to test out changes to consists, industry settings, Rules, driver commands, etc but do not want to destroy the original '''Session'''.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 219: Line 489:
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
 +
<table width=1000 bgcolor=#000000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffe0>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>If you have scenery assets ('''stationary''' objects) in a '''Session Layer''' that you will want to edit after switching from '''Driver''' to '''Surveyor''' and will need to save those edits but don't want to destroy your starting Session data, then:-<br>
 +
<table bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=20>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>move that '''Session Layer''' to the '''Route Layer Group''' before starting the Session in Driver. See [[image:WikiLink.PNG|link=]] '''[[How_to_Use_Layers#Moving_a_Layer|Moving Layers]]''' for more details</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>switch from '''Driver''' to '''Surveyor''' and edit when required. You can safely edit any '''Route Layer''' which now includes the moved '''Session layer'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>after each edit you can save ('''Overwrite''') the Route but do not save the Session. Use <span style="font-weight: 700;">Option</span> [[image:Ablue.png|link=]] above</td>
 +
</tr>
 +
</table>
 +
When you have completed all the editing, saving and switching between '''Driver''' and '''Surveyor''', then:-<br>
 +
<table bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=20>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>'''exit''' back to the '''Surveyor/Driver''' main screen</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>'''reload the original Session''' (the saved Session edits will be in the Route that will be loaded along with the Session)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>move the layer from the '''Route Layer Group''' back to the  '''Session Layer Group'''. See [[image:WikiLink.PNG|link=]] '''[[How_to_Use_Layers#Moving_a_Layer|Moving Layers]]''' for more details</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>save ('''Overwrite''') both the Route and the Session</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepReset"></span>&nbsp;</td>
+
<td width=629><span id="stepReset"></span>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
='''Resetting the Session Rules'''=
−
<td width=75>[[file:NextUp.png|link=#stepSaving|alt=Next Up|Top]]</td>
+
</td>
−
<td width=75>[[file:NextDown.png|link=#stepQuestions|alt=Next Down|Next Down]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Down -->
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepSaving|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepQuestions|alt=Next Down|Next Down]]</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 -->
  
−
='''Resetting the Session Rules'''=
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
−
<table cellpadding="4" bgcolor=#c1e7e7>
+
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 
<td>After you switch from '''Driver Mode''' to '''Surveyor Mode''' it may be necessary to restart or reset some of the '''Session Rules'''</td>
 
<td>After you switch from '''Driver Mode''' to '''Surveyor Mode''' it may be necessary to restart or reset some of the '''Session Rules'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 
As mentioned above, when '''Driver Mode''' is running some of the Session rules may be completed while others may still be running or waiting for certain events (e.g. triggers to be activated). When you switch to '''Surveyor Mode''' these rules may be in a different state compared to what they were at the start of the Session. When you restart '''Driver Mode''' these rules may not be in a useful condition.<br>
 
As mentioned above, when '''Driver Mode''' is running some of the Session rules may be completed while others may still be running or waiting for certain events (e.g. triggers to be activated). When you switch to '''Surveyor Mode''' these rules may be in a different state compared to what they were at the start of the Session. When you restart '''Driver Mode''' these rules may not be in a useful condition.<br>
  
−
The '''Session Editor''' built into all Trainz versions allows you to add, delete and modify the rules that will operate during a Session.<br>
+
The '''Session Editor''' built into all Trainz versions allows you to add, delete and modify the rules that will operate during a Session.</td>
−
 
+
</tr>
−
<table cellpadding="4" bgcolor="Aquamarine">
+
</table>
 +
<br>
 +
<table cellpadding=4 bgcolor="Aquamarine">
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:LinkWiki.PNG|link=]]</td>
+
<td>[[image:LinkWiki.PNG|link=]]</td>
 
<td>Information on the '''Session Editor''' can be found at:-<br>
 
<td>Information on the '''Session Editor''' can be found at:-<br>
 
* '''[[How to Use Session Editor|Using the Session Editor]]'''
 
* '''[[How to Use Session Editor|Using the Session Editor]]'''
Line 251: Line 583:
 
<br>
 
<br>
  
−
To open the '''Session Editor''' open the '''Edit''' menu and select '''Edit Session'''<br>
+
To open the '''Session Editor''' open the '''Edit''' menu and select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Edit Session&#160;</span><br>
 
[[image:SessionEditMenuSP1.png|link=]]<br>
 
[[image:SessionEditMenuSP1.png|link=]]<br>
 
<br>
 
<br>
 
[[image:UDS-SessionRules.png|link=]]<br>
 
[[image:UDS-SessionRules.png|link=]]<br>
  
−
<table width=900>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:SessionEditMenuRestartRules.png|link=]]</td>
 
<td>[[image:SessionEditMenuRestartRules.png|link=]]</td>
−
<td>At the bottom of the '''Session Editor''' is a new button, '''Restart All Rules'''. This will reset or restart '''ALL''' rules in the Session.<br></td>
+
<td>At the bottom of the '''Session Editor''' is a new button, <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Restart ALL Rules&#160;</span>. This will reset or restart '''ALL''' rules in the Session.<br></td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:UDS-CompleteWasComplete.png|link=]]</td>
 
<td>[[image:UDS-CompleteWasComplete.png|link=]]</td>
−
<td>Some rules, as shown in the screen shot above, have the label '''(complete was-complete)''' after the rule name. This indicates that the rule has already been completed. These rules can be individually restarted by right mouse clicking on the rule and selecting the '''Reset''' option from the pop up menu. This will change the rule status to '''(paused)'''.</td>
+
<td>Some rules, as shown in the screen shot above, have the label '''(complete was-complete)''' after the rule name. This indicates that the rule has already been completed. These rules can be individually restarted by a <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the rule and selecting the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Reset&#160;</span> option from the pop up menu. This will change the rule status to '''(paused)'''.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 272: Line 604:
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
−
<td width=729><span id="stepQuestions"></span>&nbsp;</td>
+
<td width=629><span id="stepQuestions"></span>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
='''Some Questions Answered'''=
−
<td width=75>[[file:NextUp.png|link=#stepReset|alt=Next Up|Top]]</td>
+
</td>
−
<td width=75>[[file:NextDown.png|link=#bottom|alt=Next Down|Next Down]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Down -->
−
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepReset|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> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
  
−
='''Some Questions Answered'''=
+
<table cellpadding=4 bgcolor=#bbffff>
−
<table cellpadding="4" bgcolor=#bbffff>
+
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Question.PNG|link=|30px]]</td>
 
<td>[[image:Question.PNG|link=|30px]]</td>
Line 289: Line 624:
 
</table>
 
</table>
 
<br>
 
<br>
−
Many scenery assets actually have their properties stored in the Session, even when the assets themselves are in a Route layer. Editing the properties of these assets is considered to be a change to the Session. These include:-
+
<table width=1000>
−
*junction switches - the left/right switch direction is stored in the Session (but the switch '''default''' direction is stored in the Route)
+
<tr valign="top">
−
*industries - the commodities and quantities loaded/unloaded are stored in the Session
+
<td colspan=2>Many scenery assets actually have their properties stored in the Session, even when the assets themselves are in a Route layer. Editing the properties of these assets is considered to be a change to the Session. These include:-</td>
−
*industry enabled wagons - the commodities and quantities carried are stored in the Session
+
</tr>
−
*consist locations - this is stored in the Session ('''TRS19 Platinum Edition''' and '''Trainz Plus''' only)
+
<tr valign="top">
−
*named route objects - while the name is stored in the Route, adding or changing the name is treated as a change to the Session
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>junction switches - the left/right switch direction is stored in the Session (but the switch '''default''' direction is stored in the Route)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>industries - the commodities and quantities loaded/unloaded are stored in the Session</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>industry enabled wagons - the commodities and quantities carried are stored in the Session</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>consist locations - this is stored in the Session ('''TRS19 Platinum Edition''', '''Trainz Plus''' and '''TRS22''' only</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>named route objects - while the name is stored in the Route, adding or changing the name is treated as a change to the Session</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>If you have not altered any Session data or assets that have been placed in a session layer then you can ignore the request to save the Session as well as the Route. Changing the name of an asset, for example, does not alter any session data.</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
−
<table cellpadding="4" bgcolor=#bbffff>
+
<table cellpadding=4 bgcolor=#bbffff>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Question.PNG|link=|30px]]</td>
 
<td>[[image:Question.PNG|link=|30px]]</td>
Line 304: Line 661:
 
</table>
 
</table>
 
<br>
 
<br>
−
If you make the switch from '''Driver Mode''' to '''Surveyor Mode''' after an '''IT/EIT''' path has been activated (but not yet cleared or cancelled) then you will be unable to edit that path. In addition, you will not be able to add new paths to an '''IT/EIT''' that has an open active path.<br>
+
<table width=1000>
−
 
+
<tr valign="top">
−
Pierre ('''pguy'''), the creator of the '''EIT''' asset and associated rules, has a detailed description of this and some possible solutions in a Trainz Forum post at:- '''<span class="plainlinks">[https://forums.auran.com/trainz/showthread.php?159841-Interlocking-Towers-Session-Only&p=1825875#post1825875 EITs and the UDS]</span>'''<br>
+
<td>If you make the switch from '''Driver Mode''' to '''Surveyor Mode''' after an '''IT/EIT''' path has been activated (but not yet cleared or cancelled) then you will be unable to edit that path. In addition, you will not be able to add new paths to an '''IT/EIT''' that has an open active path.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>Pierre ('''pguy'''), the creator of the '''EIT''' asset and associated rules, has a detailed description of this and some possible solutions in a Trainz Forum post at:- '''<span class="plainlinks">[https://forums.auran.com/trainz/showthread.php?159841-Interlocking-Towers-Session-Only&p=1825875#post1825875 EITs and the UDS]</span>'''</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
−
<table cellpadding="4" bgcolor=#bbffff>
+
<table cellpadding=4 bgcolor=#bbffff>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Question.PNG|link=|30px]]</td>
 
<td>[[image:Question.PNG|link=|30px]]</td>
Line 316: Line 678:
 
</table>
 
</table>
 
<br>
 
<br>
−
You can add additional trains and replace existing ones when in '''Surveyor mode''' but it is advised that:-
+
<table>
−
# the '''Paused''' option be set ON (the default condition) in '''Surveyor mode''', and
+
<tr valign="top">
−
# you may have to reset the '''Driver Setup Rule''' in the '''Session Editor''' particularly if you have added/edited driver commands to the new or altered consist
+
<td colspan=2>You can add additional trains and replace existing ones when in '''Surveyor mode''' but it is advised that:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the '''Paused''' option be set ON (the default condition) in '''Surveyor mode''', and</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>you may have to reset the '''Driver Setup Rule''' in the '''Session Editor''' particularly if you have added/edited driver commands to the new or altered consist</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
−
<table cellpadding="4" bgcolor=#bbffff>
+
<table cellpadding=4 bgcolor=#bbffff>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Question.PNG|link=|30px]]</td>
 
<td>[[image:Question.PNG|link=|30px]]</td>
Line 327: Line 699:
 
</tr>
 
</tr>
 
</table>
 
</table>
−
'''This issue is now under investigation by N3V'''<br>
+
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>'''This issue is now under investigation by N3V'''<br>
  
 
A train that is driven into a portal and later returned to the layout will be returned in the same layer as the portal and not in the trains originally assigned layer. Trains that are produced by a portal will be assigned to the same layer as the portal. This has <span style="background-color: yellow; font-weight: 700;">&nbsp;possibly always been the case with portals&nbsp;</span> but was probably unnoticed until the arrival of the '''UDS'''. It seems to have no other noticeable effect on trains.<br>
 
A train that is driven into a portal and later returned to the layout will be returned in the same layer as the portal and not in the trains originally assigned layer. Trains that are produced by a portal will be assigned to the same layer as the portal. This has <span style="background-color: yellow; font-weight: 700;">&nbsp;possibly always been the case with portals&nbsp;</span> but was probably unnoticed until the arrival of the '''UDS'''. It seems to have no other noticeable effect on trains.<br>
  
−
This could become an issue if you make the switch from '''Driver''' to '''Surveyor''' after a train has been '''returned''' to the layout from a portal. For example, if a train is originally in a '''Session Layer''' (as '''recommended''' for '''TRS19 Platinum''' and '''Trainz Plus''') then it is part of a '''Session'''. If it is returned from a portal that is in a '''Route Layer''' then it will now be in the same '''Route Layer''' as the portal and it will be part of the '''Route''', not part of the '''Session'''.<br>
+
This could become an issue if you make the switch from '''Driver''' to '''Surveyor''' after a train has been '''returned''' to the layout from a portal. For example, if a train is originally in a '''Session Layer''' (as '''recommended''' for '''TRS19 Platinum Edition''', '''Trainz Plus''' and '''TRS22''') then it is part of a '''Session'''. If it is returned from a portal that is in a '''Route Layer''' then it will now be in the same '''Route Layer''' as the portal and it will be part of the '''Route''', not part of the '''Session'''.<br>
  
 
If you save the '''Route''' after switching to '''Surveyor''' then the train will be saved in the '''Route''' and not in the '''Session'''. If this is an issue then the remedy is to open the property dialogue window of any wagon in the train after it has left the portal and change its assigned layer to the correct one. This will set all vehicles in that train to the same correct layer.<br>
 
If you save the '''Route''' after switching to '''Surveyor''' then the train will be saved in the '''Route''' and not in the '''Session'''. If this is an issue then the remedy is to open the property dialogue window of any wagon in the train after it has left the portal and change its assigned layer to the correct one. This will set all vehicles in that train to the same correct layer.<br>
  
−
'''Note:''' It is not recommended that you solve this by moving portals to a '''Session Layer''' if you have multiple '''Sessions''' because the portals will then only appear in the '''Session''' that contains the portals.
+
'''Note:''' It is not recommended that you solve this by moving portals to a '''Session Layer''' if you have multiple '''Sessions''' because the portals will then only appear in the '''Session''' that contains the portals.</td>
 +
</tr>
 +
</table>
 +
<br>
 
<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=629><span id="bottom"></span>&nbsp;</td>
−
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Down -->
−
<td width=75>[[file:NextUp.png|link=#stepQuestions|alt=Next Up|Top]]</td>
+
<td width=50>&#160;</td> <!-- for Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepQuestions|alt=Next Up|Top]]</td>
 
<td width=75>&nbsp;</td>
 
<td width=75>&nbsp;</td>
 
<td width=75>&nbsp;</td>
 
<td width=75>&nbsp;</td>
Line 347: Line 727:
 
----
 
----
 
----
 
----
−
 
 
='''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>
 
<td>
−
<span style="font-size: 17px; font-weight: 700;">More Tutorials and Guides to Using Trainz</span><br>
+
<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="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 
*'''[[Driver Commands List]]'''
 
*'''[[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]]'''
 +
</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|Using the Session Editor]]'''
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>

Latest revision as of 09:17, 29 November 2023

The information in this Wiki Page applies to TRS19 Platinum Edition, Trainz Plus and TRS22. Older versions of Trainz, including T:ANE and TRS19 (standard), do not have the UDS feature described in this document. A more detailed description of the UDS can be found on the Trainz Wiki Page WikiLink.PNG Unified_Driver_Surveyor.
BlueDot10x10.png The UDS ( U nified  D river  S urveyor) Interface allows you to switch instantly between Surveyor and Driver modes without having to reload


Contents
DotPoint.JPG The UDS is only found in TRS19 Platinum Edition, Trainz Plus and TRS22
DotPoint.JPG It provides a method of quickly switching from Driver mode to Surveyor mode and back to Driver again without having to restart a running session after each switch
DotPoint.JPG After switching from Driver to Surveyor and editing you can save your edits before switching back into Driver but it is recommended that you save your work as a new session (unless you really do want to overwrite the original session)
DotPoint.JPG The virtual location of all consists is now stored as part of the Session even if the consists themselves are placed in the Route
DotPoint.JPG The Session Editor has a feature that allows you to reset any or all of the Session Rules before restarting a session


[edit] What is the UDS Interface?

     Top   Next Down Bottom


UDS stands for  U nified  D river  S urveyor and is an "interface" or option built into TRS19 Platinum Edition, Trainz Plus and TRS22 that allows you to jump seamlessly from Driver into Surveyor and then back into Driver again to resume a session at the point where you left it. There is no need to restart a Driver session from the very beginning.



The Scenario:
You are in Driver mode testing out a route and session when you discover a problem.
UDS-Scenario1.png Previously (before the UDS) your only options would be to choose one of the following:-

Options:

Ablue.png ignore the problem (if possible) to continue the session in Driver and fix the problem later, OR
Bblue.png immediately halt the session to fix the problem now


In both cases you would have to:-

Steps: To fix the problem

DotPoint1.JPG terminate Driver and exit back to the Main Menu
DotPoint2.JPG load the route into Surveyor and try to recall exactly where the problem is located
DotPoint3.JPG locate and fix the problem
DotPoint4.JPG save and exit Surveyor
DotPoint5.JPG restart the session in Driver from the beginning (a bit tough if you were 2 hrs or more into the session)


BlueDot10x10.png The UDS interface allows you to switch, via a menu option, directly to Surveyor without having to stop and exit Driver mode first


When using the UDS you switch from Driver to Surveyor with the currently active Driver consist still as the focus and at the place it was located when you switched into Surveyor from Driver.
UDS-Scenario2.png
DotPoint.JPG All the Surveyor tools and options are available for you to use, including the Session Editor (more on that later)
UDS-Scenario3.png
DotPoint.JPG You use the Surveyor tools to fix the problem, such as deleting (as shown left), moving or adding a scenery object.
DotPoint.JPG You can then (if you wish) save the edited route and/or session (again there will be more on that later)
UDS-Scenario4.png
DotPoint.JPG You then switch back into Driver to continue driving the session with the problem fixed


[edit] Switching Modes

     Top Next Up Next Down Bottom
DotPoint.JPG Driver Mode to Surveyor
  UDS-DriverToSurveyor.png
Steps: To switch from Driver to Surveyor:-
DotPoint1.JPG Open the SurveyorToolsIcon S20.png Tools Menu and select  Surveyor Mode  OR press  Ctrl  +  F1 
Warning:
Stop.PNG When you switch to Surveyor mode the Pause option (at the top of the Tools menu) will be automatically turned ON. If you turn this option OFF in Surveyor mode then any consists that were moving in Driver mode (and were then paused when you switched) will start moving again. This will almost certainly cause problems such as derailments.

It also means that ALL other animation effects (smoke, procedural track switch blades, animated scenery assets, sounds, etc) will also be PAUSED.


DotPoint.JPG Surveyor Mode to Driver  
  UDS-SurveyorToDriver.png
Steps: To switch from Surveyor to Driver:-
DotPoint1.JPG Open the SurveyorToolsIcon S20.png Tools Menu and select  Driver Mode  OR press  Ctrl  +  F2 
DotPoint2.JPG If the Paused option is ON in Surveyor mode (the default condition unless you have turned it OFF) then the simulation will be paused and the Paused message will appear on the screen when you switch to Driver mode. Hit the  P  key to Unpause and resume the simulation.


NotePad.PNG The Undo command ( Ctrl  +  Z ) can be used in Surveyor Mode but not in Driver Mode.


[edit] Saving

     Top Next Up Next Down Bottom
NotePad.PNG Notes:
An important change that has been introduced by the UDS is that train vehicle placement is now saved as part of the Session, even if those vehicles have been placed in Route Layers.
PencilTips.PNG It is strongly recommended that all consists be placed into a Session Layer and become part of a Session instead of the Route


Warning:
Stop.PNG If you decide to save your Surveyor edits and select the option to

UDS-OverwriteExistingSession.png

then you will OVERWRITE (a nicer way of saying DESTROY) your starting or original Session


Most of the problems users seem to be experiencing with the UDS, judging from the posts in the Trainz Forums, is when saving their edited Driver session after switching to Surveyor mode.


NotePad.PNG Notes:
DotPoint.JPG Using Driver Mode involves driving consists (either manually or through the AI) and activating session rules. This will change the session parameters
DotPoint.JPG Overwriting the Session will save the consist locations and Session Rules in their new positions/conditions


When you are in Driver Mode at least one of the consists will probably be moving. Some of the Session rules may have already been completed while others may still be running or waiting for events (e.g. triggers to be activated). If, after switching to Surveyor Mode, you then choose to save using the Overwrite existing session option then you will be replacing your original starting Session with a new one with the consists saved in their new positions and the Session rules saved in their new states. So when you later load and restart the Session things will not be the same as they were in the original or starting Session.
 Unless you have a particular reason for overwriting the original Session then the recommended save options are:-
Line740.png
Option Ablue.png Do Not Save the Session
  UDS-DoNotSaveSession.png
Steps: To save the Route only:-
DotPoint1.JPG Left Click the checkbox  Do not save session 

This will save the Route only, using its existing name and it will overwrite the original route. This will save any edits that you have made to the Route but not to the Session.

Line740.png
Option Bblue.png Create a New Session
  UDS-CreateNewSession.png
Steps: To save the Route and a NEW Session:-
DotPoint1.JPG Left Click the checkbox  Create new session 
DotPoint2.JPG Enter a name for the new session

This will save the Route using its existing name and it will overwrite the original route. It will also save the Session using the name you enter in the text box below the checkbox (Stage 3 in the example shown). The original Session will not be altered. This is useful when you want to test out changes to consists, industry settings, Rules, driver commands, etc but do not want to destroy the original Session.

Line740.png
PencilTips.PNG If you have scenery assets (stationary objects) in a Session Layer that you will want to edit after switching from Driver to Surveyor and will need to save those edits but don't want to destroy your starting Session data, then:-
Steps:
DotPoint1.JPG move that Session Layer to the Route Layer Group before starting the Session in Driver. See WikiLink.PNG Moving Layers for more details
DotPoint2.JPG switch from Driver to Surveyor and edit when required. You can safely edit any Route Layer which now includes the moved Session layer
DotPoint3.JPG after each edit you can save (Overwrite) the Route but do not save the Session. Use Option Ablue.png above

When you have completed all the editing, saving and switching between Driver and Surveyor, then:-

Steps:
DotPoint1.JPG exit back to the Surveyor/Driver main screen
DotPoint2.JPG reload the original Session (the saved Session edits will be in the Route that will be loaded along with the Session)
DotPoint3.JPG move the layer from the Route Layer Group back to the Session Layer Group. See WikiLink.PNG Moving Layers for more details
DotPoint4.JPG save (Overwrite) both the Route and the Session


[edit] Resetting the Session Rules

     Top Next Up Next Down Bottom
BlueDot10x10.png After you switch from Driver Mode to Surveyor Mode it may be necessary to restart or reset some of the Session Rules


As mentioned above, when Driver Mode is running some of the Session rules may be completed while others may still be running or waiting for certain events (e.g. triggers to be activated). When you switch to Surveyor Mode these rules may be in a different state compared to what they were at the start of the Session. When you restart Driver Mode these rules may not be in a useful condition.

The Session Editor built into all Trainz versions allows you to add, delete and modify the rules that will operate during a Session.


LinkWiki.PNG Information on the Session Editor can be found at:-


To open the Session Editor open the Edit menu and select  Edit Session 
SessionEditMenuSP1.png

UDS-SessionRules.png

SessionEditMenuRestartRules.png At the bottom of the Session Editor is a new button,  Restart ALL Rules . This will reset or restart ALL rules in the Session.
UDS-CompleteWasComplete.png Some rules, as shown in the screen shot above, have the label (complete was-complete) after the rule name. This indicates that the rule has already been completed. These rules can be individually restarted by a Left Click on the rule and selecting the  Reset  option from the pop up menu. This will change the rule status to (paused).
When the Driver Mode is selected again, all the reset or (paused) rules will be restarted.


[edit] Some Questions Answered

     Top Next Up   Bottom
Question.PNG I have only edited assets that are in the Route layers but selecting Save always sets the option to "Overwrite exiting session" as the default. Why?


Many scenery assets actually have their properties stored in the Session, even when the assets themselves are in a Route layer. Editing the properties of these assets is considered to be a change to the Session. These include:-
DotPoint.JPG junction switches - the left/right switch direction is stored in the Session (but the switch default direction is stored in the Route)
DotPoint.JPG industries - the commodities and quantities loaded/unloaded are stored in the Session
DotPoint.JPG industry enabled wagons - the commodities and quantities carried are stored in the Session
DotPoint.JPG consist locations - this is stored in the Session (TRS19 Platinum Edition, Trainz Plus and TRS22 only
DotPoint.JPG named route objects - while the name is stored in the Route, adding or changing the name is treated as a change to the Session
If you have not altered any Session data or assets that have been placed in a session layer then you can ignore the request to save the Session as well as the Route. Changing the name of an asset, for example, does not alter any session data.


Question.PNG Interlocking Towers (including Enhanced Interlocking Towers) show paths as "not editable" after switching to Surveyor Mode. Why?


If you make the switch from Driver Mode to Surveyor Mode after an IT/EIT path has been activated (but not yet cleared or cancelled) then you will be unable to edit that path. In addition, you will not be able to add new paths to an IT/EIT that has an open active path.
Pierre (pguy), the creator of the EIT asset and associated rules, has a detailed description of this and some possible solutions in a Trainz Forum post at:- EITs and the UDS


Question.PNG Can I add new trains or replace existing trains after switching to Surveyor mode?


You can add additional trains and replace existing ones when in Surveyor mode but it is advised that:-
DotPoint.JPG the Paused option be set ON (the default condition) in Surveyor mode, and
DotPoint.JPG you may have to reset the Driver Setup Rule in the Session Editor particularly if you have added/edited driver commands to the new or altered consist


Question.PNG Does the UDS change how portals work?


This issue is now under investigation by N3V

A train that is driven into a portal and later returned to the layout will be returned in the same layer as the portal and not in the trains originally assigned layer. Trains that are produced by a portal will be assigned to the same layer as the portal. This has  possibly always been the case with portals  but was probably unnoticed until the arrival of the UDS. It seems to have no other noticeable effect on trains.

This could become an issue if you make the switch from Driver to Surveyor after a train has been returned to the layout from a portal. For example, if a train is originally in a Session Layer (as recommended for TRS19 Platinum Edition, Trainz Plus and TRS22) then it is part of a Session. If it is returned from a portal that is in a Route Layer then it will now be in the same Route Layer as the portal and it will be part of the Route, not part of the Session.

If you save the Route after switching to Surveyor then the train will be saved in the Route and not in the Session. If this is an issue then the remedy is to open the property dialogue window of any wagon in the train after it has left the portal and change its assigned layer to the correct one. This will set all vehicles in that train to the same correct layer.

Note: It is not recommended that you solve this by moving portals to a Session Layer if you have multiple Sessions because the portals will then only appear in the Session that contains the portals.


      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 June 2021 and was last updated as shown below.

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