View source for CSV Routes

<font size="small"><font face="sans-serif">

<font size="+2" color="#0080ff">The '''.csv''' route format</font><br />



=<font size="+1" color="#0080ff">Overview</font>=

A CSV route allows to create a route in a text file.<br /><br />The file is a plain text file encoded in any arbitrary [http://trainsimframework.org/develop/information_encodings.html encoding], however, UTF-8 with a byte order mark is the preferred choice. The [http://trainsimframework.org/develop/information_numberformats.html parsing model] for numbers is '''Loose''' (unless otherwise stated), however, you are encouraged to produce ''Strict'' output nonetheless. The file is required to be located inside any folder whose current or parent folder includes the ''Railway'' and ''Train'' folders. The file name is arbitrary, but must have the extension '''.csv'''. The file is interpreted on a per-line basis, from top to bottom, where each line is split into expressions, which are interpreted from left to right.<br /><br />The route file consists of a series of commands to define the objects which are used throughout the route (Structure namespace). Additional properties for the route, for the default train to be used and for the background images to be used can also be defined. At last, the route file will contain instructions from the Track namespace. Here, track positions (usually in meters) are used to define when the track should curve, when stations are to be placed, when a wall should start and end, and so on. Generally speaking, instructions from the Track namespace should be used after using instructions from any of the other namespaces.<br /><br />The format assumes an implicit rail 0 which cannot be explicitly started or ended. Instead, it is present from the beginning of the route to the end, and it marks the rail the player's train drives on. All other rails in the CSV format are purely visual and have no functional purpose.<br /><br />Geometrically, you can curve and pitch the implicit rail 0, while all other rails are defined relative to rail 0 and follow rail 0 into curves and pitch changes. Unless overridden, the file format is built around a fixed block size of 25 meters length, and it is only possible for certain commands to be used on 25 meter block boundaries. The placement of objects always assumes a non-curved coordinate system which connects blocks linearly.<br />

➟ [[CSVRouteQuickRef|See also the quick reference for the CSV route...]]<br />

{| style="border: 2px groove currentColor; margin-right: 20pt; margin-left: 20pt" align="center"
| style="border: 2px ridge currentColor" bgcolor="#c04040" | <font color="#ffffff"> Check these tutorials out:</font>
|-
| bgcolor="#ffffff" | 
*[http://www.bvestation.com/forums/index.php?topic=2772.0 .CSV Route Building Part 1 By ipac]
*[http://www.bvestation.com/forums/index.php?topic=2773.0 .CSV Route Building Part 2 By ipac]
*[http://www.freewebs.com/dennislance/ Dennis Lance's Route Building Tutorials]
*[http://www.freewebs.com/dennislance/modifying%20existing%20routes.htm Modifying Existing .CSV Routes By Dennis Lance]
|}

=<font size="+1" color="#0080ff">Syntax</font>=

For each line in the file, white spaces at the beginning and the end of that line are ignored. Then, lines are split into individual expressions, separated by commas (U+002C). Thus, each line is of the following form:<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">''Expression<sub>1</sub>'', ''Expression<sub>2</sub>'', ''Expression<sub>3</sub>'', ..., ''Expression<sub>n</sub>''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

In turn, each expression can be of any of the following forms:<br /><br />

{|
|- style="height: 4px"
|
|}

==<font color="#0080ff">Comments</font>==

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

A comment is completely ignored by the parser. To form a comment, the expression must begin with a semicolon (U+003B).<br /><br />

{|
|- style="height: 4px"
|
|}

==<font color="#0080ff">Track positions and lengths</font>==

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">''Position''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

A non-negative [http://trainsimframework.org/develop/information_numberformats.html strict] floating-point number corresponding to a track position. All subsequent commands from the Track namespace are associated to this track position.<br /><br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">''Part<sub>1</sub>''<nowiki>:</nowiki>''Part<sub>2</sub>''<nowiki>:...:</nowiki>''Part<sub>n</sub>''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

This is a more complex way of specifying track positions for use in conjunction with Options.UnitOfLength. Each of the ''Part<sub>i</sub>'' is a [http://trainsimframework.org/develop/information_numberformats.html strict] floating-point number. ''Part<sub>1</sub>'' will be multiplied with ''Factor<sub>1</sub>'', ''Part<sub>2</sub>'' with ''Factor<sub>2</sub>'', and so on, then all products are added together to form the final track position. This track position must be non-negative. The parts are separated by colons (U+003A). Please consult Options.UnitOfLength for further information on how to define the factors.<br /><br />Whereever arguments in commands represent lengths, they can also be entered using the colon notation. These cases are highlighted in <font color="green">green</font> in the following.<br /><br />When ''n'' units are defined via Options.UnitOfLength, but fewer parameters are given using the colon notation, the parameters are right-associative, meaning, the parameters on the left are those which are skipped. Therefore, each of the following lengths are equivalent: ''0:0:2'', ''0:2'', and ''2''.<br /><br />

{|
|- style="height: 4px"
|
|}

==<font color="#0080ff">Commands</font>==

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

Commands without arguments:<br />

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">''NameOfTheCommand''</font></font></font>
|}

<br />Commands with arguments:<br />

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">''NameOfTheCommand'' ''Argument<sub>1</sub>''<nowiki>;</nowiki>''Argument<sub>2</sub>''<nowiki>;</nowiki>''Argument<sub>3</sub>''<nowiki>;...;</nowiki>''Argument<sub>n</sub>''<br />''NameOfTheCommand''(''Argument<sub>1</sub>''<nowiki>;</nowiki>''Argument<sub>2</sub>''<nowiki>;</nowiki>''Argument<sub>3</sub>''<nowiki>;...;</nowiki>''Argument<sub>n</sub>'')</font></font></font>
|}

<br />Commands with indices and arguments:<br />

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">''NameOfTheCommand''(''Index<sub>1</sub>''<nowiki>;</nowiki>''Index<sub>2</sub>''<nowiki>;...;</nowiki>''Index<sub>m</sub>'') ''Argument<sub>1</sub>''<nowiki>;</nowiki>''Argument<sub>2</sub>''<nowiki>;</nowiki>''Argument<sub>3</sub>''<nowiki>;...;</nowiki>''Argument<sub>n</sub>''<br />''NameOfTheCommand''(''Index<sub>1</sub>''<nowiki>;</nowiki>''Index<sub>2</sub>''<nowiki>;...;</nowiki>''Index<sub>m</sub>'').''Suffix'' ''Argument<sub>1</sub>''<nowiki>;</nowiki>''Argument<sub>2</sub>''<nowiki>;</nowiki>''Argument<sub>3</sub>''<nowiki>;...;</nowiki>''Argument<sub>n</sub>''<br />''NameOfTheCommand''(''Index<sub>1</sub>''<nowiki>;</nowiki>''Index<sub>2</sub>''<nowiki>;...;</nowiki>''Index<sub>m</sub>'').''Suffix''(''Argument<sub>1</sub>''<nowiki>;</nowiki>''Argument<sub>2</sub>''<nowiki>;</nowiki>''Argument<sub>3</sub>''<nowiki>;...;</nowiki>''Argument<sub>n</sub>'')</font></font></font>
|}

<br />Rules:<br /><br />''NameOfTheCommand'' is case-insensitive. Indices and arguments are separated by semicolons (U+003B). White spaces around ''NameOfTheCommand'' and any of the indices and arguments are ignored. White spaces surrounding any of the parantheses are also ignored.<br /><br />If indices are used, these are enclosed by opening parantheses (U+0028) and closing parantheses (U+0029). At least one argument, or a ''Suffix'' is mandatory when using indices.<br /><br />There are two variations on how to encode arguments. Except for the $-directives ($Chr, $Rnd, $Sub, ...), you can freely choose which variant to use. Variant 1: The first argument is separated from the command, indices or ''Suffix'' by at least one space (U+0020). Variant two: The arguments are enclosed by opening parantheses (U+0028) and closing parantheses (U+0029). In the latter case, ''Suffix'' is mandatory when used in conjunction with indices. White spaces surrounding any of the parantheses are ignored.<br /><br />Please note that in some commands, ''Suffix'' is mandatory regardless of the style you use to encode arguments. In the following, ''Suffix'' will be '''bolded''' when it is mandatory, and <font color="gray">grayed</font> when it is optional.<br /><br />

{|
|- style="height: 4px"
|
|}

==<font color="#0080ff">The '''With''' statement</font>==

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">With ''Prefix''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

All subsequent commands that start with a period (U+002E) are prepended by ''Prefix''. For example:<br />

{|
| width="16" valign="top" |
| <font size="-1">''''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Route<br />.Gauge 1435<br />.Timetable 1157_M</tt>
|}

Is equivalent to:<br />

{|
| width="16" valign="top" |
| <font size="-1">''''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>Route.Gauge 1435<br />Route.Timetable 1157_M</tt>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

=<font size="+1" color="#0080ff">Preprocessing</font>=


{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Before any of the commands in the route file are actually interpreted, the expressions are preprocessed. The first thing done is to replace any occurences of the $-directives within an expression from right to left. The $Chr, $Rnd and $Sub directives may be nested in any way, while $Include, $If, $Else and $EndIf must not appear inside another directive.<br /><br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | The syntax for the $-directives cannot be freely chosen, but must adhere to the forms presented below.
| bgcolor="#e0e0e0" |
|}

==Include==

<br />

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$Include(''File'')<br /> $Include(''File''<nowiki>:</nowiki>''TrackPositionOffset'')<br /> $Include(''File<sub>1</sub>''<nowiki>; </nowiki>''Weight<sub>1</sub>''<nowiki>; </nowiki>''File<sub>2</sub>''<nowiki>; </nowiki>''Weight<sub>2</sub>''<nowiki>; ...)</nowiki></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''File<sub>i</sub>'''''<nowiki>: A file to include of the same format (CSV/RW) as the main file.</nowiki><br />'''''Weight<sub>i</sub>'''''<nowiki>: A positive floating-point number giving a probability weight for the corresponding file. </nowiki></font>
|}

This directive chooses randomly from the specified files based on their associated probabilities and includes the content from one selected file into the main file. The content is copied into the place of the $Include directive, meaning that you need to take care of track positions and the last used With statement, for example. If the last weight in the argument sequence is omitted, it is treated as 1.<br /><br />The $Include directive is useful for splitting up a large file into smaller files, for sharing common sections of code between multiple routes, and for choosing randomly from a larger block of code. Please note that the included files may themselves include other files, but you need to make sure that there are no circular dependencies, e.g. file A including file B, and file B including file A, etc. You should use a file extension different from .csv for included files so that users cannot accidentally select them in the main menu (except where this is desired).<br /><br />If any of the ''File<sub>i</sub>'' is followed by :''TrackPositionOffset'', then all expressions in the included file are offset by the specified track position '''in meters'''. For example, $Include(stations.include:2000) shifts all track positions in the part.include file by 2000 meters before including them. It is important to understand that "track positions" are not actually understood until after the $-directives have been processed, so all expressions in the included file are simply flagged to be offset later should they form track positions then. This means that if the included file contains expressions such as 1$Rnd(2;8)00, these are offset, too, even though at this stage, they do not form track positions yet.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | The track position offset feature is only available in the development release 1.2.11 and above.
| bgcolor="#e0e0e0" |
|}

==$Chr(''Ascii'')==

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$Chr(''Ascii'')</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Ascii'''''<nowiki>: An integer in the range from 20 to 127, or 10 or 13, corresponding to an ASCII character of the same code.</nowiki></font>
|}

This directive is replaced by the ASCII character represented by ''Ascii''. This is useful if you want to include characters that are part of syntax rules or would be stripped away. A list of relevant characters:<br /><br />

{| style="border-collapse: collapse"
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Code
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Meaning
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Character
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 10
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Newline
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''newline''
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 13
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Newline
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''newline''
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 20
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Space
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''space''
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 40
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Opening parantheses
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | (
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 41
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Closing parantheses
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | )
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 44
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Comma
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ,
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 59
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Semicolon
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <nowiki>;</nowiki>
|}

<br />The sequence $Chr(13)$Chr(10) is handled as a single newline. Inserting $Chr(59) can be interpreted as a comment starter or as an argument separator, depending on where it is used.<br /><br />

==Start==

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$Rnd(''Start''<nowiki>; </nowiki>''End'')</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Start'''''<nowiki>: An integer representing the lower bound.</nowiki><br />'''''End'''''<nowiki>: An integer representing the upper bound.</nowiki></font>
|}

This directive is replaced by a random integer in the range from ''Start'' to ''End''. It is useful to add randomness to a route.<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example for the use of the $Rnd directive:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>10$Rnd(3;5)0, Track.FreeObj 0; 1</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Possible outcome from the previous example is exactly '''one''' of these lines:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1030, Track.FreeObj 0; 1<br />1040, Track.FreeObj 0; 1<br />1050, Track.FreeObj 0; 1</tt>
|}

==$Sub(''Index'')==

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$Sub(''Index'') = ''Expression''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Index'''''<nowiki>: A non-negative integer representing the index of a variable.</nowiki><br />'''''Expression'''''<nowiki>: The expression to store in the variable.</nowiki></font>
|}

This directive should only appear as a single expression. It is used to assign ''Expression'' to a variable identified by ''Index''. The whole $Sub directive is replaced by an empty string once the assignment is done. It is useful for storing values obtained by the $Rnd directive in order to reuse the same randomly-generated value. See the following definition of the $Sub(''Index'') directive for examples.<br /><br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | '''Implementation note:''' While it is also possible to store non-numeric strings, it is not possible to include commas via $Chr(44) and have them work as a statement separator. However, it is possible to store a semicolon as the first character via $Chr(59) and have it work as a comment. For conditional expressions, you should use $Include or $If, though.
| bgcolor="#e0e0e0" |
|}

==Index==

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$Sub(''Index'')</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Index'''''<nowiki>: A non-negative integer representing the index of the variable to retrieve. </nowiki></font>
|}

This directive is replaced by the content of the variable ''Index''. The variable must have been assigned prior to retrieving it.<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example for the use of the $Sub(''Index'')=''Value'' and $Sub(''Index'') directives:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>$Sub(0) = $Rnd(3; 5)<br />1000, Track.FreeObj $Sub(0); 47<br />1020, Track.FreeObj $Sub(0); 47<br />1040, Track.FreeObj $Sub(0); 47</tt>
|}

In the previous example, all three Track.FreeObj commands are guaranteed to use the same randomly-generated value in order to place a free object on the same rail. If you inserted the $Rnd(3;5) directive in each of the three lines individually, the objects could be placed on different rails each time.<br /><br />

==$If(''Condition'')==

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$If(''Condition'')</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Condition'''''<nowiki>: A number that represents </nowiki>'''false''' if zero, and '''true''' otherwise. </font>
|}

The $If directive allows to only process subsequent expressions if the specified condition evaluates to true (any non-zero number). $If must be followed by $EndIf in any subsequent expression. Optionally, an $Else directive may appear between $If and $EndIf.<br /><br />

==$Else()==

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$Else()</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

The $Else directive allows to only process subsequent expressions if the condition in the preceding $If evaluated to false (zero).<br /><br />

==$EndIf()==

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">$EndIf()</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

The $EndIf directive marks the end of an $If block that was started previously.<br /><br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of $If, $Else and $EndIf''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>$Sub(1) = 0<br />With Track<br />$If($Sub(1))<br />     1020, .FreeObj 0; 1<br />     1040, .FreeObj 0; 2<br /> $Else()<br />     1030, .FreeObj 0; 3<br /> $EndIf()</tt>
|}

