How to Create a Region Asset

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (Region Tags)
m
 
(23 intermediate revisions by one user not shown)
Line 1: Line 1:
 
The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.
 
The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.
 
+
<table>
 +
<tr valign="top">
 +
<td>
 
__TOC__
 
__TOC__
 +
</td>
 +
<td align="center"><span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&#160;Workflow Diagram&#160;</span><br>
 +
[[image:RegionWorkflow.png|link=|alt=Workflow diagram]]</td>
 +
</tr>
 +
</table>
 +
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
<td width=729><span id="stepWhat"></span>&nbsp;</td>
+
<td width=729><span id="stepWhat"></span>&#160;</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
<td width=75>&nbsp;</td>
+
<td width=75>&#160;</td>
 
<td width=75>[[file:NextDown.png|link=#stepCreate|alt=Next Down|Next Down]]</td>
 
<td width=75>[[file:NextDown.png|link=#stepCreate|alt=Next Down|Next Down]]</td>
 
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 
<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
Line 14: Line 22:
 
='''What is a Region?'''=
 
='''What is a Region?'''=
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>A '''Region''' defines some of the characteristics of a geographic location (e.g. a country or a province) that is represented in a route<td>
+
<td>A '''Region''' defines some of the characteristics of a geographic location (e.g. a country or a province) that is represented in a route</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td>[[image:BlueDot10x10.png|link=]]</td>
<td>A '''Region Asset''' is a '''config.txt''' file that contains the region data<td>
+
<td>A '''Region Asset''' is just a '''config.txt''' file (plus a '''thumbnail''') that contains all the data for a region</td>
 
</tr>
 
</tr>
</table><br>
+
</table>
 +
<br>
  
<table bgcolor=#000000 width=604>
+
<table bgcolor=#000000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table cellpadding=4 bgcolor=#ffffb0 width=600>
+
<table cellpadding=2 bgcolor=#ffffb0>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
Line 34: Line 43:
 
----
 
----
 
When a '''Region''' has been assigned to a route, it will set:-
 
When a '''Region''' has been assigned to a route, it will set:-
*the default switch lever to be used in the route
+
<table>
*the colour of the water (lakes, streams, ponds, ocean)
+
<tr valign="top">
*the side of the road, left or right, used by all moving road vehicles
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
*the latitude of a point in the route
+
<td>the default switch lever to be used in the route</td>
*the longitude of a point in the route
+
</tr>
*the altitude of a point in the route
+
<tr valign="top">
*the number and types of moving road vehicles
+
<td>[[image:DotPoint.JPG|10px|link=]]</td>
*the default baseboard grid pattern in '''TRS19''' and later versions
+
<td>the colour of the water (lakes, streams, ponds, ocean) - for '''Legacy Water''' only</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the side of the road, left or right, used by all moving road vehicles</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the latitude of a point in the route</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the longitude of a point in the route</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the altitude of a point in the route</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the number and types of moving road vehicles</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the default baseboard grid pattern in '''TRS19''' and later versions</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 48: Line 83:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
<br>
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
<td width=729><span id="stepCreate"></span>&nbsp;</td>
+
<td width=729><span id="stepCreate"></span>&#160;</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepWhat|alt=Next Up|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepWhat|alt=Next Up|Top]]</td>
Line 61: Line 96:
 
='''How to Create a Region Asset'''=
 
='''How to Create a Region Asset'''=
  
<table cellpadding=4 bgcolor=#ffffff> <!-- BEGIN Step table -->
+
<table width=1000> <!-- BEGIN Step table -->
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:Steps.PNG|link=]]<br><br>
+
<td width=50><span style="font-weight: 700; font-size: 15px;">Steps:</span></td>
<span style="font-size: 17px; font-weight: 700;">Steps</span></td>
+
<td>[[image:DotPoint1.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Create the Asset:</span><br>
<td>[[image:DotPoint1.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Create the Asset:</span><br>
+
 
<table> <!-- BEGIN Step 1 table -->
 
<table> <!-- BEGIN Step 1 table -->
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NewAsset.PNG|link=]]<br><br>
 
<td>[[image:NewAsset.PNG|link=]]<br><br>
 
[[image:NewAssetCreated.PNG|link=]]</td>
 
[[image:NewAssetCreated.PNG|link=]]</td>
<td>From the '''Trainz''' Launcher
+
<td>
#select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Manage Content&nbsp;</span>
+
<table bgcolor=#000000 cellpadding=2>
#in '''Content Manager''' open the '''Developer''' menu
+
<tr valign="top">
#select '''New Content'''
+
<td>
This will create a new asset and open it for editing.
+
<table bgcolor=#ffffff cellpadding=2>
<br><br>
+
<tr valign="top">
A message window will appear that will (hopefully) report on the successful creation of a new asset.
+
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> From the '''Trainz Launcher''':-</td>
*Close the message window
+
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;1&#160;</span></td>
 +
<td>select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&#160;Manage Content&#160;</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;2&#160;</span></td>
 +
<td>in '''Content Manager''' open the <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;Developer&#160;</span> menu</td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;3&#160;</span></td>
 +
<td>select <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;New Content&#160;</span>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>This will create a new asset and open it for editing.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>A message window will appear that will (hopefully) report on the successful creation of a new asset</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
</table> <!-- END Step 1 table -->
+
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;4&#160;</span></td>
 +
<td>Close the message window</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table>
<td colspan="2">
+
</td>
----</td>
+
 
</tr>
 
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 1 table -->
 +
<br>
 +
<table width=1000> <!-- BEGIN Step 2 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>&nbsp;</td>
+
<td width=50>&#160;</td>
<td>[[image:DotPoint2.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Find the New Asset:</span><br>
+
<td>[[image:DotPoint2.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Find the New Asset:</span><br>
<table> <!-- BEGIN Step 2 table -->
+
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NewAssetSelectOpen.PNG|link=]]</td>
 
<td>[[image:NewAssetSelectOpen.PNG|link=]]</td>
 
<td>
 
<td>
*Set the CM Search Filter to '''Open for Editing'''
+
<table bgcolor=#000000 cellpadding=2>
This will display only those assets that have been opened for editing (hopefully only your new and as yet unnamed asset will be shown)
+
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;5&#160;</span></td>
 +
<td>Set the '''Content Manager''' Search Filter to <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;Open for Editing&#160;</span></td>
 +
</tr>
 +
<tr>
 +
<td colspan=2>This will display only those assets that have been opened for editing (hopefully only your new and as yet unnamed asset will be shown)</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
</table> <!-- END Step 2 table -->
+
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table>
<td colspan="2">
+
</td>
----</td>
+
 
</tr>
 
</tr>
 +
</table> <!-- END Step 2 table -->
 +
<br>
 +
<table width=1000> <!-- BEGIN Step 3 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>&nbsp;</td>
+
<td width=50>&#160;</td>
<td>[[image:DotPoint3.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Open the Asset in Windows File Explorer:</span><br>
+
<td>[[image:DotPoint3.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Open the Asset in Windows File Explorer:</span><br>
<table> <!-- BEGIN Step 3 table -->
+
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NewAssetShowExplorer.PNG|link=]]</td>
 
<td>[[image:NewAssetShowExplorer.PNG|link=]]</td>
 
<td>
 
<td>
#Right mouse click on the entry '''New Asset'''
+
<table bgcolor=#000000 cellpadding=2>
#Select '''Open'''
+
<tr valign="top">
#Select '''Show in Explorer'''
+
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;6&#160;</span></td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the entry '''New Asset'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;7&#160;</span></td>
 +
<td>Select <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;Open...&#160;</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;8&#160;</span></td>
 +
<td>Select <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;Show in Explorer&#160;</span></td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 120: Line 213:
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table>
<td colspan="2">
+
<br>
----</td>
+
<table width=1000> <!-- BEGIN Step 4 table -->
</tr>
+
 
<tr valign="top">
 
<tr valign="top">
<td>&nbsp;</td>
+
<td width=50>&#160;</td>
<td>[[image:DotPoint4.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Open Config.txt File in Notepad:</span><br>
+
<td>[[image:DotPoint4.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Open Config.txt File in Notepad:</span>
 
<table> <!-- BEGIN Step 4 table -->
 
<table> <!-- BEGIN Step 4 table -->
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NewAssetOpenExplorer.PNG|link=]]</td>
 
<td>[[image:NewAssetOpenExplorer.PNG|link=]]</td>
<td>There will only be a single item in the asset, its config.txt file
+
<td>
*Double click on the file to open it in Notepad</td>
+
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2>There will only be a single item in the asset, its config.txt file</td>
 
</tr>
 
</tr>
</table> <!-- END Step 4 table -->
+
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;9&#160;</span></td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Double Left Click</span> on the file to open it in '''Notepad'''</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table>
<td colspan="2">
+
</td>
----</td>
+
 
</tr>
 
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 4 table -->
 +
<br>
 +
<table width=1000> <!-- BEGIN Step 5 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>&nbsp;</td>
+
<td width=50>&#160;</td>
<td>[[image:DotPoint5.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Edit the Config.txt File:</span><br>
+
<td>[[image:DotPoint5.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Edit the Config.txt File:</span><br>
 
<table> <!-- BEGIN Step 5 table -->
 
<table> <!-- BEGIN Step 5 table -->
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NewAssetOpenNotepad.PNG|link=]]</td>
 
<td>[[image:NewAssetOpenNotepad.PNG|link=]]</td>
<td>You will need to edit the contents of this file.  
+
<td>
*The next section, [[image:PageLink.PNG|link=]] '''[[#The Config.txt File|The Config.txt File]]''', identifies the changes you will need to make.  
+
<table bgcolor=#000000 cellpadding=2>
*The new name you give to the asset will not take effect until after it has been committed.
+
<tr valign="top">
*After editing, save the changes and exit Notepad.</td>
+
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2>You will need to edit the contents of this file.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;10&#160;</span></td>
 +
<td>The next section, [[image:PageLink.PNG|link=]] '''[[#The Config.txt File|The Config.txt File]]''', identifies the changes you will need to make. The new name you give to the asset will not take effect until '''after''' it has been '''Submitted'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;11&#160;</span></td>
 +
<td>After editing, save the changes and exit '''Notepad'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table> <!-- END Step 5 table -->
 
</table> <!-- END Step 5 table -->
 
<br>
 
<br>
<table cellpadding=4 bgcolor=#fcbcbc> <!-- BEGIN Step 5 warning table -->
+
<table width=1000> <!-- BEGIN Step 5 Warning table -->
 +
<tr valign="top">
 +
<td width=50>&#160;</td>
 +
<td>
 +
<table bgcolor=#ff0000> <!-- BEGIN Step 5 warning table -->
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc>
 +
<tr valign="top"> <!-- warning -->
 +
<td colspan=2><span style="font-size: 17px;"><b>Warning:</b></span></td>
 +
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>Unless you know '''exactly''' what you are doing'''*''',&nbsp;<span style="color: white; background-color: red; font-weight: 700; font-size: 17px;">&nbsp;DO NOT ALTER THE KUID NUMBER&nbsp;</span>&nbsp;that has been added to the file<br>
+
<td>Unless you know '''exactly''' what you are doing'''*''',&#160;<span style="color: white; background-color: red; font-weight: 700; font-size: 17px;">&#160;DO NOT ALTER THE KUID NUMBER&#160;</span>&#160;that has been added to the file<br>
'''*''' but even if you do, think <span style="font-weight: 700; text-decoration: underline">twice</span> before you change it !</td>
+
'''*''' but even if you do, think <span style="font-weight: 700; text-decoration: underline">twice</span> before you change it !
 +
</td>
 
</tr>
 
</tr>
</table> <!-- END Step 5 warning table -->
+
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table>
<td colspan="2">
+
</td>
----</td>
+
 
</tr>
 
</tr>
 +
</table> <!-- END Step 5 warning table -->
 +
<br>
 +
<table width=1000> <!-- BEGIN Step 6 table -->
 
<tr valign="top">
 
<tr valign="top">
<td>&nbsp;</td>
+
<td width=50>&#160;</td>
<td>[[image:DotPoint6.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Add a Thumbnail:</span><br>
+
<td>[[image:DotPoint6.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Add a Thumbnail:</span><br>
<table> <!-- BEGIN Step 6 table -->
+
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td colspan=2>
 
<td colspan=2>
You will need to add a thumbnail image as described in the section [[image:PageLink.PNG|link=]] '''[[#The Thumbnail Image|The Thumbnail Image]]'''. The thumbnail and the config.txt files are the only two items required in this asset.
+
You will need to add a thumbnail image as described in the section [[image:PageLink.PNG|link=]] '''[[#The Thumbnail Image|The Thumbnail Image]]'''. The thumbnail and the config.txt files are the only items required in this asset.
 
<br>
 
<br>
 
[[image:HTMLFolderView4.JPG|link=|alt=Asset contents]]
 
[[image:HTMLFolderView4.JPG|link=|alt=Asset contents]]
The thumbnail does not have to be added immediately but must it be present before the new asset can be used. You can reopen the asset for editing later to add the thumbnail before it is committed.</td>
+
The thumbnail does not have to be added immediately but must it be present before the new asset can be used. You can reopen the asset for editing later to add the thumbnail before the asset is submitted.</td>
 
</tr>
 
</tr>
 
</table> <!-- END Step 6 table -->
 
</table> <!-- END Step 6 table -->
 
</td>
 
</td>
 
</tr>
 
</tr>
<tr>
+
</table> <!-- END Step 6 table -->
<td colspan="2">
+
<br>
----</td>
+
<table width=1000> <!-- BEGIN Step 7 table -->
</tr>
+
 
<tr valign="top">
 
<tr valign="top">
<td>&nbsp;</td>
+
<td width=50>&#160;</td>
<td>[[image:DotPoint7.JPG|link=]]&nbsp;<span style="font-size: 17px; font-weight: 700;">Finish Up:</span>
+
<td>[[image:DotPoint7.JPG|link=]]&#160;<span style="font-size: 17px; font-weight: 700;">Finish Up:</span>
<table> <!-- BEGIN Step 7 table -->
+
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NewAssetSubmit.PNG|link=]]</td>
 
<td>[[image:NewAssetSubmit.PNG|link=]]</td>
 
<td>
 
<td>
*Close the Asset window
+
<table bgcolor=#000000 cellpadding=2>
*Commit the asset in Content manager
+
**Right mouse click on the asset
+
**Select '''Submit Edits'''
+
Hopefully there will be no errors.<br><br>
+
 
+
<table bgcolor=#000000 width=604> <!-- BEGIN Step 7 Notes table -->
+
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table bgcolor=#ffffb0 width=600>
+
<table bgcolor=#ffffff cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:NotePad.PNG|link=]]</td>
+
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;13&#160;</span></td>
<td>Because you still have the Filter '''Open for Editing''' in operation, the now closed and committed asset will vanish from the '''Content Manager''' display. To check that your asset has been correctly created and renamed, set the Search Filter to '''Today'''.</td>
+
<td>Close the Asset window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td><span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;14&#160;</span></td>
 +
<td>Commit the asset in '''Content Manager'''
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the asset</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Select <span style="font-weight: 700; font-size: 15px; color: white; background-color: blue;">&#160;Submit Edits&#160;</span>
 +
Hopefully there will be no errors.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
</table> <!-- END Step 7 Notes table -->
+
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000> <!-- BEGIN Step 7 Notes table -->
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0> <!-- BEGIN Step 7 Notes table -->
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td>Because you still have the Search Filter '''Open for Editing''' in operation, the now closed and '''Submitted''' asset will vanish from the '''Content Manager''' display. To check that your asset has been correctly created and renamed, set the Search Filter to '''Today'''.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table> <!-- END Step 7 Notes table -->
 
<br>
 
<br>
 
<table cellpadding=4 bgcolor=#ff0000> <!-- BEGIN Step 7 errors table -->
 
<table cellpadding=4 bgcolor=#ff0000> <!-- BEGIN Step 7 errors table -->
Line 216: Line 378:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Bug.png|link=]]</td>
 
<td>[[image:Bug.png|link=]]</td>
<td>Some of the most common errors that can occur when creating and committing a new asset are:-
+
<td>Some of the most common errors that can occur when creating and '''Submitting''' a new asset are:-
*no '''''thumbnail image''''' in the asset
+
<table>
*typing errors in the config.txt file
+
<tr valign="top">
*poorly formatted tags in the config.txt file
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
*incorrect file types added to the asset folder
+
<td>no '''''thumbnail image''''' in the asset</td>
*files missing from the asset folder
+
</tr>
*incorrect '''kuid''' value (despite the warning you changed it in '''Step 5''')</td>
+
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>typing errors in the config.txt file</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>poorly formatted tags in the config.txt file</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>incorrect file types added to the asset folder</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>files missing from the asset folder</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>an incorrect '''kuid''' value (despite the warning you changed it in '''Step''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: red;">&#160;5&#160;</span>)</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table> <!-- END Step 7 errors-bugs table -->
 
</table> <!-- END Step 7 errors-bugs table -->
Line 234: Line 417:
 
</tr>
 
</tr>
 
</table> <!-- END Steps table -->
 
</table> <!-- END Steps table -->
 
+
<br>
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
<td width=729><span id="stepConfig"></span>&nbsp;</td>
+
<td width=729><span id="stepConfig"></span>&#160;</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepCreate|alt=Next Up|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepCreate|alt=Next Up|Top]]</td>
Line 246: Line 429:
 
='''The Config.txt File'''=
 
='''The Config.txt File'''=
  
This file should follow the same (or a similar) format as the example below.<br>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
*entries in&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;red&nbsp;</span>&nbsp;must not be changed
+
<tr valign="top">
*the indenting of the lines and the spacing ("tabbing") between the "tags" on the left and their contents on the right are purely to make it easier for humans to read
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
*the use of the '''{ }''' braces is to group tags into common "containers". These containers must not be broken up and the number of '''{''' characters must match the number of '''}''' characters
+
<td>'''All assets must have a config.txt file'''</td>
*the order of the "tags" is '''not''' important
+
</tr>
 +
</table> <!-- END Dot point table -->
 +
<br>
 +
<table cellpadding=4 bgcolor=#eeeeee> <!-- BEGIN Settings table -->
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 +
<tr valign="top">
 +
<td>The region asset must have a '''config.txt''' text file that '''must''' include the following tags:-
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''kind''' set to '''"region"'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''username''' set to the asset title or name</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''kuid''' a unique ID code</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''thumbnails''' set to a 240 by 180 pixel JPG image</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>While not mandatory, the following tag is useful:-
 +
<table>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>'''category-class''' set to '''"YX"'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
</table> <!-- END Settings table -->
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td colspan=2>This file should follow the same (or a similar) format as the example below.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>entries in&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;red&#160;</span>&#160;must not be changed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the indenting of the lines and the spacing ("tabbing") between the "tags" on the left and their contents on the right are purely to make it easier for humans to read</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the use of the '''{&#160;}''' braces is to group tags into common "containers". These containers must not be broken up and the number of '''{''' characters must match the number of '''}''' characters</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>the order of the "tags" is not important</td>
 +
</tr>
 +
</table>
  
  '''kuid'''                              <span style="background-color: red; color: white; font-weight: 700;"><kuid:this is an auto-generated number></span>
+
  '''kuid'''                              <span style="background-color: red; color: white; font-weight: 700;">&lt;kuid: this is an auto-generated number &gt;</span>
  '''kind'''                              "<span style="background-color: red; color: white; font-weight: 700;">region</span>"
+
  '''kind'''                              "<span style="background-color: red; color: white; font-weight: 700;">&#160;region&#160;</span>"
 
  '''username                          "Region data for Tasmania 1950 to 1969"'''
 
  '''username                          "Region data for Tasmania 1950 to 1969"'''
  '''category-class'''                    "<span style="background-color: red; color: white; font-weight: 700;">YX</span>"
+
  '''category-class'''                    "<span style="background-color: red; color: white; font-weight: 700;">&#160;YX&#160;</span>"
 
  '''category-era                      "1950s;1960s"'''
 
  '''category-era                      "1950s;1960s"'''
 
  '''category-region                  "AU"'''
 
  '''category-region                  "AU"'''
 
  '''ontheright                        0'''
 
  '''ontheright                        0'''
 
  '''water-color                      75,128,255'''
 
  '''water-color                      75,128,255'''
  '''defaultjunction                  <kuid:61119:24120>'''
+
  '''defaultjunction                  &lt;kuid:61119:24120&gt;'''
  '''default-texture                  <kuid:-25:1180>'''
+
  '''default-texture                  &lt;kuid:-25:1180&gt;'''
 
  '''trainz-build                      4.8'''
 
  '''trainz-build                      4.8'''
 
  '''longitude                        147.0,26.0,1.0'''
 
  '''longitude                        147.0,26.0,1.0'''
 
  '''latitude                          41.0,50.0,-1.0'''
 
  '''latitude                          41.0,50.0,-1.0'''
 
  '''altitude                          212'''
 
  '''altitude                          212'''
  '''car0                              <kuid:329364:1568>'''
+
  '''car0                              &lt;kuid:329364:1568&gt;'''
 
  '''thumbnails'''
 
  '''thumbnails'''
 
  {
 
  {
 
   '''Default'''
 
   '''Default'''
 
   {
 
   {
     '''width'''                        <span style="background-color: red; color: white; font-weight: 700;">240</span>
+
     '''width'''                        <span style="background-color: red; color: white; font-weight: 700;">&#160;240&#160;</span>
     '''height'''                        <span style="background-color: red; color: white; font-weight: 700;">180</span>
+
     '''height'''                        <span style="background-color: red; color: white; font-weight: 700;">&#160;180&#160;</span>
 
     '''image                        "Tasmania-Region'''<span style="background-color: red; color: white; font-weight: 700;">.jpg</span>"
 
     '''image                        "Tasmania-Region'''<span style="background-color: red; color: white; font-weight: 700;">.jpg</span>"
 
   }
 
   }
Line 279: Line 535:
 
  '''kuid-table'''
 
  '''kuid-table'''
 
  {
 
  {
   '''0                              <kuid:61119:24120>'''
+
   '''0                              &lt;kuid:61119:24120&gt;'''
   '''1                              <kuid:329364:1568>'''
+
   '''1                              &lt;kuid:329364:1568&gt;'''
   '''2                              <kuid:-25:1180>'''
+
   '''2                              &lt;kuid:-25:1180&gt;'''
 
  }
 
  }
+
 
<table cellpadding=4 bgcolor=#eeeeee>
+
<table width=1000 cellpadding=4 bgcolor=#eeeeee>
 
<tr>
 
<tr>
 
<td colspan="2">
 
<td colspan="2">
Line 290: Line 546:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:Gears.PNG|link=]]</td>
+
<td>[[file:Gears.PNG|link=]]</td>
 
<td><span style="font-size: 17px;">'''Settings:'''</span><br>
 
<td><span style="font-size: 17px;">'''Settings:'''</span><br>
'''For the above example:'''<br>
+
'''For the above example:'''
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> kuid </span>&nbsp;is unique to every asset so it is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;not a good idea to choose your own&nbsp;</span>. This will be automatically generated by the '''Content Manager''' program when a new asset is created
+
<table>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> kind </span>&nbsp;identifies the ''type'' of asset and the types of files that '''Trainz''' will expect to find in the asset. It also tells '''Trainz''' how to render and error check the asset. For '''region''' assets, the '''kind''' is "<span style="background-color: red; color: white; font-weight: 700;">region</span>". A list of asset kinds can be found at [[image:WikiLink.PNG|link=]] '''[[KIND_TrainzBaseSpec#KIND_Hierarchy|KIND Hierarchy]]'''
+
<tr valign="top">
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> username </span>&nbsp;is your name for the asset and the name that other users will see. It is a good idea to make it short and meaningful.
+
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> category-class </span>&nbsp;identifies the ''intent'' of the asset and is important in classifying it for filtering and searching. For '''region''' assets, the category class is "<span style="background-color: red; color: white; font-weight: 700;">YX</span>". A list of category classes can be found at [[image:WikiLink.PNG|link=]] '''[[Category-class]]'''
+
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> kuid </span>&#160;is unique to every asset so it is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;not a good idea to choose your own&#160;</span>. This will be automatically generated by the '''Content Manager''' program when a new asset is created</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> category-era </span>&nbsp;identifies the decade or decades in which the region is based (e.g. "1950s"). See the section [[image:PageLink.PNG|link=]] '''[[#Category Era Tag|Category Era Tag]]''' below for more details.
+
</tr>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> category-region </span>&nbsp;identifies the country or countries in which layout is based. See the section [[image:PageLink.PNG|link=]] '''[[#Category Region Tag|Category Region Tag]]''' below for more details.
+
<tr valign="top">
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> ontheright </span>&nbsp;identifies which side of the road is used by road traffic. See the section [[image:PageLink.PNG|link=]] '''[[#On the Right Tag|On the Right Tag]]''' below for more details.
+
<td>[[image:BlackDot10x10.png|link=]]</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> water-color </span>&nbsp;identifies the the colour used by water surfaces in this region. See the section [[image:PageLink.PNG|link=]] '''[[#Water Color Tag|Water Color Tag]]''' below for more details.
+
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> kind </span>&#160;identifies the ''type'' of asset and the types of files that '''Trainz''' will expect to find in the asset. It also tells '''Trainz''' how to render and error check the asset. For '''Region''' assets, the category class is <span style="font-weight: 700; color: white; background-color: red;">&#160;region&#160;</span>. A list of asset kinds can be found at [[file:WikiLink.PNG|link=]] '''[[KIND_TrainzBaseSpec#KIND_Hierarchy|KIND Hierarchy]]'''</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> defaultjunction </span>&nbsp;identifies the junction lever or switch that Trainz will use as its default lever asset whenever a lever is added to a track junction in this region. See the section [[image:PageLink.PNG|link=]] '''[[#Default Junction Tag|Default Junction Tag]]''' below for more details.
+
</tr>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> default-texture </span>&nbsp;identifies the texture that will be applied to every new baseboard that is added to a Route. See the section [[image:PageLink.PNG|link=]] '''[[#Default Texture Tag|Default Texture Tag]]''' below for more details.
+
<tr valign="top">
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> trainz-build </span>&nbsp;identifies the ''minimum'' Trainz version needed for this asset. A list of asset trainz-build numbers and their corresponding Trainz versions can be found at [[image:WikiLink.PNG|link=]] '''[["Trainz-build"_number|Trainz build numbers]]'''
+
<td>[[image:BlackDot10x10.png|link=]]</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> longitude </span>&nbsp;identifies the geographic longitude of a point in the region. See the section [[image:PageLink.PNG|link=]] '''[[#Longitude Tag|Longitude Tag]]''' below for more details.
+
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> username </span>&#160;is your name for the asset and the name that other users will see. It is also the name that will appear in the '''Route Editor''' when the region is being selected. It is a good idea to make it short and meaningful</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> latitude </span>&nbsp;identifies the geographic latitude of a point in the region. See the section [[image:PageLink.PNG|link=]] '''[[#Latitude Tag|Latitude Tag]]''' below for more details.
+
</tr>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> altitude </span>&nbsp;identifies the altitude or '''base height''' of the starting baseboard in the route. See the section [[image:PageLink.PNG|link=]] '''[[#Altitude Tag|Altitude Tag]]''' below for more details.
+
<tr valign="top">
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> car0 </span>&nbsp;identifies the first moving car that will appear on roads in the region. Upto 15 different cars can be specified. See the section [[image:PageLink.PNG|link=]] '''[[#Car Tags|Car Tags]]''' below for more details.
+
<td>[[image:BlackDot10x10.png|link=]]</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> thumbnails </span>&nbsp;container holds the ''preview'' images of the asset shown by the '''Content Manager''' program, the Web version of the ''DLS'' and, for '''some assets''', the Surveyor main menu image(s). See the section [[image:PageLink.PNG|link=]] '''[[#Thumbnails|Thumbnails]]''' below for more details. Complete information on thumbnails can be found at [[image:WikiLink.PNG|link=]] '''[[Thumbnails]]'''
+
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> category-class </span>&#160;identifies the ''intent'' of the asset and is important in classifying it for filtering and searching. For '''Region''' assets, the category class is <span style="font-weight: 700; color: white; background-color: red;">&#160;YX&#160;</span>. A list of category classes can be found at [[file:WikiLink.PNG|link=]] '''[[Category-class]]'''</td>
**The label&nbsp;<span style="background-color: black; color: white; font-weight: 700;">&nbsp;Default&nbsp;</span>&nbsp;is the '''container ID''' or '''placeholder''' for the thumbnail used by CM and the Web based DLS. While its ''exact label'' (or number - eg. "Default", "00", "01", etc) is not important, it must be different from any other labels that might be present in the thumbnail. '''Default''' and '''0''' are commonly used placeholder labels for the 240 x 180 thumbnail image
+
</tr>
***The '''image''' is the name of the thumbnail image. It does not have to be called '''thumbnail.jpg''' but it '''must''' be a <span style="background-color: red; color: white; font-weight: 700;">JPG</span> format image
+
<tr valign="top">
***The '''width''' of the image in pixels must be <span style="background-color: red; color: white; font-weight: 700;">240</span>
+
<td>[[image:BlackDot10x10.png|link=]]</td>
***The '''height''' of the image in pixels must be <span style="background-color: red; color: white; font-weight: 700;">180</span>
+
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> category-era </span>&#160;identifies the decade or decades in which the region is based (e.g. "1950s"). See the section [[image:PageLink.PNG|link=]] '''[[#Category Era Tag|Category Era Tag]]''' below for more details.</td>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> description </span>&nbsp;provides more details for users than the '''username'''
+
</tr>
*The&nbsp;<span style="background-color: black; color: white; font-weight: 700;"> kuid-table </span>&nbsp;contains the kuid values of the '''defaultjunction''' asset and all the '''carN''' assets. See the section [[image:PageLink.PNG|link=]] '''[[#Kuid Table Tag|Kuid Table Tag]]''' below for more details.
+
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> category-region </span>&#160;identifies the country or countries in which layout is based. See the section [[image:PageLink.PNG|link=]] '''[[#Category Region Tag|Category Region Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> ontheright </span>&#160;identifies which side of the road is used by road traffic. See the section [[image:PageLink.PNG|link=]] '''[[#On the Right Tag|On the Right Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> water-color </span>&#160;identifies the the colour used by '''Legacy''' water surfaces in this region. This setting has no effect on the ''''Water Effect Layers'''. See the section [[image:PageLink.PNG|link=]] '''[[#Water Color Tag|Water Color Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> defaultjunction </span>&#160;identifies the junction lever or switch that will be used as its default lever asset whenever a lever is added to a track junction in this region. See the section [[image:PageLink.PNG|link=]] '''[[#Default Junction Tag|Default Junction Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> default-texture </span>&#160;identifies the ground texture that will be applied to every new baseboard that is added to a Route. See the section [[image:PageLink.PNG|link=]] '''[[#Default Texture Tag|Default Texture Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> trainz-build </span>&#160;identifies the ''minimum'' Trainz version needed for this asset. A list of asset trainz-build numbers and their corresponding Trainz versions can be found at [[file:WikiLink.PNG|link=]] '''[["Trainz-build"_number]]'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> longitude </span>&#160;identifies the geographic longitude of a point in the region. See the section [[image:PageLink.PNG|link=]] '''[[#Longitude Tag|Longitude Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> latitude </span>&#160;identifies the geographic latitude of a point in the region. See the section [[image:PageLink.PNG|link=]] '''[[#Latitude Tag|Latitude Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> altitude </span>&#160;identifies the altitude or '''base height''' of the starting baseboard in the route. See the section [[image:PageLink.PNG|link=]] '''[[#Altitude Tag|Altitude Tag]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> car0 </span>&#160;identifies the first moving car that will appear on roads in the region. Upto 15 different cars can be specified. See the section [[image:PageLink.PNG|link=]] '''[[#Car Tags|Car Tags]]''' below for more details.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> thumbnails </span>&#160;container holds the ''preview'' images of the asset shown by the '''Content Manager''' program, the Web version of the ''DLS'' and, for '''some assets''', the Surveyor main menu image(s). See the section [[image:PageLink.PNG|link=]] '''[[#Thumbnails|Thumbnails]]''' below for more details. Complete information on thumbnails can be found at [[image:WikiLink.PNG|link=]] '''[[Thumbnails]]'''
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:DotPointBlack.JPG|10px|link=]]</td>
 +
<td>The label&#160;<span style="background-color: black; color: white; font-weight: 700;">&#160;Default&#160;</span>&#160;is the '''container ID''' or '''placeholder''' for the thumbnail used by CM and the Web based DLS. While its ''exact label'' (or number - eg. "Default", "00", "01", etc) is not important, it must be different from any other labels that might be present in the thumbnail. '''Default''' and '''0''' are commonly used placeholder labels for the 240 x 180 thumbnail image
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackCircle10x10.png|link=]]</td>
 +
<td>The '''image''' is the name of the thumbnail image. It does not have to be called '''thumbnail.jpg''' but it '''must''' be a <span style="background-color: red; color: white; font-weight: 700;">&#160;JPG&#160;</span> format image</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackCircle10x10.png|link=]]</td>
 +
<td>The '''width''' of the image in pixels must be <span style="background-color: red; color: white; font-weight: 700;">&#160;240&#160;</span></td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackCircle10x10.png|link=]]</td>
 +
<td>The '''height''' of the image in pixels must be <span style="background-color: red; color: white; font-weight: 700;">&#160;180&#160;</span></td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> description </span>&#160;provides more details for users than the '''username'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>The&#160;<span style="background-color: black; color: white; font-weight: 700;"> kuid-table </span>&#160;contains the kuid values of the '''defaultjunction''' asset and all the '''carN''' assets. See the section [[image:PageLink.PNG|link=]] '''[[#Kuid Table Tag|Kuid Table Tag]]''' below for more details.</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 323: Line 653:
 
</table>
 
</table>
  
<table cellpadding=4 bgcolor=#ffffe0>
+
<table width=1000 cellpadding=2 bgcolor=#ffffe0>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:PencilTips.PNG|link=]]</td>
 
<td>[[image:PencilTips.PNG|link=]]</td>
Line 332: Line 662:
 
<tr valign="top">
 
<tr valign="top">
 
<td></td>
 
<td></td>
<td>All Trainz assets have a language facility built into their config.txt files that allows other language translations to be added for certain tags, such as the '''username''' and '''description''' tags. A full description of the process can be found on the Trainz Wiki at [[image:WikiLink.PNG|link=]]&nbsp;'''[[HowTo/Localize_an_Asset|Localize an Asset]]''' and a list of all the supported languages with their two character codes at [[image:WikiLink.PNG|link=]]&nbsp;'''[[Localization_code|Localization (country) Codes]]'''.<br>
+
<td>All Trainz assets have a language facility built into their config.txt files that allows other language translations to be added for certain tags, such as the '''username''' and '''description''' tags. A full description of the process can be found on the Trainz Wiki at [[image:WikiLink.PNG|link=]]&#160;'''[[HowTo/Localize_an_Asset|Localize an Asset]]''' and a list of all the supported languages with their two character codes at [[image:WikiLink.PNG|link=]]&#160;'''[[Localization_code|Localization (country) Codes]]'''.<br>
  
 
At the very basic level any creator can easily provide other language translations for the '''username''' and '''description''' tags in the assets they create. Examples are shown below for this sample asset.</td>
 
At the very basic level any creator can easily provide other language translations for the '''username''' and '''description''' tags in the assets they create. Examples are shown below for this sample asset.</td>
Line 353: Line 683:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
<br>
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
<td width=729><span id="stepTags"></span>&nbsp;</td>
+
<td width=729><span id="stepTags"></span>&#160;</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepConfig|alt=Next Up|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepConfig|alt=Next Up|Top]]</td>
Line 365: Line 695:
  
 
='''Region Tags'''=
 
='''Region Tags'''=
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipEra"></span>
 
=='''Category Era Tag'''==
 
=='''Category Era Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipRegion|Skip Down]]</td>
 +
<td width=50>&#160;</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: blue; color: white; font-weight: 700;">&nbsp;NOT compulsory&nbsp;</span>&nbsp;in a Region asset</td>
+
<td>This tag is&#160;<span style="background-color: blue; color: white; font-weight: 700;">&#160;NOT compulsory&#160;</span>&#160;in a Region asset</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 376: Line 718:
 
'''category-era'''<br>
 
'''category-era'''<br>
  
This identifies the decade or decades in which the region is based. The tag data contains text surrounded by quote (") characters. Each decade name ends with an "s" (e.g. "1950s") and multiple consecutive decades can be specified by using a semi-colon (;) as a separator (e.g. "1950s;1960s"). A list of category-eras can be found at [[image:WikiLink.PNG|link=]] '''[["Category-era"_tag|Category-era tag]]'''.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the decade or decades in which the region is based. The tag data contains text surrounded by quote (") characters. Each decade name ends with an "s" (e.g. "1950s") and multiple consecutive decades can be specified by using a semi-colon (;) as a separator (e.g. "1950s;1960s"). A list of category-eras can be found at [[image:WikiLink.PNG|link=]] '''[["Category-era"_tag|Category-era tag]]'''.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  category-era                                    "2000s"
 
  category-era                                    "2000s"
 +
</td>
 +
<td width=300>Years 2000 to 2009</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  category-era                                    "1910s;1920s;1930s;1940s;1950s"
 
  category-era                                    "1910s;1920s;1930s;1940s;1950s"
 
+
</td>
 +
<td>Years 1910 to 1959</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipRegion"></span>
 
=='''Category Region Tag'''==
 
=='''Category Region Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipRight|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipEra|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: blue; color: white; font-weight: 700;">&nbsp;NOT compulsory&nbsp;</span>&nbsp;in a Region asset</td>
+
<td>This tag is&#160;<span style="background-color: blue; color: white; font-weight: 700;">&#160;NOT compulsory&#160;</span>&#160;in a Region asset</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 393: Line 764:
 
'''category-region'''<br>
 
'''category-region'''<br>
  
This identifies the country or countries in which the region is based. The tag data contains text surrounded by quote (") characters. Each country has a two letter code (e.g. "AU" for Australia) and multiple countries can be specified by using a semi-colon (;) as a separator (e.g. "AU;UK;US"). If no country is to be specified then the two character code "00" (double zero) is used. A list of countries (category regions) can be found at [[image:WikiLink.PNG|link=]] '''[["Category-region"_tag|Category-region tag]]'''.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the country or countries in which the region is based. The tag data contains text surrounded by quote (") characters. Each country has a two letter code (e.g. "AU" for Australia) and multiple countries can be specified by using a semi-colon (;) as a separator (e.g. "AU;UK;US"). If no country is to be specified then the two character code "00" (double zero) is used. A list of countries (category regions) can be found at [[image:WikiLink.PNG|link=]] '''[["Category-region"_tag|Category-region tag]]'''.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td width>
 
  category-region                                    "00"
 
  category-region                                    "00"
 +
</td>
 +
<td width=300>Unassigned</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  category-region                                    "US"
 
  category-region                                    "US"
 +
</td>
 +
<td>USA</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  category-region                                    "AU;UK;NZ"
 
  category-region                                    "AU;UK;NZ"
 
+
</td>
 +
<td>Australia, United Kingdom, New Zealand</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipRight"></span>
 
=='''On the Right Tag'''==
 
=='''On the Right Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipWater|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipRegion|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 411: Line 816:
 
'''ontheright''' (no hyphens between the words)<br>
 
'''ontheright''' (no hyphens between the words)<br>
  
This identifies which side of the road is used by road traffic in this region. The tag data contains a binary value ('''0''' or '''1'''). 0 = left side, 1 = right side.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies which side of the road is used by road traffic in this region. The tag data contains a binary value ('''0''' or '''1'''). 0 = left side, 1 = right side.<br>
 +
 
 +
United Kingdom, Ireland, Australia, New Zealand, Japan and many former British colonies would use a value of 0. Most of the rest of the world would use a value of 1.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  ontheright                                    0
 
  ontheright                                    0
 +
</td>
 +
<td width=300>Left side driving</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  ontheright                                    1
 
  ontheright                                    1
 
+
</td>
 +
<td>Right side driving</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipWater"></span>
 
=='''Water Color Tag'''==
 
=='''Water Color Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipJunction|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipRight|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#fcbcbc>
+
<table width=1000 cellpadding=2 bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>The '''water-color tag''' in a '''Region''' asset has been superseded by the '''Water Color Lighting Setting''' which is set in the [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</td>
+
<td>The '''water-color tag''' in a '''Region''' asset has been superseded by the '''Water Effect Layers''' in '''Trainz Plus''' and '''TRS22'''.</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>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset with an asset build number of '''3.4''' and higher</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset with an asset build number of '''3.4''' (TRS2010 SP4) and higher</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 435: Line 871:
 
'''water-color'''<br>
 
'''water-color'''<br>
  
This identifies the colour used by water surfaces added by the Surveyor '''Terrain Tool''' in this region. The tag contains three integers separated by commas (e.g. 75,128,255). The integers specify the RGB ('''R'''ed, '''G'''reen, '''B'''lue) colour values to be used and each value is from '''0''' to '''255'''.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the colour used by water surfaces added by the Surveyor '''Terrain Tool''' in this region. The tag contains three integers separated by commas (e.g. 75,128,255). The integers specify the '''RGB''' (<span style="font-weight: 700; font-size: 17px;color: white;"><span style="background-color: red;">&#160;Red&#160;</span>&#160;<span style="background-color: green;">&#160;Green&#160;</span>&#160;<span style="background-color: blue;">&#160;Blue&#160;</span></span>) colour values to be used and each value is from '''0''' to '''255'''.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  water-color                                    0,155,255
 
  water-color                                    0,155,255
 +
</td>
 +
<td bgcolor=#009bff width=300>&#160;&#160;</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  water-color                                    75,128,255
 
  water-color                                    75,128,255
 
+
</td>
 +
<td bgcolor=#4880ff>&#160;&#160;</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipJunction"></span>
 
=='''Default Junction Tag'''==
 
=='''Default Junction Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipTexture|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipWater|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset with an asset build number of '''3.4''' and higher</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset with an asset build number of '''3.4''' and higher</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 452: Line 917:
 
'''defaultjunction''' (no hyphen between the two words)<br>
 
'''defaultjunction''' (no hyphen between the two words)<br>
  
This identifies the junction lever or switch that Trainz will use as its default lever asset whenever a lever is added to a track junction in this region. The tag data contains a single valid kuid (e.g. &lt;kuid:61119:24120&gt;).<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the junction lever or switch that Trainz will use as its default lever asset whenever a lever is added to a track junction in this region. The tag data contains a single valid kuid (e.g. &lt;kuid:61119:24120&gt;).<br>
  
The kuid value of the switch lever must also be added to the '''kuid-table''' container of the config.txt file.<br>
+
The kuid value of the switch lever must also be added to the '''kuid-table''' container of the config.txt file.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  defaultjunction                                    &lt;kuid:61119:24120&gt;
 
  defaultjunction                                    &lt;kuid:61119:24120&gt;
 +
</td>
 +
<td width=300>Lever Throw Over</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  defaultjunction                                    &lt;kuid2:63290:24043:3&gt;
 
  defaultjunction                                    &lt;kuid2:63290:24043:3&gt;
 
+
</td>
 +
<td>Switch Tall Frame 1</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipTexture"></span>
 
=='''Default Texture Tag'''==
 
=='''Default Texture Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipBuild|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipJunction|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is <span style="color: white; background-color: black; font-weight:700;">&nbsp;only valid&nbsp;</span> in a Region asset with a build number of '''4.8''' and higher ('''TRS19 SP3''' and later)</td>
+
<td>This tag is <span style="color: white; background-color: black; font-weight:700;">&#160;only valid&#160;</span> in a Region asset with a build number of '''4.8''' and higher ('''TRS19 SP3''' and later)</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 471: Line 965:
 
'''default-texture'''<br>
 
'''default-texture'''<br>
  
This identifies the default texture that will be applied to every new baseboard that is added. If it is not present then a system default texture will be used on new baseboards in '''Trainz TRS19''' and later. If present then the '''Trainz Build Tag''' must also be present and set to a minimum value of '''4.8''' ('''TRS19 SP3''' and later).<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the default texture that will be applied to every new baseboard that is added. If it is not present then a system default texture will be used on new baseboards in '''Trainz TRS19''' and later. If present then the '''Trainz Build Tag''' must also be present and set to a minimum value of '''4.8''' ('''TRS19 SP3''' and later).<br>
  
 
The kuid value shown in the sample '''config.txt''' above, '''&lt;kuid:-25:1180&gt;''', is for the standard '''TRS19''' grid pattern.<br>
 
The kuid value shown in the sample '''config.txt''' above, '''&lt;kuid:-25:1180&gt;''', is for the standard '''TRS19''' grid pattern.<br>
  
The kuid value of the texture must also be added to the '''kuid-table''' container of the config.txt file.<br>
+
The kuid value of the texture must also be added to the '''kuid-table''' container of the config.txt file.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  default-texture                                    &lt;kuid:-25:1180&gt;
 
  default-texture                                    &lt;kuid:-25:1180&gt;
 +
</td>
 +
<td width=300>Grid (PBR)</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  default-texture                                    &lt;kuid:455526:50038&gt;
 
  default-texture                                    &lt;kuid:455526:50038&gt;
 
+
</td>
 +
<td>FX PBR Gravel 03</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipBuild"></span>
 
=='''Trainz Build Tag'''==
 
=='''Trainz Build Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipLongitude|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipTexture|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: blue; color: white; font-weight: 700;">&nbsp;NOT compulsory&nbsp;</span>&nbsp;in a Region asset unless the '''Default Texture Tag''' is present</td>
+
<td>This tag is&#160;<span style="background-color: blue; color: white; font-weight: 700;">&#160;NOT compulsory&#160;</span>&#160;in a Region asset unless the '''Default Texture Tag''' is present</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 492: Line 1,015:
 
'''trainz-build'''<br>
 
'''trainz-build'''<br>
  
The identifies the minimum version of '''Trainz''' that wlll be needed to use this region asset. A list of asset '''trainz-build''' numbers and their corresponding '''Trainz''' versions can be found at [[image:WikiLink.PNG|link=]] '''[["Trainz-build"_number|Trainz build numbers]]'''
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the minimum version of '''Trainz''' that wlll be needed to use this region asset. A list of asset '''trainz-build''' numbers and their corresponding '''Trainz''' versions can be found at [[image:WikiLink.PNG|link=]] '''[["Trainz-build"_number|Trainz build numbers]]'''</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
<table bgcolor=#000000 width=904>
 
<table bgcolor=#000000 width=904>
Line 516: Line 1,044:
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  trainz-build                                    3.7
 
  trainz-build                                    3.7
 +
</td>
 +
<td width=300>TRS12 SP1 and above</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  trainz-build                                    5.0
 
  trainz-build                                    5.0
 +
</td>
 +
<td>TRS19 SP5 and above</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipLongitude"></span>
 +
=='''Longitude Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipLatitude|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipBuild|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
=='''Longitude Tag'''==
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
+
<table cellpadding=4 bgcolor=#c1e7e7>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset with an asset build number of '''3.4''' and higher</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset with an asset build number of '''3.4''' and higher</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding=4 bgcolor=#fcbcbc>
+
<table cellpadding=2 bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>The '''Longitude tag''' in a '''Region''' asset has been superseded by the '''Longitude Setting''' in the [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</td>
+
<td>The '''Longitude tag''' in a '''Region''' asset has been superseded by the '''Longitude Setting''' in the [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 537: Line 1,089:
 
'''longitude'''<br>
 
'''longitude'''<br>
  
This identifies the geographic longitude of a point in the region. The tag contains three ''floating point'' or ''decimal'' values separated by commas (e.g. 147.0,26.0,1.0). The first value is the longitude '''degrees''', the second value is the longitude '''minutes''' and the third is the '''East/West''' value (1.0 = East, -1.0 = West). For example: 147.0,26.0,1.0 would represent longitude 147 degrees 26 minutes East.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the geographic longitude of a point in the region. The tag contains three ''floating point'' or ''decimal'' values separated by commas (e.g. 147.0,26.0,1.0). The first value is the longitude '''degrees''', the second value is the longitude '''minutes''' and the third is the '''East/West''' value (1.0 = East, -1.0 = West). For example: 147.0,26.0,1.0 would represent longitude 147 degrees 26 minutes East.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
<table bgcolor=#000000 width=904>
 
<table bgcolor=#000000 width=904>
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table cellpadding=4 bgcolor=#ffffb0 width=900>
+
<table cellpadding=2 bgcolor=#ffffb0 width=900>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
Line 555: Line 1,112:
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  longitude                                    153.0,2.0,1.0
 
  longitude                                    153.0,2.0,1.0
 +
</td>
 +
<td width=300>East</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  longitude                                    2.0,20.0,-1.0
 
  longitude                                    2.0,20.0,-1.0
 +
</td>
 +
<td>West</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipLatitude"></span>
 +
=='''Latitude Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipAltitude|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipLongitude|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
=='''Latitude Tag'''==
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
+
<table cellpadding=4 bgcolor=#c1e7e7>
+
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset with an asset build number of '''3.4''' and higher</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset with an asset build number of '''3.4''' and higher</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding=4 bgcolor=#fcbcbc>
+
<table cellpadding=2 bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>The '''Latitude tag''' in a '''Region''' asset has been superseded by the '''Latitude Setting''' in the [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</td>
+
<td>The '''Latitude tag''' in a '''Region''' asset has been superseded by the '''Latitude Setting''' in the [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 576: Line 1,157:
 
'''latitude'''<br>
 
'''latitude'''<br>
  
This identifies the geographic latitude of a point in the region. The tag contains three ''floating point'' or ''decimal'' values separated by commas (e.g. 41,0,50.0,-1.0). The first value is the latitude '''degrees''', the second value is the latitude '''minutes''' and the third is the '''North/South''' value (1.0 = North, -1.0 = South). For example: 41.0,50.0,-1.0 would represent latitude 41 degrees 50 minutes South.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This identifies the geographic latitude of a point in the region. The tag contains three ''floating point'' or ''decimal'' values separated by commas (e.g. 41,0,50.0,-1.0). The first value is the latitude '''degrees''', the second value is the latitude '''minutes''' and the third is the '''North/South''' value (1.0 = North, -1.0 = South). For example: 41.0,50.0,-1.0 would represent latitude 41 degrees 50 minutes South.</td>
 +
</tr>
 +
</table>
 +
<br>
  
<table bgcolor=#000000 width=904>
+
<table width=1000 bgcolor=#000000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table cellpadding=4 bgcolor=#ffffb0 width=900>
+
<table width=996 bgcolor=#ffffb0 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
Line 587: Line 1,173:
 
----
 
----
 
The purpose of the '''Latitude''' entry is to:-
 
The purpose of the '''Latitude''' entry is to:-
*determine the season of the year along with the '''Date''' setting. Many '''SpeedTrees''' assets, for example, use the season to determine which foliage layer should be used. Both the '''Latitude''' and '''Date''' can be set in the [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''.
+
<table>
*set the sun angle and its maximum height above the horizon line at noon. The times of sunrise and sunset are fixed at 06:00 and 18:00 and these cannot be changed.
+
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>determine the season of the year along with the '''Date''' setting. Many '''SpeedTrees''' assets, for example, use the season to determine which foliage layer should be used. Both the '''Latitude''' and '''Date''' can be set in the [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>set the sun angle and its maximum height above the horizon line at noon. The times of sunrise and sunset are fixed at 06:00 and 18:00 and these cannot be changed.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
</table><br>
+
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  latitude                                    27.0,28.0,-1.0
 
  latitude                                    27.0,28.0,-1.0
 +
</td>
 +
<td width=300>South</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  latitude                                    48.0,48.0,1.0
 
  latitude                                    48.0,48.0,1.0
 
+
</td>
 +
<td>North</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipAltitude"></span>
 
=='''Altitude Tag'''==
 
=='''Altitude Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipCar|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipLatitude|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset with an asset build number of '''3.4''' and higher</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset with an asset build number of '''3.4''' and higher</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding=4 bgcolor=#fcbcbc>
+
<table cellpadding=2 bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>The '''Altitude tag''' in a '''Region''' asset has been superseded by the '''World Origin Altitude Setting''' in the [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</td>
+
<td>The '''Altitude tag''' in a '''Region''' asset has been superseded by the '''World Origin Altitude Setting''' in the [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''</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>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 
<td>The altitude can be set by selecting a '''Region''':-  
 
<td>The altitude can be set by selecting a '''Region''':-  
 
*when a new route is created - the route '''base height''' will be set to the altitude shown in the selected region so the first baseboard will have its height set to that altitude instead of the usual starting height of 0 metres
 
*when a new route is created - the route '''base height''' will be set to the altitude shown in the selected region so the first baseboard will have its height set to that altitude instead of the usual starting height of 0 metres
Line 626: Line 1,246:
 
'''altitude'''<br>
 
'''altitude'''<br>
  
This sets the initial altitude (height above sea level) of the route. It is also used in the display of snow but only with those scenery assets that have a snow effect layer.<br>
+
<table width=1000>
 +
<tr valign="top">
 +
<td>This sets the initial altitude (height above sea level) of the route. It is also used in the display of snow but only with those scenery assets that have a snow effect layer.<br>
  
 
The tag data contains a single integer that represents the altitude in '''metres'''. All terrain and object heights will be set relative to that altitude. For example: if the first baseboard of a route is manually raised to a height of '''20 metres''' using the '''Terrain Height Tool''' and the route is then assigned to a region with the altitude set to '''100 metres''', then the first baseboard will have a height above sea level of 20 + 100 = '''120 metres'''.<br>
 
The tag data contains a single integer that represents the altitude in '''metres'''. All terrain and object heights will be set relative to that altitude. For example: if the first baseboard of a route is manually raised to a height of '''20 metres''' using the '''Terrain Height Tool''' and the route is then assigned to a region with the altitude set to '''100 metres''', then the first baseboard will have a height above sea level of 20 + 100 = '''120 metres'''.<br>
  
The altitude tag works with the '''Snow Altitude Setting''' which is set in the [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''.<br>
+
The altitude tag works with the '''Snow Altitude Setting''' which is set in the [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Environment_Tools|Environment Tools]]'''.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
<table bgcolor=#000000 width=900>
 
<table bgcolor=#000000 width=900>
Line 643: Line 1,268:
 
</td>
 
</td>
 
</tr>
 
</tr>
</table><br>
+
</table>
 +
<br>
  
 
'''Examples:'''
 
'''Examples:'''
 +
<table width=800>
 +
<tr>
 +
<td>
 
  altitude                                    0
 
  altitude                                    0
 +
</td>
 +
<td width=300>metres</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  altitude                                    100
 
  altitude                                    100
 
+
</td>
 +
<td>metres</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipCar"></span>
 
=='''Car Tags'''==
 
=='''Car Tags'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipKuid|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipAltitude|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: blue; color: white; font-weight: 700;">&nbsp;NOT compulsory&nbsp;</span>&nbsp;in a Region asset. If not present then no moving vehicles will appear</td>
+
<td>This tag is&#160;<span style="background-color: blue; color: white; font-weight: 700;">&#160;NOT compulsory&#160;</span>&#160;in a Region asset. If not present then no moving vehicles will appear</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 661: Line 1,311:
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table cellpadding=4 bgcolor=#ffffb0 width=900>
+
<table cellpadding=2 bgcolor=#ffffb0 width=900>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 
----
 
----
*There is some confusion over the maximum number of '''different types''' of moving vehicles allowed in a session. Some region assets available on the '''DLS''' claim to produce as many as 100 different types of moving vehicles but whether more than 15 different types can be seen in a '''Driver''' session at any one time is, as yet, unclear.
+
<table>
*The '''carrate''' tag, which is used to control the rate at which moving vehicles are created (i.e. how many per minute), has been declared '''obsolete''' in Route assets. This tag is not used in a '''Region''' asset but has been used in some Route config.txt files. It only applies to road spline assets that support road traffic.
+
<tr valign="top">
 +
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>There is some confusion over the maximum number of '''different types''' of moving vehicles allowed in a session. Some region assets available on the '''DLS''' claim to produce as many as 100 different types of moving vehicles but whether more than 15 different types can be seen in a '''Driver''' session at any one time is, as yet, unclear.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>The '''carrate''' tag, which is used to control the rate at which moving vehicles are created (i.e. how many per minute), has been declared '''obsolete''' in Route assets. This tag is not used in a '''Region''' asset but has been used in some Route config.txt files. It only applies to road spline assets that support road traffic.</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 677: Line 1,335:
 
'''car0''', '''car1''', '''car2''', etc<br>
 
'''car0''', '''car1''', '''car2''', etc<br>
  
The Car Tag identifies the moving vehicles (cars, trucks, etc) that will appear on roads in the region. Each car tag contains just a single kuid value (e.g. <kuid:329364:1568>) that identifies a single vehicle. There are restrictions and requirements:-
+
<table width=1000>
*Up to 15 different vehicles (see '''Notes''' above), each as a separate tag from '''car0''' to '''car14''' with their '''kuid''' values, can be specified in a region. The car tag numbers must be consecutive with no missing or duplicated entries (see '''Notes''' above)
+
<tr valign="top">
*'''The vehicles must be specially configured to allow them to be used as moving vehicles''' - static car assets cannot be used. See [[image:WikiLink.PNG|link=]]&nbsp;'''[[HowTo/Build_a_Car_for_Traffic_(stand-alone_version)#Load_Model_into_Trainz|Build a Car for Traffic]]''' for information on how to configure a static vehicle asset for road traffic
+
<td>The Car Tag identifies the moving vehicles (cars, trucks, etc) that will appear on roads in the region. Each car tag contains just a single kuid value (e.g. &lt;kuid:329364:1568&gt;) that identifies a single vehicle. There are restrictions and requirements:-
*'''Not all roads are configured to carry moving vehicles'''
+
<table>
*The [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Environment_Tools|Environment Tools]]''' has a control that will '''enable''' and '''disable''' ALL road traffic. If this is set to '''disable''' then the car tags will be ignored and no moving vehicles will appear.
+
<tr valign="top">
*The kuids of the vehicles must be added to the '''kuid-table''' container of the config.txt file
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
For example, the following entries will specify just 4 different moving vehicles for the region.<br>
+
<td>Up to 15 different vehicles (see '''Notes''' above), each as a separate tag from '''car0''' to '''car14''' with their '''kuid''' values, can be specified in a region. The car tag numbers must be consecutive with no missing or duplicated entries (see '''Notes''' above). For example, the following entries will specify just 4 different moving vehicles for the region.
  
 
'''Example:'''
 
'''Example:'''
  car0                                    <kuid:329364:1568>
+
  car0                                    &lt;kuid:329364:1568&gt;
  car1                                    <kuid:309161:100599>
+
  car1                                    &lt;kuid:309161:100599&gt;
  car2                                    <kuid2:329364:1689:1>
+
  car2                                    &lt;kuid2:329364:1689:1&gt;
  car3                                    <kuid2:329364:1707:1>
+
  car3                                    &lt;kuid2:329364:1707:1&gt;
 +
 
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''The vehicles must be specially configured to allow them to be used as moving vehicles''' - static car assets cannot be used. See [[image:WikiLink.PNG|link=]]&#160;'''[[HowTo/Build_a_Car_for_Traffic_(stand-alone_version)#Load_Model_into_Trainz|Build a Car for Traffic]]''' for information on how to configure a static vehicle asset for road traffic</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''Not all roads are configured to carry moving vehicles'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>The [[image:WikiLink.PNG|link=]]&#160;'''[[How_to_Use_Environment_Tools|Environment Tools]]''' has a control that will '''enable''' and '''disable''' ALL road traffic. If this is set to '''disable''' then the car tags will be ignored and no moving vehicles will appear</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>The kuids of the vehicles must be added to the '''kuid-table''' container of the config.txt file.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
  
<table cellpadding=4 bgcolor=#fcbcbc>
+
<table cellpadding=2 bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[file:Stop.PNG|link=]]</td>
 
<td>[[file:Stop.PNG|link=]]</td>
Line 697: Line 1,379:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipKuid"></span>
 
=='''Kuid Table Tag'''==
 
=='''Kuid Table Tag'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#stepThumb|Skip Down]]</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipCar|Skip Up]]</td>
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
<td>This tag is&nbsp;<span style="background-color: red; color: white; font-weight: 700;">&nbsp;compulsory&nbsp;</span>&nbsp;in a Region asset if the '''defaultjunction''', '''default-texture''' or '''car''' tags are used</td>
+
<td>This tag is&#160;<span style="background-color: red; color: white; font-weight: 700;">&#160;compulsory&#160;</span>&#160;in a Region asset if the '''defaultjunction''', '''default-texture''' or '''car''' tags are used</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 709: Line 1,403:
 
'''kuid-table'''<br>
 
'''kuid-table'''<br>
  
This must contain the kuids of the '''Default Junction Tag''', the '''Default Texture Tag''' and all the cars specified in the '''car''' tags - if any of them are present. The kuid order is not important and the tag numbers ("0", "1", etc) do not have to match those used in the '''car''' tags. Using the examples shown above, the '''kuid-table''' could be as shown below.
+
<table width=1000>
 
+
<tr valign="top">
 +
<td>This must contain the kuids of the '''Default Junction Tag''', the '''Default Texture Tag''' and all the cars specified in the '''car''' tags - if any of them are present. The kuid order is not important and the tag numbers ("0", "1", etc) do not have to match those used in the '''car''' tags. Using the examples shown above, the '''kuid-table''' could be as shown below.</td>
 +
</tr>
 +
<tr>
 +
<td>
 
  kuid-table
 
  kuid-table
 
  {
 
  {
   0                                    <kuid:61119:24120>
+
   0                                    &lt;kuid:61119:24120&gt;
   1                                    <kuid:-25:1180>
+
   1                                    &lt;kuid:-25:1180&gt;
   2                                    <kuid:329364:1568>
+
   2                                    &lt;kuid:329364:1568&gt;
   3                                    <kuid:309161:100599>
+
   3                                    &lt;kuid:309161:100599&gt;
   4                                    <kuid2:329364:1689:1>
+
   4                                    &lt;kuid2:329364:1689:1&gt;
   5                                    <kuid2:329364:1707:1>
+
   5                                    &lt;kuid2:329364:1707:1&gt;
 
  }
 
  }
  
 
In this example, the first kuid value is for the '''defaultjunction''', the second is for the '''default-texture''' and the remaining kuid values are for the four road vehicles, but the order of the entries is not important.
 
In this example, the first kuid value is for the '''defaultjunction''', the second is for the '''default-texture''' and the remaining kuid values are for the four road vehicles, but the order of the entries is not important.
 +
</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="stepThumb"></span>&nbsp;</td>
+
<td width=629><span id="stepThumb"></span>&#160;</td>
 +
<td width=50>&#160;</td>
 +
<td width=50>[[image:SkipUp.png|link=#skipKuid|Skip Up]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepTags|alt=Next Up|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepTags|alt=Next Up|Top]]</td>
Line 732: Line 1,436:
 
</tr>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
 
+
<br>
 
='''The Thumbnail Image'''=
 
='''The Thumbnail Image'''=
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 
<td>'''A thumbnail image MUST be present in the asset'''</td>
 
<td>'''A thumbnail image MUST be present in the asset'''</td>
 
</tr>
 
</tr>
Line 744: Line 1,448:
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table cellpadding=4 bgcolor=#ffffb0 width=900>
+
<table cellpadding=2 bgcolor=#ffffb0 width=900>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
Line 750: Line 1,454:
 
----
 
----
 
The thumbnail image:-
 
The thumbnail image:-
*must be in '''JPG''' format.
+
<table>
*must be 240 pixels wide by 180 pixels tall.
+
<tr valign="top">
*'''does not''' have to be named ''thumbnail.jpg'' as long as the name used is in the '''Thumbnails''' container in the '''config.txt''' file.
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>must be in '''JPG''' format</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>must be 240 pixels wide by 180 pixels tall</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>'''does not''' have to be named ''thumbnail.jpg'' as long as the name used is in the '''Thumbnails''' container in the '''config.txt''' file.</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 759: Line 1,474:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
<br>
 
='''Using the Asset'''=
 
='''Using the Asset'''=
  
 
Once the new asset has been committed it will be available for use as a '''Region'''.
 
Once the new asset has been committed it will be available for use as a '''Region'''.
  
<table cellpadding=4 bgcolor=#fcbcbc>
+
<table cellpadding=2 bgcolor=#fcbcbc>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
Line 771: Line 1,486:
 
</table>
 
</table>
  
The region is specified when a new route is created and it can be altered by selecting '''Edit Route''' from the main menu in '''TANE''' or the edit menu in '''TRS19'''.
+
<table width=1000>
 +
<tr valign="top">
 +
<td>The region is specified when a new route is created and it can be altered by selecting '''Edit Route''' from the main menu in '''TANE''' or the edit menu in '''TRS19''' and later versions.</td>
 +
</tr>
 +
</table>
 +
<br>
  
 
[[image:TasmaniaRegion.png|link=|alt=Load a Region]]
 
[[image:TasmaniaRegion.png|link=|alt=Load a Region]]
Line 777: Line 1,497:
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<tr valign="top">
 
<tr valign="top">
<td width=729><span id="bottom"></span>&nbsp;</td>
+
<td width=729><span id="bottom"></span>&#160;</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepThumb|alt=Next Up|Top]]</td>
 
<td width=75>[[file:NextUp.png|link=#stepThumb|alt=Next Up|Top]]</td>
<td width=75>&nbsp;</td>
+
<td width=75>&#160;</td>
<td width=75>&nbsp;</td>
+
<td width=75>&#160;</td>
 
</tr>
 
</tr>
 
</table> <!-- END Nav Buttons Table -->
 
</table> <!-- END Nav Buttons Table -->
Line 787: Line 1,507:
 
----
 
----
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
<table cellpadding=4 bgcolor=#ffffff>
+
<table cellpadding=2 bgcolor=#ffffff>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:TrainzWiki.png|link=]]</td>
 
<td>[[image:TrainzWiki.png|link=]]</td>

Latest revision as of 08:20, 9 March 2024

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

Contents

 Workflow Diagram 
Workflow diagram
  Top   Next Down Bottom

[edit] What is a Region?

BlueDot10x10.png A Region defines some of the characteristics of a geographic location (e.g. a country or a province) that is represented in a route
BlueDot10x10.png A Region Asset is just a config.txt file (plus a thumbnail) that contains all the data for a region


NotePad.PNG Region Data:

When a Region has been assigned to a route, it will set:-

DotPoint.JPG the default switch lever to be used in the route
DotPoint.JPG the colour of the water (lakes, streams, ponds, ocean) - for Legacy Water only
DotPoint.JPG the side of the road, left or right, used by all moving road vehicles
DotPoint.JPG the latitude of a point in the route
DotPoint.JPG the longitude of a point in the route
DotPoint.JPG the altitude of a point in the route
DotPoint.JPG the number and types of moving road vehicles
DotPoint.JPG the default baseboard grid pattern in TRS19 and later versions


  Top Next Up Next Down Bottom

[edit] How to Create a Region Asset

Steps: DotPoint1.JPG Create the Asset:
NewAsset.PNG

NewAssetCreated.PNG
Steps: From the Trainz Launcher:-
 1  select  Manage Content 
 2  in Content Manager open the  Developer  menu
 3  select  New Content 
DotPoint.JPG This will create a new asset and open it for editing.
DotPoint.JPG A message window will appear that will (hopefully) report on the successful creation of a new asset
 4  Close the message window


  DotPoint2.JPG Find the New Asset:
NewAssetSelectOpen.PNG
 5  Set the Content Manager Search Filter to  Open for Editing 
This will display only those assets that have been opened for editing (hopefully only your new and as yet unnamed asset will be shown)


  DotPoint3.JPG Open the Asset in Windows File Explorer:
NewAssetShowExplorer.PNG
 6  Right Click on the entry New Asset
 7  Select  Open... 
 8  Select  Show in Explorer 


  DotPoint4.JPG Open Config.txt File in Notepad:
NewAssetOpenExplorer.PNG
There will only be a single item in the asset, its config.txt file
 9  Double Left Click on the file to open it in Notepad


  DotPoint5.JPG Edit the Config.txt File:
NewAssetOpenNotepad.PNG
You will need to edit the contents of this file.
 10  The next section, PageLink.PNG The Config.txt File, identifies the changes you will need to make. The new name you give to the asset will not take effect until after it has been Submitted
 11  After editing, save the changes and exit Notepad


 
Warning:
Stop.PNG Unless you know exactly what you are doing* DO NOT ALTER THE KUID NUMBER  that has been added to the file

* but even if you do, think twice before you change it !


  DotPoint6.JPG Add a Thumbnail:

You will need to add a thumbnail image as described in the section PageLink.PNG The Thumbnail Image. The thumbnail and the config.txt files are the only items required in this asset.
Asset contents

The thumbnail does not have to be added immediately but must it be present before the new asset can be used. You can reopen the asset for editing later to add the thumbnail before the asset is submitted.


  DotPoint7.JPG Finish Up:
NewAssetSubmit.PNG
 13  Close the Asset window
 14  Commit the asset in Content Manager
DotPoint.JPG Right Click on the asset
DotPoint.JPG Select  Submit Edits  Hopefully there will be no errors.


NotePad.PNG Because you still have the Search Filter Open for Editing in operation, the now closed and Submitted asset will vanish from the Content Manager display. To check that your asset has been correctly created and renamed, set the Search Filter to Today.


Bug.png Some of the most common errors that can occur when creating and Submitting a new asset are:-
DotPoint.JPG no thumbnail image in the asset
DotPoint.JPG typing errors in the config.txt file
DotPoint.JPG poorly formatted tags in the config.txt file
DotPoint.JPG incorrect file types added to the asset folder
DotPoint.JPG files missing from the asset folder
DotPoint.JPG an incorrect kuid value (despite the warning you changed it in Step  5 )


  Top Next Up Next Down Bottom

[edit] The Config.txt File

BlueDot10x10.png All assets must have a config.txt file



Gears.PNG Settings:
The region asset must have a config.txt text file that must include the following tags:-
BlackDot10x10.png kind set to "region"
BlackDot10x10.png username set to the asset title or name
BlackDot10x10.png kuid a unique ID code
BlackDot10x10.png thumbnails set to a 240 by 180 pixel JPG image
While not mandatory, the following tag is useful:-
BlackDot10x10.png category-class set to "YX"


This file should follow the same (or a similar) format as the example below.
DotPoint.JPG entries in  red  must not be changed
DotPoint.JPG the indenting of the lines and the spacing ("tabbing") between the "tags" on the left and their contents on the right are purely to make it easier for humans to read
DotPoint.JPG the use of the { } braces is to group tags into common "containers". These containers must not be broken up and the number of { characters must match the number of } characters
DotPoint.JPG the order of the "tags" is not important
kuid                              <kuid: this is an auto-generated number >
kind                              " region "
username                          "Region data for Tasmania 1950 to 1969"
category-class                    " YX "
category-era                      "1950s;1960s"
category-region                   "AU"
ontheright                        0
water-color                       75,128,255
defaultjunction                   <kuid:61119:24120>
default-texture                   <kuid:-25:1180>
trainz-build                      4.8
longitude                         147.0,26.0,1.0
latitude                          41.0,50.0,-1.0
altitude                          212
car0                              <kuid:329364:1568>
thumbnails
{
  Default
  {
    width                          240 
    height                         180 
    image                         "Tasmania-Region.jpg"
  }
}
description                       "Vehicle, road, water and geographic data for Tasmania (Australia) in the 1950s and 1960s"
kuid-table
{
  0                               <kuid:61119:24120>
  1                               <kuid:329364:1568>
  2                               <kuid:-25:1180>
}

Gears.PNG Settings:

For the above example:

BlackDot10x10.png The  kuid  is unique to every asset so it is  not a good idea to choose your own . This will be automatically generated by the Content Manager program when a new asset is created
BlackDot10x10.png The  kind  identifies the type of asset and the types of files that Trainz will expect to find in the asset. It also tells Trainz how to render and error check the asset. For Region assets, the category class is  region . A list of asset kinds can be found at WikiLink.PNG KIND Hierarchy
BlackDot10x10.png The  username  is your name for the asset and the name that other users will see. It is also the name that will appear in the Route Editor when the region is being selected. It is a good idea to make it short and meaningful
BlackDot10x10.png The  category-class  identifies the intent of the asset and is important in classifying it for filtering and searching. For Region assets, the category class is  YX . A list of category classes can be found at WikiLink.PNG Category-class
BlackDot10x10.png The  category-era  identifies the decade or decades in which the region is based (e.g. "1950s"). See the section PageLink.PNG Category Era Tag below for more details.
BlackDot10x10.png The  category-region  identifies the country or countries in which layout is based. See the section PageLink.PNG Category Region Tag below for more details.
BlackDot10x10.png The  ontheright  identifies which side of the road is used by road traffic. See the section PageLink.PNG On the Right Tag below for more details.
BlackDot10x10.png The  water-color  identifies the the colour used by Legacy water surfaces in this region. This setting has no effect on the 'Water Effect Layers. See the section PageLink.PNG Water Color Tag below for more details.
BlackDot10x10.png The  defaultjunction  identifies the junction lever or switch that will be used as its default lever asset whenever a lever is added to a track junction in this region. See the section PageLink.PNG Default Junction Tag below for more details.
BlackDot10x10.png The  default-texture  identifies the ground texture that will be applied to every new baseboard that is added to a Route. See the section PageLink.PNG Default Texture Tag below for more details.
BlackDot10x10.png The  trainz-build  identifies the minimum Trainz version needed for this asset. A list of asset trainz-build numbers and their corresponding Trainz versions can be found at WikiLink.PNG "Trainz-build"_number
BlackDot10x10.png The  longitude  identifies the geographic longitude of a point in the region. See the section PageLink.PNG Longitude Tag below for more details.
BlackDot10x10.png The  latitude  identifies the geographic latitude of a point in the region. See the section PageLink.PNG Latitude Tag below for more details.
BlackDot10x10.png The  altitude  identifies the altitude or base height of the starting baseboard in the route. See the section PageLink.PNG Altitude Tag below for more details.
BlackDot10x10.png The  car0  identifies the first moving car that will appear on roads in the region. Upto 15 different cars can be specified. See the section PageLink.PNG Car Tags below for more details.
BlackDot10x10.png The  thumbnails  container holds the preview images of the asset shown by the Content Manager program, the Web version of the DLS and, for some assets, the Surveyor main menu image(s). See the section PageLink.PNG Thumbnails below for more details. Complete information on thumbnails can be found at WikiLink.PNG Thumbnails
DotPointBlack.JPG The label  Default  is the container ID or placeholder for the thumbnail used by CM and the Web based DLS. While its exact label (or number - eg. "Default", "00", "01", etc) is not important, it must be different from any other labels that might be present in the thumbnail. Default and 0 are commonly used placeholder labels for the 240 x 180 thumbnail image
BlackCircle10x10.png The image is the name of the thumbnail image. It does not have to be called thumbnail.jpg but it must be a  JPG  format image
BlackCircle10x10.png The width of the image in pixels must be  240 
BlackCircle10x10.png The height of the image in pixels must be  180 
BlackDot10x10.png The  description  provides more details for users than the username
BlackDot10x10.png The  kuid-table  contains the kuid values of the defaultjunction asset and all the carN assets. See the section PageLink.PNG Kuid Table Tag below for more details.

PencilTips.PNG Language Options:

All Trainz assets have a language facility built into their config.txt files that allows other language translations to be added for certain tags, such as the username and description tags. A full description of the process can be found on the Trainz Wiki at WikiLink.PNG Localize an Asset and a list of all the supported languages with their two character codes at WikiLink.PNG Localization (country) Codes.
At the very basic level any creator can easily provide other language translations for the username and description tags in the assets they create. Examples are shown below for this sample asset.
username                    "Region data for Tasmania 1950 to 1969"
username-c2                 "塔斯马尼亚州1950年至1969年的区域数据"
username-de                 "Regionsdaten für Tasmanien 1950 bis 1969"
username-es                 "Datos de la región para Tasmania 1950 a 1969"
username-fr                 "Données régionales pour la Tasmanie de 1950 à 1969"
username-nl                 "Regiogegevens voor Tasmanië 1950 tot 1969"
username-ru                 "Данные по регионам за Тасманию с 1950 по 1969 год"
Translations to Chinese (simplified), Spanish, French, German, Dutch and Russian, perfect or not, were provided by Google Translate.


  Top Next Up Next Down Bottom

[edit] Region Tags

[edit] Category Era Tag

Skip Down          
BlueDot10x10.png This tag is  NOT compulsory  in a Region asset

category-era

This identifies the decade or decades in which the region is based. The tag data contains text surrounded by quote (") characters. Each decade name ends with an "s" (e.g. "1950s") and multiple consecutive decades can be specified by using a semi-colon (;) as a separator (e.g. "1950s;1960s"). A list of category-eras can be found at WikiLink.PNG Category-era tag.


Examples:

category-era                                    "2000s"
Years 2000 to 2009
category-era                                    "1910s;1920s;1930s;1940s;1950s"
Years 1910 to 1959


[edit] Category Region Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  NOT compulsory  in a Region asset

category-region

This identifies the country or countries in which the region is based. The tag data contains text surrounded by quote (") characters. Each country has a two letter code (e.g. "AU" for Australia) and multiple countries can be specified by using a semi-colon (;) as a separator (e.g. "AU;UK;US"). If no country is to be specified then the two character code "00" (double zero) is used. A list of countries (category regions) can be found at WikiLink.PNG Category-region tag.


Examples:

category-region                                    "00"
Unassigned
category-region                                    "US"
USA
category-region                                    "AU;UK;NZ"
Australia, United Kingdom, New Zealand


[edit] On the Right Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  compulsory  in a Region asset

ontheright (no hyphens between the words)

This identifies which side of the road is used by road traffic in this region. The tag data contains a binary value (0 or 1). 0 = left side, 1 = right side.
United Kingdom, Ireland, Australia, New Zealand, Japan and many former British colonies would use a value of 0. Most of the rest of the world would use a value of 1.


Examples:

ontheright                                    0
Left side driving
ontheright                                    1
Right side driving


[edit] Water Color Tag

Skip Down Skip Up        
Stop.PNG The water-color tag in a Region asset has been superseded by the Water Effect Layers in Trainz Plus and TRS22.


BlueDot10x10.png This tag is  compulsory  in a Region asset with an asset build number of 3.4 (TRS2010 SP4) and higher

water-color

This identifies the colour used by water surfaces added by the Surveyor Terrain Tool in this region. The tag contains three integers separated by commas (e.g. 75,128,255). The integers specify the RGB ( Red   Green   Blue ) colour values to be used and each value is from 0 to 255.


Examples:

water-color                                    0,155,255
  
water-color                                    75,128,255
  


[edit] Default Junction Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  compulsory  in a Region asset with an asset build number of 3.4 and higher

defaultjunction (no hyphen between the two words)

This identifies the junction lever or switch that Trainz will use as its default lever asset whenever a lever is added to a track junction in this region. The tag data contains a single valid kuid (e.g. <kuid:61119:24120>).
The kuid value of the switch lever must also be added to the kuid-table container of the config.txt file.


Examples:

defaultjunction                                    <kuid:61119:24120>
Lever Throw Over
defaultjunction                                    <kuid2:63290:24043:3>
Switch Tall Frame 1


[edit] Default Texture Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  only valid  in a Region asset with a build number of 4.8 and higher (TRS19 SP3 and later)

default-texture

This identifies the default texture that will be applied to every new baseboard that is added. If it is not present then a system default texture will be used on new baseboards in Trainz TRS19 and later. If present then the Trainz Build Tag must also be present and set to a minimum value of 4.8 (TRS19 SP3 and later).

The kuid value shown in the sample config.txt above, <kuid:-25:1180>, is for the standard TRS19 grid pattern.

The kuid value of the texture must also be added to the kuid-table container of the config.txt file.


Examples:

default-texture                                    <kuid:-25:1180>
Grid (PBR)
default-texture                                    <kuid:455526:50038>
FX PBR Gravel 03


[edit] Trainz Build Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  NOT compulsory  in a Region asset unless the Default Texture Tag is present

trainz-build

This identifies the minimum version of Trainz that wlll be needed to use this region asset. A list of asset trainz-build numbers and their corresponding Trainz versions can be found at WikiLink.PNG Trainz build numbers


NotePad.PNG Notes:

If this tag is present and set to a value of 3.4 or higher, then a number of other tags will become compulsory and must also be present. Specifically:-

  • water-color
  • defaultjunction
  • longitude
  • latitude
  • altitude

Examples:

trainz-build                                    3.7
TRS12 SP1 and above
trainz-build                                    5.0
TRS19 SP5 and above


[edit] Longitude Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  compulsory  in a Region asset with an asset build number of 3.4 and higher


Stop.PNG The Longitude tag in a Region asset has been superseded by the Longitude Setting in the WikiLink.PNG Environment Tools

longitude

This identifies the geographic longitude of a point in the region. The tag contains three floating point or decimal values separated by commas (e.g. 147.0,26.0,1.0). The first value is the longitude degrees, the second value is the longitude minutes and the third is the East/West value (1.0 = East, -1.0 = West). For example: 147.0,26.0,1.0 would represent longitude 147 degrees 26 minutes East.


NotePad.PNG Notes:

There is no known feature, function or operation in a Trainz route or session that actually requires a Longitude value other than the fact that a valid Longitude Tag is compulsory in a Region asset with a build number of 3.4 and higher.

Examples:

longitude                                    153.0,2.0,1.0
East
longitude                                    2.0,20.0,-1.0
West


[edit] Latitude Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  compulsory  in a Region asset with an asset build number of 3.4 and higher


Stop.PNG The Latitude tag in a Region asset has been superseded by the Latitude Setting in the WikiLink.PNG Environment Tools

latitude

This identifies the geographic latitude of a point in the region. The tag contains three floating point or decimal values separated by commas (e.g. 41,0,50.0,-1.0). The first value is the latitude degrees, the second value is the latitude minutes and the third is the North/South value (1.0 = North, -1.0 = South). For example: 41.0,50.0,-1.0 would represent latitude 41 degrees 50 minutes South.


NotePad.PNG Notes:

The purpose of the Latitude entry is to:-

DotPoint.JPG determine the season of the year along with the Date setting. Many SpeedTrees assets, for example, use the season to determine which foliage layer should be used. Both the Latitude and Date can be set in the WikiLink.PNG Environment Tools.
DotPoint.JPG set the sun angle and its maximum height above the horizon line at noon. The times of sunrise and sunset are fixed at 06:00 and 18:00 and these cannot be changed.


Examples:

latitude                                    27.0,28.0,-1.0
South
latitude                                    48.0,48.0,1.0
North


[edit] Altitude Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  compulsory  in a Region asset with an asset build number of 3.4 and higher


Stop.PNG The Altitude tag in a Region asset has been superseded by the World Origin Altitude Setting in the WikiLink.PNG Environment Tools


BlueDot10x10.png The altitude can be set by selecting a Region:-
  • when a new route is created - the route base height will be set to the altitude shown in the selected region so the first baseboard will have its height set to that altitude instead of the usual starting height of 0 metres
  • when an existing route is edited by assigning it a new region - the route will have its base height set to the altitude shown in the new region and all existing heights (terrain, splines, objects) will be set relative to that value

altitude

This sets the initial altitude (height above sea level) of the route. It is also used in the display of snow but only with those scenery assets that have a snow effect layer.

The tag data contains a single integer that represents the altitude in metres. All terrain and object heights will be set relative to that altitude. For example: if the first baseboard of a route is manually raised to a height of 20 metres using the Terrain Height Tool and the route is then assigned to a region with the altitude set to 100 metres, then the first baseboard will have a height above sea level of 20 + 100 = 120 metres.

The altitude tag works with the Snow Altitude Setting which is set in the WikiLink.PNG Environment Tools.


PencilTips.PNG The Default Region has an altitude of 0 metres. If you change the assigned region for an exiting route to the Default Region, then the base height of that route will be set to 0 metres and all other heights will be adjusted relative to that height. In many cases this will revert the route to its original terrain height when it was created in Surveyor and before it was assigned to a region.


Examples:

altitude                                    0
metres
altitude                                    100
metres


[edit] Car Tags

Skip Down Skip Up        
BlueDot10x10.png This tag is  NOT compulsory  in a Region asset. If not present then no moving vehicles will appear


NotePad.PNG Notes:

DotPoint.JPG There is some confusion over the maximum number of different types of moving vehicles allowed in a session. Some region assets available on the DLS claim to produce as many as 100 different types of moving vehicles but whether more than 15 different types can be seen in a Driver session at any one time is, as yet, unclear.
DotPoint.JPG The carrate tag, which is used to control the rate at which moving vehicles are created (i.e. how many per minute), has been declared obsolete in Route assets. This tag is not used in a Region asset but has been used in some Route config.txt files. It only applies to road spline assets that support road traffic.

car0, car1, car2, etc

The Car Tag identifies the moving vehicles (cars, trucks, etc) that will appear on roads in the region. Each car tag contains just a single kuid value (e.g. <kuid:329364:1568>) that identifies a single vehicle. There are restrictions and requirements:-
DotPoint.JPG Up to 15 different vehicles (see Notes above), each as a separate tag from car0 to car14 with their kuid values, can be specified in a region. The car tag numbers must be consecutive with no missing or duplicated entries (see Notes above). For example, the following entries will specify just 4 different moving vehicles for the region.

Example:

car0                                    <kuid:329364:1568>
car1                                    <kuid:309161:100599>
car2                                    <kuid2:329364:1689:1>
car3                                    <kuid2:329364:1707:1>
DotPoint.JPG The vehicles must be specially configured to allow them to be used as moving vehicles - static car assets cannot be used. See WikiLink.PNG Build a Car for Traffic for information on how to configure a static vehicle asset for road traffic
DotPoint.JPG Not all roads are configured to carry moving vehicles
DotPoint.JPG The WikiLink.PNG Environment Tools has a control that will enable and disable ALL road traffic. If this is set to disable then the car tags will be ignored and no moving vehicles will appear
DotPoint.JPG The kuids of the vehicles must be added to the kuid-table container of the config.txt file.


Stop.PNG If any of the listed cars are faulty then the Region asset will NOT appear for selection in the route Region List (see Using the Asset below)


[edit] Kuid Table Tag

Skip Down Skip Up        
BlueDot10x10.png This tag is  compulsory  in a Region asset if the defaultjunction, default-texture or car tags are used

kuid-table

This must contain the kuids of the Default Junction Tag, the Default Texture Tag and all the cars specified in the car tags - if any of them are present. The kuid order is not important and the tag numbers ("0", "1", etc) do not have to match those used in the car tags. Using the examples shown above, the kuid-table could be as shown below.
kuid-table
{
  0                                     <kuid:61119:24120>
  1                                     <kuid:-25:1180>
  2                                     <kuid:329364:1568>
  3                                     <kuid:309161:100599>
  4                                     <kuid2:329364:1689:1>
  5                                     <kuid2:329364:1707:1>
}

In this example, the first kuid value is for the defaultjunction, the second is for the default-texture and the remaining kuid values are for the four road vehicles, but the order of the entries is not important.


    Skip Up Top Next Up Next Down Bottom


[edit] The Thumbnail Image

BlueDot10x10.png A thumbnail image MUST be present in the asset


NotePad.PNG Notes:

The thumbnail image:-

DotPoint.JPG must be in JPG format
DotPoint.JPG must be 240 pixels wide by 180 pixels tall
DotPoint.JPG does not have to be named thumbnail.jpg as long as the name used is in the Thumbnails container in the config.txt file.


[edit] Using the Asset

Once the new asset has been committed it will be available for use as a Region.

Stop.PNG If the region asset is faulty (for example, if it has an incorrect kuid code in one of its car tags) then the region will not appear in the Region selection list.
The region is specified when a new route is created and it can be altered by selecting Edit Route from the main menu in TANE or the edit menu in TRS19 and later versions.


Load a Region

  Top Next Up    


[edit] Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz


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


Personal tools