<br />

{|
| width="16" valign="top" |
| <font size="-1">''Another example of $If, $Else and $EndIf''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Track<br />1050<br />$If($Rnd(0;1)), .FreeObj 0; 4, $Else(), .FreeObj 0; 5, $EndIf()</tt>
|}

<br />It is possible to nest $If blocks. If you place $If/$Else/$EndIf on separate lines, you may want to employ indentation to improve readability of the block structure (as in the first example).<br /><br />

==After the $-directives==

'''Finally''', after the $-directives have been processed, all expressions in the route file are sorted according to their associated track positions.<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of a partial route file:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.FreeObj 0; 23<br />1050, Track.RailType 0; 1<br />10$Rnd(3;7)0, Track.Rail 1; 4<br />Track.FreeObj 1; 42</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Preprocessing the $Rnd directive (assuming 3 is produced):''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.FreeObj 0; 23<br />1050, Track.RailType 0; 1<br />1030, Track.Rail 1; 4<br />Track.FreeObj 1; 42</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Sorting by associated track positions:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.FreeObj 0; 23<br />1030, Track.Rail 1; 4<br />Track.FreeObj 1; 42<br /> 1050, Track.RailType 0; 1</tt>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

=<font size="+1" color="#0080ff">The Options namespace</font>=


{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Commands from this namespace provide generic options that affect the way other commands are processed. You should make use of commands from this namespace before making use of commands from other namespaces.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.UnitOfLength''' ''FactorInMeters<sub>1</sub>''<nowiki>; </nowiki>''FactorInMeters<sub>2</sub>''<nowiki>; </nowiki>''FactorInMeters<sub>3</sub>''<nowiki>; ...; </nowiki>''FactorInMeters<sub>n</sub>''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FactorInMeters<sub>i</sub>'''''<nowiki>: A floating-point number representing how many meters the desired unit has. The default value is 1 for </nowiki>''FactorInMeters<sub>1</sub>'', and 0 for all others.</font>
|}

This command can be used to specify the unit of length to be used in other commands. When entering a generic track position of the form ''Part<sub>1</sub>''<nowiki>:</nowiki>''Part<sub>2</sub>''<nowiki>:...:</nowiki>''Part<sub>n</sub>'', each of the ''Part<sub>i</sub>'' will be multipled with the corresponding ''FactorInMeters<sub>i</sub>'', then all of these products are added to form a single track position represented in meters. Ideally, you should set the block length to an integer multiple of any of the units you use via Options.BlockLength.<br /><br />Examples of conversion factors:<br /><br />

{| style="border-collapse: collapse"
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Desired unit
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Conversion factor
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | mile
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 1609.344
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | chain
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 20.1168
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | meter
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 1
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | yard
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 0.9144
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | foot
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 0.3048
|}

<br />In the following, all arguments of all commands are highlighted in <font color="green">green</font> whenever they are affected by Options.UnitOfLength.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.UnitOfSpeed''' ''FactorInKmph''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FactorInKmph'''''<nowiki>: A floating-point number representing how many kilometes per hour the desired unit has. The default value is 1.</nowiki></font>
|}

This command can be used to specify the unit of speed to be used in other commands. Examples of conversion factors:<br /><br />

{| style="border-collapse: collapse"
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Desired unit
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Conversion factor
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | meters/second
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 3.6
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | miles/hour
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 1.609344
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | kilometers/hour
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 1
|}

<br />In the following, all arguments of all commands are highlighted in <font color="blue">blue</font> whenever they are affected by Options.UnitOfSpeed.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.BlockLength''' <font color="green">''Length''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Length'''''<nowiki>: A positive floating-point number representing the length of a block, </nowiki>'''by default''' measured in '''meters'''. The default is 25 meters. </font>
|}

This command can be used to specify the length of a block. This is an overall setting and cannot be changed in the middle of the route. ''Length'' is only expressed in the unit specified by Options.UnitOfLength if Options.UnitOfLength is used before Options.BlockLength.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.ObjectVisibility''' ''Mode''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Mode'''''<nowiki>: The mode determining how objects appear and disappear. The default value is 0. </nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Mode''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Legacy: An object is made invisible as soon as the end of the block which it resides in has been passed by the camera. This does not work well when turning the camera around. Self-intersecting track (e.g. loops) is not possible.</nowiki><br />'''1'''<nowiki>: Track-based: An object is made invisible as soon as its end has been passed by the camera. This is measured in track positions. Self-intersecting track (e.g. loops) is not possible. </nowiki></font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.SectionBehavior''' ''Mode''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Mode'''''<nowiki>: The mode determining how the Track.Section command is processed.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Mode''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Default: In Track.Section </nowiki>''Aspect<sub>0</sub>''<nowiki>; </nowiki>''Aspect<sub>1</sub>''<nowiki>; ...; </nowiki>''Aspect<sub>n</sub>'', any of the ''Aspect<sub>i</sub>'' refer to the aspect the section should have if ''i'' following sections are clear.<br />'''1'''<nowiki>: Simplified: In Track.Section </nowiki>''Aspect<sub>0</sub>''<nowiki>; </nowiki>''Aspect<sub>1</sub>''<nowiki>; ...; </nowiki>''Aspect<sub>n</sub>'', the section bears the smallest aspect which is higher than that of the following section.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.CantBehavior''' ''Mode''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Mode'''''<nowiki>: The mode determining how cant in the Track.Curve command is processed.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Mode''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Unsigned: The </nowiki>''CantInMillimeters'' parameter in Track.Curve is unsigned, i.e. the sign is ignored and the superelevation is always towards the curve center (inward). Cant cannot be applied on straight track.<br />'''1'''<nowiki>: Signed: The </nowiki>''CantInMillimeters'' parameter in Track.Curve is signed, i.e. negative values bank outward and positive ones inward on curved track. Cant can be applied on straight track, where negative values bank toward the left and positive ones toward the right.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Options.FogBehavior''' ''Mode''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Mode'''''<nowiki>: The mode determining how the Track.Fog command is processed. The default value is 0. </nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Mode''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Block-based: Fog color and ranges are interpolated from the beginning of the block where Track.Fog is used with the old settings to the end of the block with the new settings.</nowiki><br />'''1'''<nowiki>: Interpolated: Fog color and ranges are interpolated between adjacent Track.Fog commands. This behavior mimicks Track.Brightness. </nowiki></font>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 5. The Route namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Commands from this namespace define general properties of the route.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Comment''' ''Text''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Text'''''<nowiki>: The route comments which appear in the route selection dialog.</nowiki></font>
|}

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | You need to use $Chr directives if you want to include newlines, commas and the like in the text.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Image''' ''File''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''File'''''<nowiki>: The file name of the image which appears in the route selection dialog, relative to the route's folder.</nowiki></font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Timetable''' ''Text''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Text'''''<nowiki>: The text which appears at the top of the default timetable.</nowiki></font>
|}

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | You need to use $Chr directives if you want to include newlines, commas and the like in the text.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Change''' ''Mode''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Mode'''''<nowiki>: The mode for the train's safety system to start in. The default value is implementation-specific. </nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Mode''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: The safety system is </nowiki>'''activated''' and the ''service'' brakes are applied.<br />'''0'''<nowiki>: The safety system is </nowiki>'''activated''' and the '''emergency''' brakes are applied.<br />'''1'''<nowiki>: The safety system is </nowiki>''deactivated'' and the '''emergency''' brakes are applied.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Gauge''' ''ValueInMillimeters''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''ValueInMillimeters'''''<nowiki>: A floating-point number representing the rail gauge, measured in </nowiki>'''millimeters''' (0.001 meters). The default value is 1435. </font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 20pt" bgcolor="#e0e0e0"
| <font color="#c00000">☀</font>
| ''Note: ''
|-
|
| <font color="#0060c0">Route.Gauge is the same as Train.Gauge.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Signal'''(''AspectIndex'')<font color="gray">.Set</font> <font color="blue">''Speed''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''AspectIndex'''''<nowiki>: A non-negative integer representing the signal aspect. The aspect 0 corresponds to red.</nowiki><br /><font color="blue">'''''Speed'''''</font><nowiki>: A non-negative floating-point number representing the allowed speed for this aspect, </nowiki>'''by default''' measured in '''kilometers per hour''' (km/h). </font>
|}

Use this command to associate speed limits to signal aspects. Aspect 0 represents a red signal, higher values represent more permissive aspects. The default values (for the included Japanese signals) are:<br /><br />

{| style="border-collapse: collapse"
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | ''Index''
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Aspect
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Speed
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 0
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <font color="#c00000">●</font>
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 0 km/h
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 1
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <font color="#ffc000">●●</font>
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 25 km/h
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 2
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <font color="#ffc000">●</font>
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 55 km/h
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 3
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <font color="#00c000">●</font><font color="#ffc000">●</font>
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 75 km/h
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 4
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <font color="#00c000">●</font>
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''unlimited''
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 5
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | <font color="#00c000">●●</font>
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''unlimited''
|}

<br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.RunInterval''' ''Interval<sub>0</sub>''<nowiki>; </nowiki>''Interval<sub>1</sub>''<nowiki>; ...; </nowiki>''Interval<sub>n-1</sub>''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Interval<sub>i</sub>'''''<nowiki>: A floating-point number representing the time interval between the player's train's timetable and that of another train to be created, measured in </nowiki>'''seconds'''. Positive values indicate an earlier train, negative numbers a later train.</font>
|}

This command creates one or more preceding or following trains. These other trains are visible, fully operational, and use the same train as the player has. The other trains follow the same schedule as the player does, but are offset in time by ''Interval<sub>i</sub>''. Via the Track.Sta command, you can also define stations where only the player or only the other trains should stop. Follow-up trains only appear once the section they are placed in has been cleared by other trains, but the player's train is introduced regardless of the current signalling section's state. Therefore, you should make sure that other trains have cleared the area where the player's train will appear when the scenario begins.<br />

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 20pt" bgcolor="#e0e0e0"
| <font color="#c00000">☀</font>
| ''Note: ''
|-
|
| <font color="#0060c0">Route.RunInterval is the same as Train.Interval.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.AccelerationDueToGravity''' ''Value''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Value'''''<nowiki>: A positive floating-point number representing the acceleration due to gravity in </nowiki>'''meters per second squared''' (m/s²). The default value is 9.80665. </font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Elevation''' <font color="green">''Height''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"><font color="green">'''''Height'''''</font><nowiki>: A floating-point number representing the initial height above sea level, </nowiki>'''by default''' measured in '''meters''' (m). The default value is 0. </font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Temperature''' ''ValueInCelsius''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Value'''''<nowiki>: A floating-point number representing the initial temperature in </nowiki>'''Celsius'''. The default value is 20.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.Pressure''' ''ValueInKPa''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''ValueInKPa'''''<nowiki>: A positive floating-point number representing the initial air pressure in </nowiki>'''kPa''' (1000 Pascal). The default value is 101.325.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.AmbientLight''' ''RedValue''<nowiki>; </nowiki>''GreenValue''<nowiki>; </nowiki>''BlueValue''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RedValue'''''<nowiki>: An integer ranging from 0 to 255 representing the red component of the ambient light. The default value is 160.</nowiki><br />'''''GreenValue'''''<nowiki>: An integer ranging from 0 to 255 representing the green component of the ambient light. The default value is 160.</nowiki><br />'''''BlueValue'''''<nowiki>: An integer ranging from 0 to 255 representing the blue component of the ambient light. The default value is 160.</nowiki></font>
|}

This command defines the ambient light color to be used. All polygons in the scene are illuminated by the ambient light regardless of the light direction.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.DirectionalLight''' ''RedValue''<nowiki>; </nowiki>''GreenValue''<nowiki>; </nowiki>''BlueValue''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RedValue'''''<nowiki>: An integer ranging from 0 to 255 representing the red component of the directional light. The default value is 160.</nowiki><br />'''''GreenValue'''''<nowiki>: An integer ranging from 0 to 255 representing the green component of the directional light. The default value is 160.</nowiki><br />'''''BlueValue'''''<nowiki>: An integer ranging from 0 to 255 representing the blue component of the directional light. The default value is 160.</nowiki></font>
|}

This command defines the directional light to be used. The polygons in the scene are only fully illuminated by the directional light if the light direction points at the front faces. If pointing at back faces, no light is contributed. ''Route.LightDirection'' should be set to specify the light direction.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Route.LightDirection''' ''Theta''<nowiki>; </nowiki>''Phi''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Theta'''''<nowiki>: A floating-point number representing the angle in </nowiki>'''degrees''' which controls the pitch of the light direction. The default value is 60.<br />'''''Phi'''''<nowiki>: A floating-point number representing the angle in </nowiki>'''degrees''' which controls the planar rotation of the light direction. The default value is about -26.57.</font>
|}

This command defines the initial light direction for track position 0. This is the direction the light shines at, meaning the opposite direction the sun is located at. First, ''Theta'' determines the pitch. A value of 90 represents a downward direction, while a value of -90 represents an upward direction. With those extremes, the value of ''Phi'' is irrelevant. A value of 0 for ''Theta'' represents a forward direction originating at the horizon behind. Once the pitch is defined by ''Theta'', ''Phi'' determines the rotation in the plane. A value of 0 does not rotate, a value of 90 rotates the direction to the right and a value of -90 rotates to the left. A backward direction can be both obtained by setting ''Theta'' and ''Phi'' to 180 and 0 or to 0 and 180, respectively. Values in-between allow for more precise control of the exact light direction.<br />[[Image:illustration_light_direction.png]]<br />

{|
| width="16" valign="top" |
| <font size="-1">''Converting a spherical direction (theta,phi) into a cartesian direction (x,y,z):''</font>
|-
| width="16" valign="top" | ƒ
| style="border: 1px dotted currentColor" bgcolor="#ffd8c0" | <tt>x = cos(theta) * sin(phi)<br />y = -sin(theta)<br />z = cos(theta) * cos(phi)</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Converting a cartesian direction (x,y,z) into a spherical direction (theta,phi) for y²≠1:''</font>
|-
| width="16" valign="top" | ƒ
| style="border: 1px dotted currentColor" bgcolor="#ffd8c0" | <tt>theta = -arctan(y/sqrt(x<sup>2</sup>+z<sup>2</sup>))<br />phi = arctan(z,x)</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Converting a cartesian direction (x,y,z) into a spherical direction (theta,phi) for y²=1:''</font>
|-
| width="16" valign="top" | ƒ
| style="border: 1px dotted currentColor" bgcolor="#ffd8c0" | <tt>theta = -y * pi/2<br />phi = 0</tt>
|}

In the formulas above, [http://functions.wolfram.com/ElementaryFunctions/Cos/02 ''cos(x)''] represents the cosine, [http://functions.wolfram.com/ElementaryFunctions/Sin/02 ''sin(x)''] the sine, [http://functions.wolfram.com/ElementaryFunctions/ArcTan/02 ''arctan(x)''] the inverse tangent, [http://functions.wolfram.com/ElementaryFunctions/ArcTan2/02 ''arctan(x,y)''] the two-argument inverse tangent and [http://functions.wolfram.com/ElementaryFunctions/Sqrt/02 ''sqrt(x)''] the square root. The formulas can be used to convert between spherical and cartesian coordinates if working with either one seems more intuitive than working with the other one. The formulas also serve as the official documentation on how the light direction is mathematically defined (using radians for the trigonometric functions).<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#606060">'''Route.DeveloperID'''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">This command is ignored by openBVE. </font>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 6. The Train namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Commands from this namespace define route-train associations.<br /><br />

----

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">Train.Folder ''FolderName''<br />Train.File ''FolderName''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FolderName'''''<nowiki>: The folder name of the default train to use on this route.</nowiki></font>
|}

----

<br />

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Run'''(''RailTypeIndex'')<font color="gray">.Set</font> ''RunSoundIndex''<br />'''Train.Rail'''(''RailTypeIndex'')<font color="gray">.Set</font> ''RunSoundIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailTypeIndex'''''<nowiki>: A non-negative integer representing the rail type as defined via Structure.Rail and used via Track.RailType.</nowiki><br />'''''RunSoundIndex'''''<nowiki>: A non-negative integer representing the train's run sound to associate to the rail type. </nowiki></font>
|}

The train developer provides a repertoire of different run sounds. Use this command to associate these run sounds to the rail types you use in your route. In order for the correct run sounds to be played on any of your rail types, you need to coordinate your efforts with the train developer. Please see the page about [http://trainsimframework.org/develop/information_standards.html standards] for further information.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Flange'''(''RailTypeIndex'')<font color="gray">.Set</font> ''FlangeSoundIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailTypeIndex'''''<nowiki>: A non-negative integer representing the rail type as defined via Structure.Rail and used via Track.RailType.</nowiki><br />'''''RunSoundIndex'''''<nowiki>: A non-negative integer representing the train's flange sound to associate to the rail type.</nowiki></font>
|}

The train developer provides a repertoire of different flange sounds. Use this command to associate these flange sounds to the rail types you use in your route. In order for the correct flange sounds to be played on any of your rail types, you need to coordinate your efforts with the train developer. Please see the page about [http://trainsimframework.org/develop/information_standards.html standards] for further information.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Timetable'''(''TimetableIndex'')'''.Day'''<font color="gray">.Load</font> FileName</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''TimetableIndex'''''<nowiki>: A non-negative integer representing the timetable index.</nowiki><br />'''''FileName'''''<nowiki>: The file name for the daytime version of the timetable, relative to the train's folder (1</nowiki><sup>st</sup> choice), or relative to the '''Object''' folder (2<sup>nd</sup> choice).</font>
|}

Use this command to load daytime versions of the timetable. Which timetable index to show starting with a particular station can be set in Track.Sta commands.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Timetable'''(''TimetableIndex'')'''.Night'''<font color="gray">.Load</font> FileName</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''TimetableIndex'''''<nowiki>: A non-negative integer representing the timetable index.</nowiki><br />'''''FileName'''''<nowiki>: The file name for the daytime version of the timetable, relative to the train's folder (1</nowiki><sup>st</sup> choice), or relative to the '''Object''' folder (2<sup>nd</sup> choice).</font>
|}

Use this command to load nighttime versions of the timetable. Which timetable index to show starting with a particular station can be set in Track.Sta commands.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Gauge''' ''ValueInMillimeters''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''ValueInMillimeters'''''<nowiki>: A floating-point number representing the rail gauge, measured in </nowiki>'''millimeters''' (0.001 meters). The default value is 1435. </font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 20pt" bgcolor="#e0e0e0"
| <font color="#c00000">☀</font>
| ''Note: ''
|-
|
| <font color="#0060c0">Train.Gauge is the same as Route.Gauge.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Interval''' ''Interval<sub>0</sub>''<nowiki>; </nowiki>''Interval<sub>1</sub>''<nowiki>; ...; </nowiki>''Interval<sub>n-1</sub>''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''ValueInSeconds'''''<nowiki>: A floating-point number representing the time interval between the player's train and the preceding train, measured in </nowiki>'''seconds'''. The default value is 0. </font>
|}

Same as Route.RunInterval. See there for more information.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Train.Velocity''' <font color="blue">''Speed''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="blue">''Speed''</font>'''<nowiki>: A positive floating-point number representing the maximum speed the preceding trains may travel at, </nowiki>'''by default''' measured in '''kilometers per hour''', or 0 for infinite speed. The default value is 0.</font>
|}

This command defines the maximum speed limit the preceding trains may travel at. The actual speed limit may be reduced by Track.Limit commands. The player's train is unaffected by this setting and may travel up to the limits defined by Track.Limit.<br /><br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#606060">'''Train.Acceleration'''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">This command is ignored by openBVE. </font>
|}

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#606060">'''Train.Station'''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">This command is ignored by openBVE. </font>
|}

<br /><br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 7. The Structure namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

The commands in the Structure namespace define which objects to use in other commands. Generally, commands like Track.Rail, Track.FreeObj and so on create objects referenced by a ''StructureIndex''. This ''StructureIndex'' is specific to that command, so you can define a set of objects specific to Track.Rail, Track.FreeObj and so on.<br /><br />The general syntax for commands in the Structure namespace is:<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Structure.''Command''(''StructureIndex'')'''<font color="gray">.Load</font> ''FileName''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

''StructureIndex'' is a non-negative integer. ''FileName'' is the object file to load, relative to the '''Object''' folder. ''Command'' is any of the following commands:<br /><br />

{| style="border-collapse: collapse"
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | ''Command''<nowiki>:</nowiki>
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | Remarks
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Ground
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines objects for Cycle.Ground and Track.Ground.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Rail
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines objects for Track.Rail, Track.RailStart and Track.RailType.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | WallL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines left objects for Track.Wall.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | WallR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines right objects for Track.Wall.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | DikeL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines left objects for Track.Dike.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | DikeR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines right objects for Track.Dike.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | FormL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines left platforms edges for Track.Form.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | FormR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines right platforms edges for Track.Form.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | FormCL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines transformable left platforms for Track.Form. <font color="red">No ANIMATED objects supported.</font>
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | FormCR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines transformable right platforms for Track.Form. <font color="red">No ANIMATED objects supported.</font>
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | RoofL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines left roof edges for Track.Form.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | RoofR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines right roof edges for Track.Form.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | RoofCL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines transformable left roofs for Track.Form. <font color="red">No ANIMATED objects supported.</font>
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | RoofCR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines transformable rigth roofs for Track.Form. <font color="red">No ANIMATED objects supported.</font>
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | CrackL
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines transformable left objects for Track.Crack. <font color="red">No ANIMATED objects supported.</font>
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | CrackR
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines transformable right objects for Track.Crack. <font color="red">No ANIMATED objects supported.</font>
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | FreeObj
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines objects for Track.FreeObj.
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Beacon
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Defines objects for Track.Beacon.
|}

<br />Generally, supported objects are B3D, CSV, X and ANIMATED. However, the FormCL, FormCR, RoofCL, RoofCR, CrackL and CrackR commands only accept B3D, CSV and X objects.<br />➟ [http://trainsimframework.org/develop/route_formroofcrack.html More information about forms, roofs and cracks...]<br /><br />Additionally, there is the Structure.Pole command, which has a slightly different syntax:<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Structure.Pole(''NumberOfAdditionalRails''<nowiki>; </nowiki>''PoleStructureIndex'')'''<font color="gray">.Load</font> ''FileName''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''NumberOfAdditionalRails'''''<nowiki>: An non-negative integer representing the number of additional rails covered by the pole. 0 creates a pole for one rail, 1 for two rails, etc.</nowiki><br />'''''PoleStructureIndex'''''<nowiki>: A non-negative integer representing the pole structure index.</nowiki><br />'''''FileName'''''<nowiki>: The object file to load, relative to the </nowiki>'''Object''' folder.</font>
|}

<br />Please note that all objects but the FreeObj are inserted at the beginning of a block and should thus extend from 0 to ''BlockLength'' (by default 25m) on the z-axis. For further information on usage, see the respective commands from the Track namespace.<br /><br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 8. The Texture namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Commands from this namespace define which background images to use and how they are aligned.<br /><br />[[Image:illustration_background.png]]<br />The background image is displayed as a cylindric wall around the camera whose start (viewed from above) is 60 degrees to the left of the initial forward direction (at the 10 o'clock position). From there, the background image wraps clock-wise around the cylinder with a repetition count specified via Texture.Background(''BackgroundTextureIndex'').X, which by default creats 6 repetitions in a full circle.<br /><br />The upper 3/4 of the image is displayed above the horizon, while the lower 1/4 is displayed below the horizon. Via Texture.Background(''BackgroundTextureIndex'').Aspect, you can choose whether to have a fixed cylinder height or to preserve the aspect ratio of the texture. If the image should have a fixed height, the cylinder has a height of 1/2 its radius, which corresponds to about 20 degree inclination to the top of the image, and about -7 degrees to the bottom of the image. If the aspect ratio of the image is preserved, this takes not only the width and height of the image into account, but also the repetition count.<br /><br />Regardless of the repetition count you chose, you should make sure that the left and right edges of the textures fit seamlessly together. Please also take into account that top and bottom caps are created which sample from the top and bottom 10% of the image. You should avoid mountain peaks and similar extremes in the top 10% of the image in order for such extremes to not leak into the top cap.<br /><br />The image loaded into Texture.Background(0) is displayed at the beginning of the route, unless a Track.Back command at the beginning of the route requests a different image.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Texture.Background(''BackgroundTextureIndex'')'''<font color="gray">.Load</font> ''FileName''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FileName'''''<nowiki>: The texture file to load, relative to the </nowiki>'''Object''' folder.</font>
|}

This command loads a background image to be later used by Track.Back.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Texture.Background(''BackgroundTextureIndex'').X''' ''RepetitionCount''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RepetitionCount'''''<nowiki>: The number of times the background image is repeated in a full circle. The default value is 6.</nowiki></font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Texture.Background(''BackgroundTextureIndex'').Aspect''' ''Mode''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Mode'''''<nowiki>: The mode of aspect ratio handling to use. The default value is 0.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Mode''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Use a fixed height for the cylinder.</nowiki><br />'''1'''<nowiki>: Preserve the aspect ratio of the image. </nowiki></font>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 9. The Cycle namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Cycle.Ground(''GroundStructureIndex'')<font color="gray">.Params</font> ''GroundStructureIndex<sub>0</sub>''<nowiki>; </nowiki>''GroundStructureIndex<sub>1</sub>''<nowiki>; </nowiki>''GroundStructureIndex<sub>2</sub>''<nowiki>; ...; </nowiki>''GroundStructureIndex<sub>n-1</sub>'''''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''GroundStructureIndex'''''<nowiki>: A non-negative integer indicating the ground structure index for which a cycle is to be defined.</nowiki><br />'''''GroundStructureIndex<sub>i</sub>'''''<nowiki>: A non-negative integer indicating a ground structure that has been previously loaded via Structure.Ground.</nowiki></font>
|}

When usually using Track.Ground(''GroundStructureIndex''), the same ground structure object will be repeatedly placed in every block. Via Cycle.Ground, you can override this behavior and automatically cycle through a series of different objects when using Track.Ground(''GroundStructureIndex''). The cycle repeats indefinately, where ''GroundStructureIndex<sub>0</sub>'' starts at track position 0. Technically, the ''i'' in ''GroundStructureIndex<sub>i</sub>'' chosen for a particular track position ''p'' is <tt>Mod[''p'' / BlockLength, ''n'']</tt>.<br /><br />Consider the following definition:<br />

{|
| width="16" valign="top" |
| <font size="-1">''''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Structure<br />.Ground(0) grass.csv<br />.Ground(1) river.csv<br />.Ground(2) asphalt.csv</tt>
|}

<br />The following two codes will produce the same output:<br />

{|
| width="16" valign="top" |
| <font size="-1">''''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Track<br />0, .Ground 0<br />25, .Ground 1<br />50, .Ground 2<br />75, .Ground 0<br />100, .Ground 1<br />125, .Ground 2<br /><nowiki>; and so on...</nowiki></tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Cycle<br />.Ground(0) 0; 1; 2<br />With Track<br />0, .Ground 0</tt>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 10. The Signal namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Commands from this namespace define custom signals.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Signal('''''SignalIndex''''')'''<font color="gray">.Load</font> ''AnimatedObjectFile''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''SignalIndex'''''<nowiki>: A non-negative integer representing the signal index.</nowiki><br />'''''AnimatedObjectFile'''''<nowiki>: A reference to an animated object file, relative to the </nowiki>'''Object''' folder.</font>
|}

Use this command to load signals directly from animated objects. The ''SignalIndex'' can be later referenced in Track.SigF commands to place the signal.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Signal('''''SignalIndex''''')'''<font color="gray">.Load</font> ''SignalFileWithoutExtension''<nowiki>; </nowiki>''GlowFileWithoutExtension''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''SignalIndex'''''<nowiki>: A non-negative integer representing the signal index.</nowiki><br />'''''SignalFileWithoutExtension'''''<nowiki>: A reference to a B3D/CSV/X object file representing the signal, relative to the </nowiki>'''Object''' folder, but without the file extension. '''Is required to be specified.'''<br />'''''GlowFileWithoutExtension'''''<nowiki>: An optional reference to a B3D/CSV/X object file representing the distance glow, relative to the </nowiki>'''Object''' folder, but without the file extension. </font>
|}

Use this command to load signals from a series of individual textures applied onto a common object. openBVE looks for X, CSV and B3D objects in this exact order. Textures are required to have the same name as the signal or glow, plus a non-negative aspect index, plus a file extension for textures. The ''SignalIndex'' can be later referenced in Track.SigF commands to place the signal.<br /><br />For the ''SignalFileWithoutExtension'', there should be the following files present (example):<br /><br />''SignalFileWithoutExtension'''''.x'''<br />''SignalFileWithoutExtension'''''<font color="red">0</font>.bmp'''<br />''SignalFileWithoutExtension'''''<font color="red">1</font>.bmp'''<br />''SignalFileWithoutExtension'''''<font color="red">2</font>.bmp'''<br />''SignalFileWithoutExtension'''''<font color="red">''n''</font>.bmp'''<br /><br />The aspect indices from 0 through ''n'' represent successively more permissive aspects, where 0 is red. The built-in signals, for example, use the indices 0 (<font color="#c00000">●</font>), 1 (<font color="#ffc000">●●</font>), 2 (<font color="#ffc000">●</font>), 3 (<font color="#00c000">●</font><font color="#ffc000">●</font>), 4 (<font color="#00c000">●</font>) and 5 (<font color="#00c000">●●</font>). You can use as many as required.<br /><br />All faces in the object will be applied the currently active aspect texture. This means that you cannot use any other texture in the object, but still have to assign texture coordinates appropriately. For the glow object, the above rules also apply. The glow object is usually a rectangle placed clearly in front of the signal, although you can also use different shapes.<br /><br />The glow textures deserve special attention. All glow textures are pre-processed in the following way:<br /><br />

{| style="border-collapse: collapse"
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | A
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | B
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | C
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | D
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | E
! style="padding: 4px; border: 2px ridge currentColor" bgcolor="#d0d0d0" | F
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" |
[[Image:illustration_glow_1.png]]
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" |
[[Image:illustration_glow_2.png]]
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" |
[[Image:illustration_glow_3.png]]
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" |
[[Image:illustration_glow_4.png]]
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" |
[[Image:illustration_glow_5.png]]
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" |
[[Image:illustration_glow_6.png]]
|}

<br />The texture you start with should have a sharp shape, usually oval. The shape should be fully saturated in the core and blend into pure white at its outer rim. The surroundings of the shape can be either pure black (A) or pure white (B).<br /><br />When openBVE loads the glow texture, it will replace all purely black pixels with purely white pixels, thus arriving at (B). From there, the image is inverted (C), then hue-shifted by 180 degrees (D). Compared to (B), this has the overall effect of inverting the lightness of the image, i.e. fully saturated pixels will be left unchanged (e.g. the core), while bright pixels (such as the outer rim of the shape) will become dark, and vice versa. Then, the image is gamma-corrected to further darken the dark parts (E), and finally, the image is blurred slightly (F).<br /><br />The resulting texture is always additively blended. This means that instead of directly drawing the texture onto the screen, the pixels of the texture are added to the screen pixels. Here, adding black (0) does not change the screen pixels, while adding a fully satured color channel (1) will result in a fully satured color channel, e.g. adding white produces white. Keep in mind that when designing the textures, you will have to follow the inverse rules, e.g. design the image as depicted in (A) or (B), while having in mind how it will be processed afterward.<br /><br /><br />

{|
|- style="height: 4px"
|
|}

<font size="+1" color="#0080ff">■ 11. The Track namespace</font>

----

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

Commands from this namespace define the track layout. Commands from this namespace should appear after commands from any of the other namespaces, and they usually form the largest part of the route file.<br />

{|
|- style="height: 4px"
|
|}

{| style="border: 1px dashed currentColor; margin-right: 20pt; margin-left: 20pt"
| style="border: 2px ridge currentColor" bgcolor="#ffe080" | <font color="#404040"> '''ⓘ''' Use of track positions</font>
|-
| bgcolor="#ffffff" | All commands from the Track namespace need to be associated to track positions. Once a track position has been defined, all subsequent commands are associated to this track position until a new track position is defined. If you do not explicitly state a track position before the first command of the Track namespace is used, 0 will be assumed. While you do not need to use track positions in ascending order, series of commands which are associated the same track position will be sorted into ascending order once the file is loaded. While track positions can be any non-negative floating-point number, many commands in the Track namespace are only to be applied at the beginning of a block, which is 25m by default. For the default situation, this means that some commands are only to be used at track positions 0, 25, 50, 75, 100, 125 and so on. All commands for which this restriction applies are marked as such.
|}

{|
|- style="height: 4px"
|
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.1. Rails</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.RailStart''' ''RailIndex''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''RailType''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A positive integer (</nowiki>'''>=1''') indicating which rail index to use.<br />'''<font color="green">''X''</font>'''<nowiki>: A floating-point number representing the horizontal distance from the player's rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate left, positive ones right.<br />'''<font color="green">''Y''</font>'''<nowiki>: A floating-point number representing the vertical distance from the player's rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate below, positive ones above.<br />'''''RailType'''''<nowiki>: A non-negative integer referencing the rail type to use as defined by a Structure.Rail command.</nowiki></font>
|}

This command starts a new rail represented by the index ''RailIndex''. Upon the point where this command is used, a rail of the same ''RailIndex'' must either not have been used so far in the route, or must have been ended via a Track.RailEnd command. If a rail of the same ''RailIndex'' was already used in the route, the default values of ''X'', ''Y'' and ''RailType'' are the values last used by that rail, otherwise 0. If the rail is to be updated, use the Track.Rail command. If it is to be ended, use the Track.RailEnd command. You can end a rail of a given ''RailIndex'' and start a new rail of the same ''RailIndex'' at the same track position provided that the old rail is first ended and the new rail started afterward. For every block, a structure, determined by ''RailType'', is automatically placed.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Rail''' ''RailIndex''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''RailType''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A positive integer (</nowiki>'''>=1''') indicating which rail index to use.<br />'''<font color="green">''X''</font>'''<nowiki>: A floating-point number representing the horizontal distance from the player's rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate left, positive ones right.<br />'''<font color="green">''Y''</font>'''<nowiki>: A floating-point number representing the vertical distance from the player's rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate below, positive ones above.<br />'''''RailType'''''<nowiki>: A non-negative integer referencing the rail type to use as defined by a Structure.Rail command.</nowiki></font>
|}

This command starts a new rail or updates an existing rail. The rail is represented by the index ''RailIndex''. If a rail of the same ''RailIndex'' was already used in the route, the default values of ''X'', ''Y'' and ''RailType'' are the values last used by that rail, otherwise 0. If the rail is to be ended, use the Track.RailEnd command. You can end a rail of a given ''RailIndex'' and start a new rail of the same ''RailIndex'' at the same track position provided that the old rail is first ended and the new rail started afterward. In each block, the ''X'' and ''Y'' values are repeated if a Track.Rail command is not used for that block. As a consequence, updating the ''X'' or ''Y'' values affects the layout of the rail from the preceding block only. Changing the ''RailType'' will affect the rail from the point on where this command is used. If this command is used multiple times on the same track position for the same rail, then the first instance of the command takes effect, while subsequent ones are ignored.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

<br />

{|
|- style="height: 4px"
|
|}

{| style="border: 1px dashed currentColor; margin-right: 20pt; margin-left: 20pt"
| style="border: 2px ridge currentColor" bgcolor="#ffe080" | <font color="#404040"> '''ⓘ''' Track.RailStart vs. Track.Rail</font>
|-
| bgcolor="#ffffff" | If you want to start a new rail, you can either use Track.RailStart or Track.Rail. When using Track.RailStart, you provide markup that a new rail is in fact to be started, which is invalid if the rail already exists. Using an explicit Track.RailStart will protect you from using a ''RailIndex'' which is already in use, in which case an error message is generated.
|}

{|
|- style="height: 4px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.RailType''' ''RailIndex''<nowiki>; </nowiki>''RailType''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer indicating which rail index to change. The player's rail can be referred to with index </nowiki>'''0'''. The default value is 0.<br />'''''RailType'''''<nowiki>: A non-negative integer referencing the rail type to use as defined by a Structure.Rail command. The default value is 0. </nowiki></font>
|}

This command changes the rail type for an existing rail, represented by ''RailIndex''. The rail must have been started with a Track.RailStart or Track.Rail command and must not have been ended by a Track.RailEnd command. Changing the ''RailType'' will affect the rail from the point on where this command is used.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.RailEnd''' ''RailIndex''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A positive integer (</nowiki>'''>=1''') indicating which rail index to use.<br />'''<font color="green">''X''</font>'''<nowiki>: A floating-point number representing the horizontal distance from the player's rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate left, positive ones right.<br />'''<font color="green">''Y''</font>'''<nowiki>: A floating-point number representing the vertical distance from the player's rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate below, positive ones above. </font>
|}

This command ends an existing rail, represented by the index ''RailIndex''. The default values of ''X'' and ''Y'' are the ones last used by the rail. Once this command is used for a specific ''RailIndex'', the corresponding rail is considered to be non-existing afterward.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of Track.RailStart, Track.Rail, Track.RailType and Track.RailEnd commands''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Track<br />1000, .RailStart 1; 3.8; 0.0; 0<br />1025, .RailType 1; 1<br />1050, .Rail 1; 1.9; 0.0; 0<br />1075, .RailEnd 1</tt>
|}

In the preceding example, rail 1 starts with an x-value of 3.8 and bears a rail index which corresponds to an object intended to depict a straight rail. The rail keeps the x-value of 3.8 at track position 1025, where the rail type is changed to correspond to an object intended to depict an s-shaped curve. At track position 1050, the rail is redefined to have an x-value of 1.9, after which the rail is straight again until 1075, where it is ended, still having an x-value of 1.9.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Accuracy''' ''Value''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Value'''''<nowiki>: A non-negative floating-point number representing the accuracy of the track. The default value is 2.</nowiki></font>
|}

This command sets the accuracy of the track from this point on. Values should be in the range from 0 to 4, where 0 means perfect accuracy (no inaccuracy at all), 1 means very good accuracy (high speed lines), 2 means good accuracy, 3 means mediocre accuracy, and 4 means poor accuracy. Intermediate values are also possible. Currently, values below 0 are clamped at 0, and values above 4 are clamped at 4.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Adhesion''' ''Rate''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Rate'''''<nowiki>: A non-negative floating-point number measured in percent representing the adhesion of the track. The default value is 100.</nowiki></font>
|}

This command sets the adhesion of the track from this point on. As a reference, the value of 135 represents dry conditions, 85 represents frost and 50 represents snowy conditions. With a value of 0, the train will not be able to move at all.<br /><br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.2. Geometry</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Pitch''' ''Rate''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Rate'''''<nowiki>: A floating-point number measured in per thousands representing the pitch of the track. The default value is 0.</nowiki></font>
|}

This command defines the pitch of all rails from this point on. Negative values indicate a downward gradient, positive ones an upward gradient. The value of 0 represents a level track. ''Rate'' can be calculated from a length difference ''X'' and a height difference ''Y'' in the following way:<br />

{|
| width="16" valign="top" |
| <font size="-1">''''Rate'' expressed through ''X'' and ''Y''<nowiki>:</nowiki>''</font>
|-
| width="16" valign="top" | ƒ
| style="border: 1px dotted currentColor" bgcolor="#ffd8c0" | <tt>''Rate'' = 1000 * ''Y'' / ''X''</tt>
|}

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Curve''' <font color="green">''Radius''</font><nowiki>; </nowiki>''CantInMillimeters''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="green">''Radius''</font>'''<nowiki>: A floating-point number representing the radius of the curve, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''CantInMillimeters'''''<nowiki>: A floating-point number which represents the superelevation of a banked curve, </nowiki>'''always''' measured in '''millimeters''' (0.001 meters). The default value is 0. See also Options.CantBehavior.</font>
|}

This command defines the radius of the curve for the player's rail from this point on. Negative values for ''Radius'' indicate a curve to the left, positive ones to the right. The value of 0 represents straight track. The ''CantInMillimeters'' parameter defines the cant (superelevation) in millimeters. If Options.CantBehavior is 0 (default), only the absolute value of ''CantInMillimeters'' is considered, and the superelevation is always towards the curve center (inward). Also, cant cannot be applied on straight track. If Options.CantBehavior is 1, ''CantInMillimeters'' is signed, i.e. negative values bank outward and positive ones inward on curved track. Also, cant can be applied on straight track, where negative values bank toward the left and positive ones toward the right.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Turn''' ''Ratio''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Rate'''''<nowiki>: A floating-point number representing a turn. The default value is 0.</nowiki></font>
|}

This command creates a point-based turn at the point of insertion. ''Ratio'' indicates the ratio between the length difference ''Z'' and the horizontal offset ''X'' in the following way:<br />

{|
| width="16" valign="top" |
| <font size="-1">''''</font>
|-
| width="16" valign="top" | ƒ
| style="border: 1px dotted currentColor" bgcolor="#ffd8c0" | <tt>''Ratio'' = ''X'' / ''Z''</tt>
|}

A negative ratio represents a turn to the left, a positive one to the right. The value of 0 represents a straight track.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command is deprecated - use Track.Curve instead.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Height''' <font color="green">''Y''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="green">''Y''</font>'''<nowiki>: A floating-point number representing the height of the player's rail, </nowiki>'''by default''' measured in meters.</font>
|}

This command defines the height of the player's rail above the ground at the point of insertion. It influences the placement of the ground objects defined via Structure.Ground and changed via Track.Ground. The height is interpolated between adjacent Track.Height commands. For example, the following two codes produce equivalent results:<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of a Track.Height command interpolated at 25m boundaries:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.Height 1<br />1075, Track.Height 4</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Example of Track.Height explicitly set each 25m to produce the same result:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.Height 1<br />1025, Track.Height 2<br />1050, Track.Height 3<br />1075, Track.Height 4</tt>
|}

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.3. Objects</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.FreeObj''' ''RailIndex''<nowiki>; </nowiki>''FreeObjStructureIndex''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to place the object. The default value is 0.</nowiki><br />'''''FreeObjStructureIndex'''''<nowiki>: A non-negative integer representing the object to place as defined via Structure.FreeObj. The default value is 0.</nowiki><br />'''<font color="green">''X''</font>'''<nowiki>: The x-offset from the (straight) rail, </nowiki>'''by default''' measured in '''meters'''. Negative values represent the left, positive ones the right. The default value is 0.<br />'''<font color="green">''Y''</font>'''<nowiki>: The y-offset from the (straight) rail, </nowiki>'''by default''' measured in '''meters'''. Negative values represent below the top of the rails, positive ones above. The default value is 0.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the object is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the object is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the object is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0.</nowiki></font>
|}

This places a "free" object a single time on a specified rail. The object must have been loaded via Structure.FreeObj(''FreeObjStructureIndex'') prior to using this command.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Wall''' ''RailIndex''<nowiki>; </nowiki>''Direction''<nowiki>; </nowiki>''WallStructureIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to start or update the wall. The default value is 0.</nowiki><br />'''''Direction'''''<nowiki>: An integer indicating which wall to use as described below.</nowiki><br />'''''WallStructureIndex'''''<nowiki>: A non-negative integer representing the object to place as defined via Structure.WallL and Structure.WallR. The default value is 0.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Direction''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: The WallL object (left wall) is used.</nowiki><br />'''0'''<nowiki>: Both the WallL and WallR objects are used.</nowiki><br />'''1'''<nowiki>: The WallR object (right wall) is used.</nowiki></font>
|}

This starts or updates a wall on a specified rail. The object must have been loaded via Structure.WallL(''WallObjectIndex'') or Structure.WallR(''WallObjectIndex'') prior to using this command. The walls are placed at the beginning of every block until a corresponding Track.WallEnd ends the wall for this rail. Please note that walls are resurrected if a rail is ended via Track.RailEnd and then started again via Track.RailStart or Track.Rail unless the wall was also ended via Track.WallEnd.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.WallEnd''' ''RailIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to end an existing wall. </nowiki></font>
|}

This ends an existing wall that was previously started via Track.Wall on a specified rail. The wall is not placed for the block in which this command is used.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Dike''' ''RailIndex''<nowiki>; </nowiki>''Direction''<nowiki>; </nowiki>''DikeStructureIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to start or update the dike. The default value is 0.</nowiki><br />'''''Direction'''''<nowiki>: An integer indicating which dike to use as described below.</nowiki><br />'''''DikeStructureIndex'''''<nowiki>: A non-negative integer representing the object to place as defined via Structure.DikeL and Structure.DikeR. The default value is 0.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Direction''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: The DikeL object (left dike) is used.</nowiki><br />'''0'''<nowiki>: Both the DikeL and DikeR objects are used.</nowiki><br />'''1'''<nowiki>: The DikeR object (right dike) is used.</nowiki></font>
|}

This starts or updates a dike on a specified rail. The object must have been loaded via Structure.DikeL(''DikeObjectIndex'') or Structure.DikeR(''DikeObjectIndex'') prior to using this command. The dikes are placed at the beginning of every block until a corresponding Track.DikeEnd ends the dike for this rail. Please note that dikes are resurrected if a rail is ended via Track.RailEnd and then started again via Track.RailStart or Track.Rail unless the dike was also ended via Track.DikeEnd.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.DikeEnd''' ''RailIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to end an existing dike. </nowiki></font>
|}

This ends an existing dike that was previously started via Track.Dike on a specified rail. The dike is not placed for the block in which this command is used.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Pole''' ''RailIndex''<nowiki>; </nowiki>''NumberOfAdditionalRails''<nowiki>; </nowiki>''Location''<nowiki>; </nowiki><font color="green">''Interval''</font><nowiki>; </nowiki>''PoleStructureIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to start or update the pole. The default value is 0.</nowiki><br />'''''NumberOfAdditionalRails'''''<nowiki>: A non-negative integer representing the amount of additional rails covered by this pole (i.e. this rail, plus </nowiki>''NumberOfAdditionalRails'' rails). The default value is 0.<br />'''''Location'''''<nowiki>: If </nowiki>''NumberOfAdditionalRails'' is 0, the side on which the pole is placed (see below), or the x-offset in multiples of 3.8 meters if ''NumberOfAdditionalRails'' is at least 1. The default value is 0.<br />'''''Interval'''''<nowiki>: An integer multiple of the block length specifying the interval in which poles are placed.</nowiki><br />'''''PoleStructureIndex'''''<nowiki>: A non-negative integer representing the object to place as defined via Structure.Pole. The default value is 0. </nowiki></font>
|}

This starts or updates a pole on a specified rail. The object must have been loaded via Structure.Pole(''NumberOfAdditionalRails''<nowiki>; </nowiki>''PoleStructureIndex'') prior to using this command. The poles are placed at the beginning of every block whose track positions are an integer multiple of the ''Interval'' (that is not necessarily at the same location this command is placed). If ''NumberOfAdditionalRails'' is 0, ''Location'' indicates the side of the rail on which the pole is placed. If ''Location'' is less than or equal to 0, the pole is placed as-is (corresponding to the left side). If ''Location'' is greater than 0, the object is mirrored on the x-axis and then placed (corresponding to the right side). If ''NumberOfAdditionalRails'' is greater than or equal to 1, ''Location'' specifies the x-offset in multiples of 3.8 meters. Please note that poles are resurrected if a rail is ended via Track.RailEnd and then started again via Track.RailStart or Track.Rail unless the pole was also ended via Track.PoleEnd.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.PoleEnd''' ''RailIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail on which to end an existing pole. </nowiki></font>
|}

This ends an existing pole that was previously started via Track.Pole on a specified rail. The pole is not placed for the block in which this command is used.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#606060">'''Track.Crack''' ''RailIndex<sub>1</sub>''<nowiki>; </nowiki>''RailIndex<sub>2</sub>''<nowiki>; </nowiki>''CrackStructureIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">[[Image:construction_16.png]] Description not available yet.</font>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Ground''' ''CycleIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''CycleIndex'''''<nowiki>: A non-negative integer representing the cycle of ground objects to place as defined via Structure.Ground or Cycle.Ground.</nowiki></font>
|}

This defines which ground objects to place from this point on. Ground objects are always placed at the beginning of a block at a certain height below the player's rail (as defined via Track.Height). If no cycle was defined for ''CycleIndex'', then the object loaded into Structure.Ground(''CycleIndex'') is placed. Otherwise, the cycle of ground objects as defined via Cycle.Ground(''CycleIndex'') is used.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.4. Stations</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Sta''' ''Name''<nowiki>; </nowiki>''ArrivalTime''<nowiki>; </nowiki>''DepartureTime''<nowiki>; </nowiki>''PassAlarm''<nowiki>; </nowiki>''Doors''<nowiki>; </nowiki>''ForcedRedSignal''<nowiki>; </nowiki>''System''<nowiki>; </nowiki>''ArrivalSound''<nowiki>; </nowiki>''StopDuration''<nowiki>; </nowiki>''PassengerRatio''<nowiki>; </nowiki>''DepartureSound''<nowiki>; </nowiki>''TimetableIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Name'''''<nowiki>: The name of the station. This is displayed in the timetable and in messages, so should not be omitted.</nowiki><br />'''''ArrivalTime'''''<nowiki>: The </nowiki>[http://trainsimframework.org/develop/information_numberformats.html#times time] the player's train is expected to arrive at this station. Special values may also appear - see below.<br />'''''DepartureTime'''''<nowiki>: The </nowiki>[http://trainsimframework.org/develop/information_numberformats.html#times time] the player's train is expected to depart from this station. Special values may also appear - see below.<br />'''''PassAlarm'''''<nowiki>: Indicates whether the pass alarm device should remind the driver of stopping at this station. The default value is 0.</nowiki><br />'''''Doors'''''<nowiki>: Indicates which doors should open at this station. The default value is 0.</nowiki><br />'''''ForcedRedSignal'''''<nowiki>: Indicates whether the signal behind the last station stop should be red on a train approach. The default value is 0.</nowiki><br />'''''System'''''<nowiki>: Indicates which built-in safety system should apply until the next station. The default value is 0.</nowiki><br />'''''ArrivalSound'''''<nowiki>: The sound file to be played on arrival, relative to the </nowiki>'''Sound''' folder.<br />'''''StopDuration'''''<nowiki>: A positive floating-point number indicating the minimum stop duration in seconds, including door opening/closing times. The default value is 15.</nowiki><br />'''''PassengerRatio'''''<nowiki>: A non-negative floating-point number indicating the relative amount of passengers in the train from this station on. As a reference, 100 represents a train with normal amount of passengers, while 250 represents an over-crowded train. Values in-between 0 and 250 should be used. The default value is 100.</nowiki><br />'''''DepartureSound'''''<nowiki>: The sound file to be played before departure (departure time minus sound duration minus door closing time), relative to the </nowiki>'''Sound''' folder.<br />'''''TimetableIndex'''''<nowiki>: A non-negative integer representing the timetable to be shown from this station on as defined via Train.Timetable(</nowiki>''TimetableIndex''). </font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''ArrivalTime''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">''time''<nowiki>: The train is expected to arrive at this particular time.</nowiki><br />''omitted''<nowiki>: The train may arrive at any time.</nowiki><br />'''P''' or '''L'''<nowiki>: All trains are expected to pass this station.</nowiki><br />'''B'''<nowiki>: The player's train is expected to pass this station, while all other trains are expected to stop.</nowiki><br />'''S'''<nowiki>: The player's train is expected to stop at this station, while all other trains are expected to pass.</nowiki><br />'''S:'''''time''<nowiki>: The player's train is expected to arrive at this particular time, while all other trains are expected to pass.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''DepartureTime''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">''time''<nowiki>: The train is expected to depart at this particular time.</nowiki><br />''omitted''<nowiki>: The train may depart at any time.</nowiki><br />'''T''' or '''<nowiki>=</nowiki>'''<nowiki>: This is the terminal station. If </nowiki>''ForcedRedSignal'' is set to 1, the departure signal will be held at red indefinately.<br />'''T:'''''time''<nowiki>: This is the terminal station. If </nowiki>''ForcedRedSignal'' is set to 1, the departure signal will still switch to green before the specified time as if this was a regular station.<br />'''C'''<nowiki>: This is a station at which to "change ends". See the description below.</nowiki><br />'''C:'''''time''<nowiki>: This is a station at which to "change ends". Changing ends will take place at the specified time unless </nowiki>''StopDuration'' interferes. See the description below. </font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''PassAlarm''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: The pass alarm device does not remind the driver of stopping at this station.</nowiki><br />'''1'''<nowiki>: The pass alarm device reminds the driver of stopping at this station.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Doors''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''L''' or '''-1'''<nowiki>: The left doors are expected to open at this station.</nowiki><br />'''N''' or '''0'''<nowiki>: No doors are expected to open at this station, i.e. the train should simply come to a hold.</nowiki><br />'''R''' or '''1'''<nowiki>: The right doors are expected to open at this station.</nowiki><br />'''B'''<nowiki>: Both the left and right doors are expected to open at this station.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''ForcedRedSignal''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Signals are unaffected by this station.</nowiki><br />'''1'''<nowiki>: The signal immediately following the last station stop is hold at red until the train reaches the stopping area and the departure time.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''System''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''ATS''' or '''0'''<nowiki>: ATS should be used from this station on. The following track is not be equipped with ATC.</nowiki><br />'''ATC''' or '''1'''<nowiki>: ATC should be used from this station on. The following track is equipped with ATC.</nowiki></font>
|}

This command initializes a new station. It should be placed at the beginning of the station platform. In order to finalize the creation of a station, use the Track.Stop command to place stop points following this command. All following Track.Stop commands will be associated to this station. At least one Track.Stop command must follow if trains are expected to stop at this station.<br /><br />Stations can be marked as "changing ends" in the departure time. At such stations, when the departure time has been reached, the train will automatically jump to the next station. This feature is intended to fake a reverse of traveling direction without the need to jump to stations manually from the menu.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | The "changing ends" feature is only available in the development release 1.2.11 and above.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Station''' ''Name''<nowiki>; </nowiki>''ArrivalTime''<nowiki>; </nowiki>''DepartureTime''<nowiki>; </nowiki>''ForcedRedSignal''<nowiki>; </nowiki>''System''<nowiki>; </nowiki>''DepartureSound''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Name'''''<nowiki>: The name of the station. This is displayed in the timetable and in messages, so should not be omitted.</nowiki><br />'''''ArrivalTime'''''<nowiki>: The </nowiki>[http://trainsimframework.org/develop/information_numberformats.html#times time] the player's train is expected to arrive at this station. Special values may also appear - see below.<br />'''''DepartureTime'''''<nowiki>: The </nowiki>[http://trainsimframework.org/develop/information_numberformats.html#times time] the player's train is expected to depart from this station. Special values may also appear - see below.<br />'''''ForcedRedSignal'''''<nowiki>: Indicates whether the signal behind the last station stop should be red on a train approach. The default value is 0.</nowiki><br />'''''System'''''<nowiki>: Indicates which built-in safety system should apply until the next station. The default value is 0.</nowiki><br />'''''DepartureSound'''''<nowiki>: The sound file to be played before departure (departure time minus sound duration minus door closing time), relative to the </nowiki>'''Sound''' folder. </font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''ArrivalTime''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">''time''<nowiki>: The train is expected to arrive at this particular time.</nowiki><br />''omitted''<nowiki>: The train may arrive at any time.</nowiki><br />'''P''' or '''L'''<nowiki>: All trains are expected to pass this station.</nowiki><br />'''B'''<nowiki>: The player's train is expected to pass this station, while all other trains are expected to stop.</nowiki><br />'''S'''<nowiki>: The player's train is expected to stop at this station, while all other trains are expected to pass.</nowiki><br />'''S:'''''time''<nowiki>: The player's train is expected to arrive at this particular time, while all other trains are expected to pass.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''DepartureTime''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">''time''<nowiki>: The train is expected to depart at this particular time.</nowiki><br />''omitted''<nowiki>: The train may depart at any time.</nowiki><br />'''T''' or '''<nowiki>=</nowiki>'''<nowiki>: This is the terminal station. If </nowiki>''ForcedRedSignal'' is set to 1, the departure signal will be held at red indefinately.<br />'''T:'''''time''<nowiki>: This is the terminal station. If </nowiki>''ForcedRedSignal'' is set to 1, the departure signal will still switch to green before the specified time as if this was a regular station.<br />'''C'''<nowiki>: This is a station at which to "change ends". See the description below.</nowiki><br />'''C:'''''time''<nowiki>: This is a station at which to "change ends". Changing ends will take place at the specified departure unless </nowiki>''StopDuration'' interferes.</font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''ForcedRedSignal''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: Signals are unaffected by this station.</nowiki><br />'''1'''<nowiki>: The signal immediately following the last station stop is hold at red until the train reaches the stopping area and the departure time.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''System''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''ATS''' or '''0'''<nowiki>: ATS should be used from this station on. The following track is not be equipped with ATC.</nowiki><br />'''ATC''' or '''1'''<nowiki>: ATC should be used from this station on. The following track is equipped with ATC.</nowiki></font>
|}

This command initializes a new station. Prefer using the Track.Sta command, which includes more options. For the options of Track.Sta which are not offered by Track.Station, the following values apply:<br /><br />

{| style="border-collapse: collapse"
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''PassAlarm''
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 0 (not used)
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''Doors''
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | B (both doors must be opened)
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''ArrivalSound''
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Not played
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''StopDuration''
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 15
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''PassengerRatio''
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | 100
|-
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | ''TimetableIndex''
| style="padding: 4px; border: 2px ridge currentColor" bgcolor="#ffffff" | Not affected
|}

<br />The command should be placed at the beginning of the station platform. In order to finalize the creation of a station, use the Track.Stop command to place stop points following this command. All following Track.Stop commands will be associated to this station. At least one Track.Stop command must follow if trains are expected to stop at this station.<br /><br />Stations can be marked as "changing ends" in the departure time. At such stations, when the departure time has been reached, the train will automatically jump to the next station. This feature is intended to fake a reverse of traveling direction without the need to jump to stations manually from the menu.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | The "changing ends" feature is only available in the development release 1.2.11 and above.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Stop''' ''Direction''<nowiki>; </nowiki><font color="green">''BackwardTolerance''</font><nowiki>; </nowiki><font color="green">''ForwardTolerance''</font><nowiki>; </nowiki>''Cars''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Direction'''''<nowiki>: On which side to place a default stop post. The default value is 0.</nowiki><br /><font color="green">'''''BackwardTolerance'''''</font><nowiki>: A positive floating-point number indicating the allowed tolerance in the backward direction, </nowiki>'''by default''' measured in '''meters'''. The default value is 5.<br /><font color="green">'''''ForwardTolerance'''''</font><nowiki>: A positive floating-point number indicating the allowed tolerance in the forward direction, </nowiki>'''by default''' measured in '''meters'''. The default value is 5.<br />'''''Cars'''''<nowiki>: A non-negative integer indicating for how many cars this stop point applies, or 0 for all cars. The default value is 0.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Available options for ''Direction''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: A stop post is created on the left side.</nowiki><br />'''0'''<nowiki>: No stop post is created.</nowiki><br />'''1'''<nowiki>: A stop post is created on the right side.</nowiki></font>
|}

This command places a stop point for the last created station. If there is more than one stop defined for a station, a train is expected to stop at the first Track.Stop command for which ''Cars'' is greater than or equal to the number of cars the train has, where a value for ''Cars'' of 0 indicates a stop point regardless of the amount of cars to be used as the last stop point for a station.<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of a station with multiple stop points:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Track<br />0100, .Sta STATION<br />0178, .Stop 1;;;4 ,; for 4 or less cars<br /> 0212, .Stop 1;;;6 ,; for 5 or 6 cars<br />0246, .Stop 1;;;8 ,; for 7 or 8 cars<br />0280, .Stop 1;;;0 ,; for 9 or more cars</tt>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#606060">'''Track.Form''' ''RailIndex<sub>1</sub>''<nowiki>; </nowiki>''RailIndex<sub>2</sub>''<nowiki>; </nowiki>''RoofStructureIndex''<nowiki>; </nowiki>''FormStructureIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">[[Image:construction_16.png]] Description not available yet.</font>
|}

<br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.5. Signalling and speed limits</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Limit''' <font color="blue">''Speed''</font><nowiki>; </nowiki>''Post''<nowiki>; </nowiki>''Cource''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="blue">''Speed''</font>'''<nowiki>: A positive floating-point number representing the speed, </nowiki>''' by default''' measured in '''km/h''', or 0 to indicate no speed restriction. The default value is 0.<br />'''''Post'''''<nowiki>: The side on which to place a default Japanese-style speed limit post. The default value is 0.</nowiki><br />'''''Cource'''''<nowiki>: The directional indication. The default value is 0.</nowiki></font>
|}

[[Image:illustration_limit.png]]<br />

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Post''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: The post is placed on the left side of the track.</nowiki><br />'''0'''<nowiki>: No post will be placed.</nowiki><br />'''1'''<nowiki>: The post is placed on the right side of the track.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Cource''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: The post applies for a left-bound track.</nowiki><br />'''0'''<nowiki>: The post does not indicate a particular direction.</nowiki><br />'''1'''<nowiki>: The post applies for a right-bound track. </nowiki></font>
|}

This command defines the new speed limit from this point on. If the new speed limit is lower than the current speed limit, the new speed limit will take effect immediately. If the speed limit is higher than the current speed limit, the new speed limit will take effect only once the whole train has passed this point. By setting ''Speed'' to <tt>0</tt>, the speed restriction is released. By setting ''Post'' to either <tt>-1</tt> or <tt>1</tt>, a default Japanese-style speed post is placed at the respective side of the track. Setting ''Course'' to either <tt>-1</tt> or <tt>1</tt> includes a directional indication, which is usually used at railroad switches to indicate that the speed limit only applies if the respective direction is being taken. If ''Speed'' is set to <tt>0</tt>, the setting of ''Course'' has no effect.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Section''' ''a<sub>0</sub>''<nowiki>; </nowiki>''a<sub>1</sub>''<nowiki>; </nowiki>''a<sub>2</sub>''<nowiki>; ...; </nowiki>''a<sub>n</sub>''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''a''<sub>i</sub>'''''<nowiki>: A non-negative number specifying one of the section's aspects.</nowiki></font>
|}

This command starts a section, the functional part of signalling, to be used in conjunction with Track.SigF, which creates a visual representation of a section (a signal). The ''a<sub>i</sub>'' parameters specify the aspects the section can bear. An aspect of 0 corresponds to a red section which must not be passed by a train. The ''a<sub>0</sub>'' term is mandatory.<br />

{|
|- style="height: 4px"
|
|}

{| style="border: 1px dashed currentColor; margin-right: 20pt; margin-left: 20pt"
| style="border: 2px ridge currentColor" bgcolor="#ffe080" | <font color="#404040"> '''ⓘ''' Default versus simplified section behavior</font>
|-
| bgcolor="#ffffff" | There are two different modes of behavior on how to interpret the ''a<sub>i</sub>'' parameters. The mode can be set via Options.SectionBehavior. The following are separate descriptions for default and simplified behavior.
|}

{|
|- style="height: 4px"
|
|}

<br />'''Default behavior:'''<br />The ''a<sub>i</sub>'' terms specify the aspect the section should bear depending on how many sections ahead are clear until a red one is encountered. The order of the terms is relevant. The same aspect may occur multiple times.<br />

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Meanings of the ''a<sub>i</sub>'' terms:
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''a<sub>0</sub>'''<nowiki>: The aspect to show when this section is occupied by a train or otherwise hold at red.</nowiki><br />'''a<sub>1</sub>'''<nowiki>: The aspect to show when this section is clear, but the immediately following section is red.</nowiki><br />'''a<sub>2</sub>'''<nowiki>: The aspect to show when this section and the following section are clear, but the one immediately following the latter one is red.</nowiki><br />'''a''<sub>n</sub>'''''<nowiki>: The aspect to show when </nowiki>''n'' sections are clear before a red one is encountered.</font>
|}

In the case more sections ahead are clear than indicated by the ''a<sub>i</sub>'' terms, the section will bear the aspect of ''a<sub>n</sub>''.<br /><br />'''Simplified behavior:'''<br />The ''a<sub>i</sub>'' terms specify the repertoire of aspects the section can have. A section will bear the smallest of the ''a<sub>i</sub>'' which is greater than the current aspect of the upcoming section. If no such ''a<sub>i</sub>'' exists, the section will bear the aspect of ''a<sub>n</sub>''. The order of the ''a<sub>i</sub>'' is irrelevant. If the same aspect occurs multiple times, this has no effect.<br /><br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of a Track.Section command in conjunction with a Track.SigF command:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Track<br />1000, .Section 0;2;4, .SigF 3;0;-3;-1</tt>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.SigF''' ''SignalIndex''<nowiki>; </nowiki>''Section''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''SignalIndex'''''<nowiki>: A non-negative integer representing the signal to be placed as defined via Signal(</nowiki>''SignalIndex'')<font color="gray">.Load</font>.<br />'''''Section'''''<nowiki>: A non-negative integer representing the section this signal is attached to, with 0 being the current section, 1 the upcoming section, 2 the section after that, and so on.</nowiki><br />'''<font color="green">''X''</font>'''<nowiki>: The X-coordinate to place the signal object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''<font color="green">''Y''</font>'''<nowiki>: The Y-coordinate to place the signal object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the object is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the object is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the object is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0. </nowiki></font>
|}

This command creates a non-function signal, that is, a visual representation of a section as defined via Track.Section. Setting ''Y'' to a negative number resets the y-coordinate to 4.8 meters and attaches a default signal post. Also see Track.Section.<br /><br />If no object has been defined by Signal(''SignalIndex''), one of the default Japanese signals is used:<br />

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Default signals for ''SignalIndex''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''3'''<nowiki>: A three-aspect signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●</font>yellow and <font color="#00c000">●</font>green.<br />'''4'''<nowiki>: A four-aspect (type A) signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●●</font>yellow-yellow, <font color="#ffc000">●</font>yellow and <font color="#00c000">●</font>green.<br />'''5'''<nowiki>: A five-aspect (type A) signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●●</font>yellow-yellow, <font color="#ffc000">●</font>yellow, <font color="#00c000">●</font><font color="#ffc000">●</font>yellow-green and <font color="#00c000">●</font>green.<br />'''6'''<nowiki>: A repeating signal equivalent to that created by Track.Relay.</nowiki></font>
|}

----

<br />

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Signal''' ''Aspects''<nowiki>; </nowiki>''<font color="gray">Unused</font>''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''<br />'''Track.Sig''' ''Aspects''<nowiki>; </nowiki>''<font color="gray">Unused</font>''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Type'''''<nowiki>: The number of aspects for this signal. The default value is -2.</nowiki><br />'''''<font color="gray">Unused</font>'''''<nowiki>: </nowiki>''This argument is not used by openBVE.''<br />'''<font color="green">''X''</font>'''<nowiki>: The X-coordinate to place the signal object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''<font color="green">''Y''</font>'''<nowiki>: The Y-coordinate to place the signal object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the object is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the object is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the object is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0. </nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Type''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">[http://trainsimframework.org/common/illustration_signals_large.png [[Image:illustration_signals_small.png]]]<br />'''2'''<nowiki>: A two-aspect (type A) signal having aspects </nowiki><font color="#c00000">●</font>red and <font color="#ffc000">●</font>yellow.<br />'''-2'''<nowiki>: A two-aspect (type B) signal having aspects </nowiki><font color="#c00000">●</font>red and <font color="#00c000">●</font>green.<br />'''3'''<nowiki>: A three-aspect signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●</font>yellow and <font color="#00c000">●</font>green.<br />'''4'''<nowiki>: A four-aspect (type A) signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●●</font>yellow-yellow, <font color="#ffc000">●</font>yellow and <font color="#00c000">●</font>green.<br />'''-4'''<nowiki>: A four-aspect (type B) signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●</font>yellow, <font color="#00c000">●</font><font color="#ffc000">●</font>yellow-green and <font color="#00c000">●</font>green.<br />'''5'''<nowiki>: A five-aspect (type A) signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●●</font>yellow-yellow, <font color="#ffc000">●</font>yellow, <font color="#00c000">●</font><font color="#ffc000">●</font>yellow-green and <font color="#00c000">●</font>green.<br />'''-5'''<nowiki>: A five-aspect (type B) signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●</font>yellow, <font color="#00c000">●</font><font color="#ffc000">●</font>yellow-green, <font color="#00c000">●</font>green and <font color="#00c000">●●</font>green-green.<br />'''6'''<nowiki>: A six-aspect signal having aspects </nowiki><font color="#c00000">●</font>red, <font color="#ffc000">●●</font>yellow-yellow, <font color="#ffc000">●</font>yellow, <font color="#00c000">●</font><font color="#ffc000">●</font>yellow-green, <font color="#00c000">●</font>green and <font color="#00c000">●●</font>green-green.</font>
|}

This command creates a functional signal. You can choose from the available options for ''Aspect'' to create any of the default Japanese signals. Setting ''X'' to 0 creates a functional but invisible signal similar to Track.Section. Setting ''X'' to a non-zero number and ''Y'' to a negative number resets the y-coordinate to 4.8 meters and attaches a default signal post.<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example of a four-aspect type B signal without a post at x=-3 and y=5:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.Signal -4;;-3;5</tt>
|}

{|
| width="16" valign="top" |
| <font size="-1">''Example of a four-aspect type B signal including a post at x=-3 and y=4.8:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>1000, Track.Signal -4;;-3;-1</tt>
|}

Track.Signal is similar to using Track.Section and Track.SigF in one command.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Relay''' <font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="green">''X''</font>'''<nowiki>: The X-coordinate at which to place the object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''<font color="green">''Y''</font>'''<nowiki>: The Y-coordinate at which to place the object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the object is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the object is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the object is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0. </nowiki></font>
|}

This commands creates a default Japanese repeating signal. The repeating signal repeats the state of the upcoming signal. Setting ''X'' to zero does not create a repeating signal, but forces the command to be ignored. Setting ''X'' to a non-zero number and ''Y'' to a negative number resets the y-coordinate to 4.8 and attaches a default signal post.<br /><br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.6. Safety systems</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Beacon''' ''Type''<nowiki>; </nowiki>''BeaconStructureIndex''<nowiki>; </nowiki>''Section''<nowiki>; </nowiki>''Data''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Type'''''<nowiki>: A non-negative integer representing the type of the beacon to be transmitted to the train.</nowiki><br />'''''BeaconStructureIndex'''''<nowiki>: A non-negative integer representing the object to be placed as defined via Structure.Beacon, or -1 to not place any object.</nowiki><br />'''''Section'''''<nowiki>: An integer representing the section to which the beacon is attached, namely 0 for the current section, 1 for the upcoming section, 2 for the section behind that, etc., or -1 for the next red section.</nowiki><br />'''''Data'''''<nowiki>: An integer representing arbitrary data specific to the beacon type to be transmitted to the train.</nowiki><br />'''<font color="green">''X''</font>'''<nowiki>: The X-coordinate at which to place the object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''<font color="green">''Y''</font>'''<nowiki>: The Y-coordinate at which to place the object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the object is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the object is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the object is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0.</nowiki></font>
|}

This command places a beacon (transponder). The object must have been loaded via Structure.Beacon(''BeaconStructureIndex'') prior to using this command. When the train passes the beacon, the type of beacon and various data will be transmitted to the train, including the state of the referenced section.<br /><br />It should be noted that the built-in safety systems also receive data from these beacons as Track.Beacon(''Type'') is roughly equivalent to Track.Transponder(''Type''). Please see [http://trainsimframework.org/develop/information_standards.html the page about beacon standards] for more information.<br /><br />

----

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Transponder''' ''Type''<nowiki>; </nowiki>''Signal''<nowiki>; </nowiki>''SwitchSystem''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''<br />'''Track.Tr''' ''Type''<nowiki>; </nowiki>''Signal''<nowiki>; </nowiki>''SwitchSystem''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Type'''''<nowiki>: The type of the transponder. The default value is 0.</nowiki><br />'''''Signal'''''<nowiki>: The signal this transponder references. The default value is 0.</nowiki><br />'''''SwitchSystem'''''<nowiki>: Whether to automatically switch the safety system. The default value is 0.</nowiki><br />'''<font color="green">''X''</font>'''<nowiki>: The X-coordinate at which to place the object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''<font color="green">''Y''</font>'''<nowiki>: The Y-coordinate at which to place the object, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the object is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the object is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the object is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Type''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">[[Image:illustration_transponders.png]]<br />'''0'''<nowiki>: An S-type transponder used by ATS-S. Usually placed 600m in front of a signal.</nowiki><br />'''1'''<nowiki>: An SN-type transponder used by ATS-SN. Usually placed 20m in front of a signal.</nowiki><br />'''2'''<nowiki>: An accidental departure transponder. Usually placed shortly behind a station stop.</nowiki><br />'''3'''<nowiki>: An ATS-P pattern renewal transponder. Usually placed 600m, 280m, 180m, 130m, 85m or 50m in front of a signal, depending on the circumstances.</nowiki><br />'''4'''<nowiki>: An ATS-P immediate stop transponder. Usually placed either 25m or 30m in front of a signal, depending on the circumstances.</nowiki></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Signal''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: The upcoming signal is referenced.</nowiki><br />'''1'''<nowiki>: The signal immediately behind the upcoming signal is referenced.</nowiki><br />'''''n'''''<nowiki>: The </nowiki>''n'''th signal behind the upcoming signal is referenced.</font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''SwitchSystem''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''-1'''<nowiki>: The transponder does not switch the train between ATS-SN and ATS-P.</nowiki><br />'''0'''<nowiki>: The transponder automatically switches the train to ATS-SN for transponder types </nowiki>''0'' and ''1'', and to ATS-P for types ''3'' and ''4''. </font>
|}

<br />This command places a transponder, usually for the built-in safety systems ATS-SN or ATS-P. For more information about these systems and their transponders, see [http://trainsimframework.org/use/drive.html#atssn the user's documentation about ATS].<br /><br />It should be noted that custom safety system plugins also receive data from these transponders as Track.Transponder(''Type'') is roughly equivalent to Track.Beacon(''Type''). Please see [http://trainsimframework.org/develop/information_standards.html the page about beacon standards] for more information.<br /><br />➟ [http://trainsimframework.org/use/drive.html#atssn Go here to find out more about ATS-SN and ATS-P.]<br />➟ [http://trainsimframework.org/develop/tutorial_ats.html There is a tutorial available for the proper use of ATS-SN and ATS-P in route files, including all of the five transponders.]<br />

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.AtsSn'''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

This command places an S-type transponder for the built-in safety system ATS-SN, referencing the upcoming signal, and automatically switching to ATS-SN. The command is equivalent to '''Track.Tr 0;0;0'''. See there for more information.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.AtsP'''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

This command places a pattern renewal transponder for the built-in safety system ATS-P, referencing the upcoming signal, and automatically switching to ATS-P. The command is equivalent to '''Track.Tr 3;0;0'''. See there for more information.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Pattern''' ''Type''<nowiki>; </nowiki><font color="blue">''Speed''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Type'''''<nowiki>: The type of speed restriction.</nowiki><br />'''<font color="blue">''Speed''</font>'''<nowiki>: A non-negative floating-point number representing the speed restriction, </nowiki>'''by default''' measured in '''km/h'''.</font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Options for ''Type''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">'''0'''<nowiki>: A temporary speed restriction.</nowiki><br />'''1'''<nowiki>: A permanent speed restriction.</nowiki></font>
|}

This command defines a speed restriction for the built-in safety system ATS-P.<br /><br />A temporary speed restriction (''Type''<nowiki>=0) is to be inserted at the point where the speed restriction should apply. ATS-P will know about this speed restriction in advance and will brake the train so that the train meets the speed restriction at that point. Once the point is passed, the speed restriction no longer applies.</nowiki><br /><br />A permanent speed restriction (''Type''<nowiki>=1) is to be inserted at the point where the speed restriction should apply, however, ATS-P does not know about this limit in advance and will only brake the train from that point on. For a higher degree of realism, insert permanent speed restrictions at the same point as ATS-P transponders. A permanent speed restriction, as the name suggests, is remembered by ATS-P and is only released by a subsequent permanent speed restriction.</nowiki><br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.PLimit''' <font color="blue">''Speed''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="blue">''Speed''</font>'''<nowiki>: A positive floating-point number representing the permanent speed restriction for ATS-P, </nowiki>'''by default''' measured in '''km/h'''. </font>
|}

This command is equivalent to '''Track.Pattern 1;''Speed'''''. See there for more information.<br /><br /><br />

{|
|- style="height: 4px"
|
|}

<font color="#0080ff">● 11.7. Miscellaneous</font>

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font size="-1" color="#808080"></font>
|}

{|
|- style="height: 2px"
|
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Back''' ''BackgroundTextureIndex''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''BackgroundTextureIndex'''''<nowiki>: A non-negative integer representing the background image to be displayed as defined via Texture.Background(</nowiki>''BackgroundTextureIndex''). </font>
|}

This command defines which background image to show from now on.<br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Fog''' <font color="green">''StartingDistance''</font><nowiki>; </nowiki><font color="green">''EndingDistance''</font><nowiki>; </nowiki>''RedValue''<nowiki>; </nowiki>''GreenValue''<nowiki>; </nowiki>''BlueValue''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''<font color="green">''StartingDistance''</font>'''<nowiki>: A floating-point number indicating the start of fog, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''<font color="green">''EndingDistance''</font>'''<nowiki>: A floating-point number indicating the end of fog, </nowiki>'''by default''' measured in '''meters'''. The default value is 0.<br />'''''RedValue'''''<nowiki>: An integer ranging from 0 to 255 representing the red component of the fog. The default value is 128.</nowiki><br />'''''GreenValue'''''<nowiki>: An integer ranging from 0 to 255 representing the green component of the fog. The default value is 128.</nowiki><br />'''''BlueValue'''''<nowiki>: An integer ranging from 0 to 255 representing the blue component of the fog. The default value is 128. </nowiki></font>
|}

This command defines the fog from this point on, or deactivates fog. If fog is to be enabled, ''StartingDistance'' must be less than ''EndingDistance''. If fog is to be disabled, ''StartingDistance'' must be greater than or equal to ''EndingDistance''.<br /><br />Fog affects the coloring of objects. Objects before the starting distance appear as-is, objects after the ending distance appear in the fog color, and objects in-between blend linearly between those. The background image is affected by fog as well. For the fog calculations, the background image is assumed to be at 600 meters distance from the camera, regardless of the actual viewing distance.<br /><br />Depending on Options.FogBehavior, there are two options how this command affects fog from this point on. In block-wise mode, the current fog blends from the beginning of this block to the new settings at the end of this block. The new setting is kept for following blocks. This is the default behavior. In interpolation mode, each Track.Fog command defines a control point for fog, where all of the settings (distances and colors) are interpolated linearly between the control points.<br /><br />

{|
| <font color="red">⚠</font>
|
| bgcolor="#e0e0e0" |
| bgcolor="#e0e0e0" | This command can only be used at the beginning of a block.
| bgcolor="#e0e0e0" |
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Brightness''' ''Value''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Value'''''<nowiki>: A non-negative integer within the range from 0 to 255. The default value is 255. </nowiki></font>
|}

This command marks a point which affects the brightness in the cab. ''Value'' is measured from 0 (dark) to 255 (light), and is linearly interpolated between successive Track.Brightness commands for any given point on the track. This command should be used for tunnels, bridges, station roofs, or anything else that would affect the brightness as perceived inside the cab.<br />

{|
| width="16" valign="top" |
| <font size="-1">''Example:''</font>
|-
| width="16" valign="top" | ▶
| style="border: 1px dashed currentColor" bgcolor="#d4d8ff" | <tt>With Track<br />1200, .Brightness 255 ,; before the bridge starts<br />1205, .Brightness 128 ,; directly under the bridge here<br />1210, .Brightness 255 ,; as soon as the bridge ends</tt>
|}

----

<br />

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Marker''' ''FileName''<nowiki>; </nowiki><font color="green">''Distance''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FileName'''''<nowiki>: The file name for the marker image, relative to the </nowiki>'''Object''' folder.<br /><font color="green">'''''Distance'''''</font><nowiki>: A non-zero floating-point number indicating the length for which the marker image is displayed, </nowiki>'''by default''' measured in '''meters'''.</font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 40pt"
| ▸ Behavior for ''Distance''<nowiki>:</nowiki>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 50pt"
| <font color="#808080">''negative value''<nowiki>: The marker image starts to display at the Track.Marker command, and ends -</nowiki>''Distance'' meters after the Track.Marker command.<br />''positive value''<nowiki>: The marker image starts to display </nowiki>''Distance'' meters before the Track.Marker command, and ends at the Track.Marker command.</font>
|}

This command shows a so-called marker image, which is displayed in the top-right corner of the screen. You can use these images for advisory or informational purposes. The RGB color of 64,64,64 inside the image is made transparent.<br /><br />

----

{|
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.PointOfInterest''' ''RailIndex''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''<nowiki>; </nowiki>''Text''<br />'''Track.POI''' ''RailIndex''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font><nowiki>; </nowiki>''Yaw''<nowiki>; </nowiki>''Pitch''<nowiki>; </nowiki>''Roll''<nowiki>; </nowiki>''Text''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''RailIndex'''''<nowiki>: A non-negative integer representing the rail for the point of interest.</nowiki><br />'''<font color="green">''X''</font>'''<nowiki>: A floating-point number representing the horizontal offset from the rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate left, positive ones right.<br />'''<font color="green">''Y''</font>'''<nowiki>: A floating-point number representing the vertical offset from the rail, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate below, positive ones above.<br />'''''Yaw'''''<nowiki>: The angle in degrees by which the view is rotated in the XZ-plane in clock-wise order when viewed from above. The default value is 0.</nowiki><br />'''''Pitch'''''<nowiki>: The angle in degrees by which the view is rotated in the YZ-plane in clock-wise order when viewed from the left. The default value is 0.</nowiki><br />'''''Roll'''''<nowiki>: The angle in degrees by which the view is rotated in the XY-plane in clock-wise order when viewed from behind. The default value is 0.</nowiki><br />'''''Text'''''<nowiki>: A textual representation of the point of interest.</nowiki></font>
|}

This command creates a point of interest which the user can jump to by pressing the CAMERA_POI_PREVIOUS (NUM 1) or CAMERA_POI_NEXT (NUM 7) keys. The camera will be placed at the specified location with the specified orientation. If ''Text'' is non-empty, a message will appear briefly showing the text.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.PreTrain''' ''Time''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''Time'''''<nowiki>: The </nowiki>[http://trainsimframework.org/develop/information_numberformats.html#times time] at which the pretrain is at this track position. </font>
|}

This commands creates a position-time-association for an invisible preceding train in order to influence signalling. Contrary to a real preceding train as created by Route.RunInterval, the invisible preceding train created by Track.PreTrain is a way of scripting where the invisible preceding train is at any given time. The position-time-associations must be in increasing order, that is, at a later track position, the associated time must also be later. Before the first scripted time, the invisible preceding train resides at the first scripted position. In-between the first and last scripted time, the invisible preceding train moves (linearly) between the scripted points. After the last scripted time, the invisible preceding train is removed and thus clears signalling.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Announce''' ''FileName''<nowiki>; </nowiki><font color="blue">''Speed''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FileName'''''<nowiki>: The file name for the sound to play, relative to the </nowiki>'''Sound''' folder.<br /><font color="blue">'''''Speed'''''</font><nowiki>: The reference speed in km/h for speed-dependant sounds, or 0 to play the sound speed-independently. The default value is 0.</nowiki></font>
|}

This command plays an announcement or other kind of sound in the cab once the player's train crosses the point where this command is used. If ''Speed'' is set to 0 (default), the sound is played as-is. If a ''Speed'' is given though, the sound plays at is original pitch at the specified speed, and is pitch-modulated proportionally for other speeds, useful for custom flange sounds, pointwork sounds, etc.<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Doppler''' ''FileName''<nowiki>; </nowiki><font color="green">''X''</font><nowiki>; </nowiki><font color="green">''Y''</font></font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080">'''''FileName'''''<nowiki>: The file name for the sound to play, relative to the </nowiki>'''Sound''' folder.<br />'''<font color="green">''X''</font>'''<nowiki>: A floating-point number representing the horizontal offset from rail 0, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate left, positive ones right.<br />'''<font color="green">''Y''</font>'''<nowiki>: A floating-point number representing the vertical offset from rail 0, </nowiki>'''by default''' measured in '''meters'''. Negative values indicate below, positive ones above. </font>
|}

This command places an environmental sound effect at the specified location. The sound will play in a loop for the duration of the simulation and employs the doppler effect. (Note: All sounds in openBVE employ the doppler effect.)<br /><br />

----

{|
|
|-
| style="border: 1px dotted currentColor" bgcolor="#f0f0f0" | <font face="monospace"><font color="rgb(128, 128, 128)"><font color="#c00000">'''Track.Buffer'''</font></font></font>
|}

{| style="border: 0px currentColor; margin-right: 10pt; margin-left: 10pt"
| <font color="#808080"></font>
|}

This command places a bumper. The train can collide with the bumper in both the forward and backward directions. Place this command at the beginning and the end of the route. An object is not automatically created, so use Track.FreeObj to create a visual representation of the bumper if necessary.

</font></font>