CSV 线路格式

➟ 速查目录…

■ 内容目录

• 1. Overview
• 2. Syntax
• 3. Preprocessing
• 4. The Options namespace
• 5. The Route namespace
• 6. The Train namespace
• 7. The Structure namespace
• 8. The Texture namespace
• 9. The Cycle namespace
• 10. The Signal namespace
• 11. The Track namespace
  • 11.1. Rails
  • 11.2. Geometry
  • 11.3. Objects
  • 11.4. Stations
  • 11.5. Signalling and speed limits
  • 11.6. Safety systems
  • 11.7. Miscellaneous

■ 1. 综述

CSV格式线路是以纯文本形式编辑的线路。

线路文件是纯文本，且可以使用任意字符编码，但是，我们推荐线路作者们使用UTF8-BOM编码格式。游戏在解析数字数据时，使用的解析方法是 宽松 的(特别指出处除外)，但是，我们推荐线路作者们严格规范地编写线路文件。 这个文件一般来说可以被放在Train或Railway文件夹下的任何地方。文件名可以随意，但扩展名必须是 .csv 。线路文件被从头到尾逐行解析，每行被分割并被从左到右解析。

路线文件包括一系列指令，用来导入线路中用到的模型（Structure（结构）命名空间），线路的属性信息（说明线路使用的默认列车和背景等信息），文件的其余部分是Track（轨道）命名空间。在这一部分中，主轨道位置（一般以米为单位）被用来描述轨道在哪里转弯，车站的位置在哪里，墙壁应当在哪里开始、哪里结束，以此类推。说得明白一点儿，Track（轨道）命名空间的指令是要放在最后的。

这个格式预设了一条游戏默认的主轨道（0号轨道），不可以指定它开始的位置，也不能结束它。和游戏中其他轨道不同的是，它从线路的开始一直延续到线路的终点，代表着玩家驾驶的列车行驶的轨道。除此之外，游戏中定义的其他轨道都是只供装饰，不能行驶的。不过可以使用 轨道循迹物件 来让AI列车在其它轨道上行驶。

可以几何意义上地弯曲和抬升默认的主轨道，而其他轨道都是相对于主轨道定义的，并随主轨道弯曲起伏。除非特别修改定义，线路中每25米划分为一个区间块，特定的命令只有在区间块的边界位置（整25米位置）才能发挥作用。物体的放置总是基于一个坐标系，它的轴并不弯曲，而是直直地指向邻近的下一个区间块。

➟ 还可查阅这份CSV格式的速查目录…

■ 2. 语法

对于线路文件中的每一行，在开头和结尾的空格会被统统忽略。然后，每一行指令都会按逗号(U+002C，英文半角的那个)分割。于是，每一行都会被看作这样一个格式：

表达式内容主要有以下类别：

● 注释

注释就是给人看的，游戏完全不管的。以分号(U+003B，英文半角)开头的表达式都会被视为注释。

● 主轨道位置与距离

一个非负的 严格格式 浮点数，代表一个主轨道位置。随后的指令都将以此位置作为基准点。

这是一个配合Options.UnitOfLength的更加复杂的距离指定格式，可用于非公制计量单位。每一个 部分_i 都是 严格格式 的浮点数。 部分₁ 会被乘上 系数₁, 部分₂ 乘上 系数₂，以此类推，真正的主轨道位置是所有积的和。这个结果必须是非负的。各部分被冒号(U+003A，英文半角)分隔。如果想了解如何设定系数，请参见Options.UnitOfLength一节。

在任何参数中使用距离的命令中，这个冒号表示法就可以被使用，到时我们会用绿色标出这种情况。

当n个单位系数被使用Options.UnitOfLength定义，但是使用冒号表示法时输入的部分却没有全部给出，那么这些系数将会被向右匹配，在左边的会被忽略。因此，这几种表示方法是等效的：0:0:2，0:2，和2.

● 指令

没有参数的指令：

含有几个参数的指令：

不仅有参数还有后缀和编号的指令：

规则：

指令名称是大小写都可以的。编号和参数被分号(U+003B，英文半角)隔开。在指令名称、编号和参数周围的空格都是被忽略的，括号周围的空格也是被忽略的。

如果要使用编号，它必须被成对括号(U+0028，英文半角在键盘9上面)和(U+0029，英文半角在键盘0上面)括起来。在使用编号时至少要提供一个参数和一个后缀。

有两个使用参数的方法变种，除了$开头的预处理指令($Chr, $Rnd, $Sub, …)之外，可以按照个人喜好二选一。
第一种方法：参数被至少一个空格(U+0020，平常用的那个)和编号、指令的大名以及后缀分开。
第二种方法：参数被成对括号(U+0028，英文半角在键盘9上面的那个)和(U+0029，英文半角在键盘0上面的那个)括起来。
在第二种方法中，当使用编号时就必须使用后缀。在参数周围的空格都会被忽略。

请注意在有些指令中，不管是用哪种表示方法，后缀都是必需的。在接下来的文档中，必需的后缀将被 加粗 ，对于第一种方法加不加均可的后缀将被使用灰色表示。

● With 语句

不严谨地来说，在CSV路线中，“命名空间”的意思和“章节”、“部分”差不多。
其后所有直接以点号 (U+002E，英文半角) 开头的指令都被自动加上 命名空间前缀 。 例如：

和这个是等效的：

■ 3. 预处理

在游戏开始解析线路文件之前，预处理指令将会被预先处理替换。预处理器会按照正常顺序分析这些以$开头的预处理命令。$Chr、$Rnd和$Sub指令可以随便嵌套，$Include、$If、$Else和$EndIf不能出现在另一个指令的括号里。

该指令按照权值随机选出一个线路文件，再将其内容导入本线路中。因为该文件内容会被不加修改直接在该指令的位置插入，可能需要照顾一下With指令等，不要让它们出现冲突。如果参数中最后一个文件没有给出权值，它会被按1处理。

$Include指令在几个线路有大量重复内容时很有用，可以把重复内容单独存进另一个文件，然后在主文件中导入它，以方便编码。这个指令还可以被用来随机选取线路代码。请注意导入的文件中也可以包含$Include指令来引用更多的文件，但是应该避免循环引用，例如A导入B而B又导入A。要导入的那个文件不应该使用.csv作为格式扩展名（也许用.include是个方便区分的好主意），不然玩家可能会一不小心从主菜单选择了这个“不完全的线路文件”然后发现没法加载（除非那个文件本身就是一个单独的线路，然后本来就想让玩家加载它）。

如果任何一个文件_i被一个:主轨道位置偏移量后缀，那个文件中所有的主轨道位置表达式都会被按照这个量以米作单位偏移。例如，$Include(stations.include:2000) 会将stations.include文件中的所有内容在插入前都向前偏移2000米。需要注意这些主轨道位置表达式是在所有的预处理命令都被执行完才会被做偏移处理。这意味着像"1$Rnd(2;8)00"这样的主轨道位置表达式尽管在预处理前还不是一个主轨道距离表达式，但是它的随机结果照样会被进行偏移处理。

这个指令会在原位插入一个对应Ascii码的字符。如果想要在某个地方放置一个字符却又不想破坏指令语法结构（比如站名里开头带空格、带括号逗号分号等，如果不这样加入就会被游戏误读），可以使用这个指令。有关的字符有：

“$Chr(13)$Chr(10)"(CRLF)代表一次换行。插入$Chr(59)可能基于它的位置被解释为注释开始或指令参数分隔符。

这个指令会在原位插入一个位于最小值和最大值之间的随机整数。可以用这个来给线路添加一些随机性。

会产生以下三个结果之一：

这个指令只应该单独出现，它将会把表达式的值赋给编号为编号的这个变量。它不在原位插入任何内容。可以把一个随机数存起来然后以后多次使用（比如说放置几棵到一条随机但是却相同的轨道的排成一排的树）。下面关于 $Sub(编号) 的介绍处有几个使用实例。

这个指令会在原位插入编号为编号的变量的内容。在读取前这个变量必须先被赋值。

在这个例子中，三个Track.FreeObj指令都使用同样的随机数值，所以这三个物体会被放在同一条随机的轨道边。如果使用三个$Rnd(3;5)而不是$Sub，这三个物体可能被单独放在不同的轨道边。

$If(如果……那么)指令让游戏只在这个条件成立，即为非零值时才解析下面的线路指令。$If的后面必须有一个$EndIf。在$If和$EndIf之间也可以加一个$Else来表示条件是不成立的时要解析的指令。

$Else(否则)指令只在前面的$If的条件是不成立的时才解析下面的线路指令。

$EndIf指令标识前面的$If指令的影响范围到此结束。

可以嵌套$If指令。如果把$If/$Else/$EndIf放在不同的几行上，可以更清晰地表示块结构并使它更易读（例如第一个例子）。

最后，当预处理结束，线路中的所有指令都会被按照轨道位置重新排序。

经过预处理之后(假设随机结果是3):

最后被按照顺序重新排序:

■ 4. Options (选项) 命名空间

这个命名空间里的指令设置一些基本设置，并影响其他指令的实际处理效果。所以应当在开始编写写其他指令之前先使用这些指令把设置都调整妥当。

这个指令可以被用来改变其他指令使用的长度单位。当和形如部分₁:部分₂:…:部分_n的主轨道位置一起使用时，部分_i会被乘上系数_i，以此类推，真正的主轨道位置是所有积的和。更改了长度单位时，您也应同时使用 Options.BlockLength 将区间块长度也设为相应单位。

换算系数的几个示例：

在下面的示例中，会被Options.UnitOfLength影响的指令参数将被用绿色表示。

这个指令可以被用来改变其他指令使用的速度单位。换算系数的几个示例：

在下面的示例中，会被Options.UnitOfSpeed影响的指令参数将被用蓝色表示。

这个指令可以设置区间块的长度。这是个全局设置，一旦设置就不能来回更改。如果Options.UnitOfLength在该指令前被调用过，长度会使用Options.UnitOfLength作为单位。

▸ 模式的可选项：

▸ 模式的可选项：

▸ 模式的可选项：

▸ 模式的可选项：

▸ 模式的可选项：

▸ 模式的可选项：

■ 5. Route (路线) 命名空间

这个命名空间里的指令设置一些线路的基本信息。

▸ 模式的可选项：

用这个指令来设定信号状态所允许的最大通过速度。状态0代表前方没有区间空闲（红灯），1代表1个区间空闲，以此类推。默认值（根据默认的日式信号系统设置）是：

该指令创建几辆和玩家在同一轨道上的AI车。这些列车可见，正常工作，且使用和玩家一样的列车模型。其他列车使用和玩家相同的时刻表，但是发车时间和玩家列车有着间隔_i的时间差。通过Track.Sta指令，可以为玩家和AI车指定不同的停车站。在玩家列车之后的车辆只会在区间里没有列车时出现，但玩家列车不论是否已经有列车阻挡位置都会被放置。所以，应当正确设置在玩家之前发车的AI车的发车时间，使玩家进入游戏时该列车已经离开玩家要出现的轨道区域。

该指令可以改变关于速度的信息（例如超速提示）中使用的单位。

该指令可以自定义加载界面的背景图。

该指令可以定义玩家进入游戏时的时间。

该指令可以被用来替代Route.AmbientLight，Route.DirectionalLight和Route.LightDirection。

它允许根据时间改变光照，具体细节在这一页上说明：

Dynamic Lighting

该指令指定漫射环境光的颜色。这个光照亮场景中所有物体的所有面。

该指令指定定向照射光的颜色。只有物体的迎光面会被照亮，背光面不受影响。应配合Route.LightDirection使用，设定光照方向。

该指令定义相对于主轨道位置0的定向光照射方向。这是光照亮区域的计算方向，和光源（太阳）的方向正好相反。首先，θ 倾斜角定义光照仰角。90代表垂直向下，-90代表竖直向上，在这两个极值处φ就不影响位置。 θ值为0时代表从地平线后方水平向前照射。φ 方位角表示一个旋转方向。φ为0代表从前方，90为从正右，-90为正左。分别设置θ和φ为(180,0)或(0,180)都代表从后方照射。通过调节这两个数值，可以精确地控制光照的方向。

将球面坐标(θ,φ)换算为直角坐标(x,y,z)的公式：

cos(x) 代表余弦，
sin(x) 代表正弦，
arctan(x) 代表反正切，
arctan(x,y) 代表双变量反正切，
sqrt(x) 代表平方根。
如果更喜欢使用直角坐标的话，可以使用这些公式来进行转换。
这几条公式也作为定向光功能的数学证明（三角函数使用弧度制）。

该指令允许自定义游戏开始时的视角。

该指令只被BVE4等使用，openBVE忽略这一指令。

■ 6. Train (列车) 命名空间

这个命名空间里的指令指定线路使用的列车。

列车开发者会为他的列车设定一些在特定轨道种类上的运行时的声音。使用该指令来为轨道类型分配列车走行音。由于走行音编号是由列车开发者指定的，所以需要和列车开发者合作协调，来确保为正确的轨道类型使用相应的走行音。这里有一个编号标准，但使用得并不很广泛。

列车开发者会为他的列车设定一些在特定轨道种类上的轮缘摩擦声。使用该指令来为轨道类型分配轮缘摩擦声。由于轮缘摩擦声编号是由列车开发者指定的，所以需要和列车开发者合作协调，来确保为正确的轨道类型使用相应的轮缘摩擦声。这里有一个编号标准，但使用得并不很广泛。

用该指令来加载被照亮的时刻表图片。使用Track.Sta命令可以指定在哪站使用哪张时刻表图片。

用该指令来加载暗光照下的时刻表图片。使用Track.Sta命令可以指定在哪站使用哪张时刻表图片。

该指令设定的是额外限速，具体限速仍然受Track.Limit限制。玩家驾驶的列车不受影响，仍然可以一直加速到Track.Limit。

该指令已过时。OpenBVE忽略该指令。

该指令已过时。OpenBVE忽略该指令。

■ 7. Structure (结构) 命名空间

这个命名空间里的指令用来载入在后面的其他指令中要用到的物体模型。总体来说，像Track.Rail、Track.FreeObj之类的命令通过结构编号来指定要使用的物体。这个结构编号对于这个指令是特定的，所以应当先载入要使用的模型。要使用哪个指令，要使用哪个模型，就把它们载入，不需要的就不用载入。

这个命名空间中的指令基本上都是以下这个结构：

结构编号是一个非负整数。文件名是一个相对于Object文件夹的路径，指向要加载的模型文件。类型是以下几种之一：

通常支持的物件有 B3D、CSV、X 和 ANIMATED。 但是，FormCL、FormCR、RoofCL、RoofCR、CrackL 和 CrackR 命令只接受 B3D、CSV 和 X 物件。

➟ 关于Forms, Roofs, Cracks的更详尽说明…

此外，还有 Structure.Pole 命令，它的语法略有不同：

特别提示：除FreeObj之外的物体都是在区间块的开始位置被放置的，因此这些模型在建模时尺寸应当保证整个物体头尾的Z坐标伸展区域（放置时朝轨道前方的方向即Z轴正方向）在0~ *区间块长度 *（默认值为25m）之间（这样保证正好盖住整个区间块，否则出现空隙或相互重叠）。在Track命名空间中对应命令处有更详细的解释.

■ 8. Texture（材质）命名空间

这个命名空间中的指令指定要使用的天空背景图像和它对齐的方式。

背景图片被贴在一个环绕着游戏主视角摄像机的圆柱形墙上，从相对于初始前视角方向左偏60°（即十点钟方向）开始，将指定的这张图片重复平铺到Texture.Background(背景材质编号).X指令指定的次数（默认为一圈重复六次）。

图片的上方四分之三显示在地平面之上，下方四分之一显示在地平面之下。 通过Texture.Background(背景材质编号).Aspect指令，可以选择圆柱体的高度是固定的还是根据图片宽高比自动适应的。如果选择固定高度，圆柱体的高度将是其半径的二分之一，即图片上边缘位于20°视角，下边缘位于-7°视角。如果选择保持图片宽高比，这就不但计算图片宽度和高度，还将参考重复次数计算圆柱高度。

不论需要重复几次，都要保证传入的这张图片在重复时左右边缘可以完美贴合。圆柱的顶面和底面材质是按照图片最上方和最下方的十分之一来计算决定的。因此应尽量避免图片最上方十分之一有高山山峰等物体，否则它们会跑到顶面上去。

除非主轨道位置开头的Track.Back指令应用了一张不同的背景图，Texture.Background(0)的图像会在线路的开头被默认使用。

也可以使用动态或基于模型的背景。这个页面详细描述了如何使用这一功能：

Dynamic & Object Based Backgrounds

该指令加载用于Track.Back指令的背景图像。

▸ 模式的可选项：

■ 9. Cycle (循环) 命名空间

当平常使用Track.Ground(地面模型编号)指令时，选定的模型每个区间块都被重复一次。但是通过Cycle.Ground指令，在使用Track.Ground(地面模型编号)时可以把它改成几个不同模型循环出现。这个循环无限重复，地面模型编号0从主轨道位置0开始。从技术角度来说，对于一个特定的主轨道位置p计算出的地面模型编号_i中的i是Mod[p/区间块长度, n]（P ÷ 区间块长度 Mod n）。

以这一定义为例：

这两组代码效果相同：

■ 10. Signal (信号) 命名空间

这个命名空间内的指令用来加载自定义信号机。

用该指令来直接加在一个动画模型文件作为信号机。信号机编号可以在使用Track.SigF命令放置这类信号机时使用。

该指令加载的信号机切换是通过给同一个模型糊上不同的材质实现的。openBVE按顺序搜索X、CSV、B3D……模型。材质的名字需要是“[模型名字不带扩展名]+[状态编号]+.[扩展名]”这样一个格式。信号机编号可以在使用Track.SigF命令放置这类信号机时使用。

举个例子来说，对于不带扩展名的基座模型文件，应该有大概这样的一些文件：

基座模型文件.csv
基座模型文件0.bmp
基座模型文件1.bmp
基座模型文件2.bmp
基座模型文件n.bmp

从0到n的这一串状态表示中，数值越大表示前方空闲区间越多，允许速度越快。0代表红灯。举个例子来说，内置的信号机是这样规定的：0 (●), 1 (●●), 2 (●), 3 (●●), 4 (●) 还有 5 (●●)。可以按照线路信号系统的实际情况增减设置。

文件里的材质指定指令会被忽略，所有面都会被糊上这个同样的状态材质。这表示不能在这个模型里使用一个以上的材质文件（甚至都不能指定），只需要正确地设置材质顶点坐标即可。对于发光模型也是一样的规则。发光模型一般来说是放在信号机前面的一个大方块（虽说也可以用其他的形状，但是由于一般大家都使用透明材质，所以这并没有什么用）。

发光模型材质的处理方法真的值得特别注意。发光模型材质是按照以下的步骤预处理的：

A	B	C	D	E	F

用作发光材质的图像一般来说应该是椭圆的并且应该有一个锐利的边缘。图形的中心应该完全饱和，并在其外缘加入纯白色。图形的外边既可以是纯黑 (A) 也可以是纯白 (B)。

当openBVE加载这个发光材质时，它会把所有纯黑颜色都换成纯白颜色，变成 (B) 的样子。之后，图像会被反色 (C)，然后进行180°的色调偏移 (D) 。比起 (B) 来说，这使整幅图像的亮度反转，即满饱和的颜色不会被改变（例如中心），亮颜色（例如图形外框）将会变暗，反之亦然。然后，将会进行亮度校正使暗部更暗 (E)，最后再稍稍加上一点模糊效果 (F)。

结果所得到的材质是被叠加混合的。这意味着不是直接在屏幕上覆盖性地绘制材质，而是将材质的颜色以RGB通道值相加的方法叠加在屏幕像素上。加上黑色不会改变原有颜色，而加上完全饱和的颜色就会覆盖原有颜色。例如，加上白色就会得到白色。在设计材质时，请牢记这个处理过程，并遵循它的逆规则。一定要设计出 (A) 或 (B) 这样的图像。

■ 11. Track (轨道) 命名空间

这个命名空间中的指令定义了轨道的布局。这个命名空间内的指令应该出现在所有其他指令之后，一般位于线路文件的最后部分，且代码量基本都要远超其他部分。

● 11.1. 轨道

该指令开始一条由轨道编号代表的新轨道。当使用该指令时，轨道编号必须是没有被占用的（没有使用过或已经被Track.RailEnd指令声明结束）。X、Y和轨道类型的默认值是0，除非这个编号已被占用（不应该这样做）的情况下维持该轨道上次的原值。该指令只用于开始轨道。如果需要更新它的位置，应当使用Track.Rail指令。如果需要结束它，使用Track.RailEnd指令。 在同一位置先终止一条轨道再开始同样编号的新轨道是允许的。每个区间块中都会根据轨道类型自动放置一个对应的轨道模型。

该指令开始一条轨道或更新一条轨道的位置或类型。轨道编号代表要执行操作的轨道。在该轨道编号已存在轨道的情况下X,Y,轨道类型默认维持该轨道上次的原值，否则若未给出，默认值为0。如果需要结束它，使用Track.RailEnd指令。在同一位置先终止一条轨道再开始同样编号的新轨道是允许的。在每一个区间块中，如果没有Track.Rail指令执行更新，X和Y值都会保持上一个区间块的同样值。所以，更新X或Y值只会影响前方区间块的轨道形态。改变轨道类型将会改变从指令生效位置开始的轨道类型。如果试图在同一位置反复对同一条轨道进行多次修改，只有第一条指令会起作用，之后的将会被全部忽略。

该指令改变由轨道编号代表的一条已存在轨道的类型。该轨道必须已经被Track.RailStart或Track.Rail指令创建且还没有被Track.RailEnd指令结束。轨道类型的更改将从该指令生效时的轨道位置开始。

该指令结束由轨道编号代表的一条已存在轨道。X和Y的默认值是该轨道上次的原值。一旦该指令执行，该轨道就会在这一点结束，并在之后视为不再存在。轨道模型不会再继续被放置。

在这个例子中：1号轨道在1000米位置位于主轨道右侧3.8米处开始，使用类型0（这个线路中加载为直线轨道）；在1025米处轨道模型被换为1（加载的一个向左的S型曲线，让它在25米内左偏1.9米，以和下面轨道位置的改变正好对接）；在1050米处轨道被内移至主轨道右侧1.9米处，正好和先前的S型曲线对上，并重新换回直道类型；轨道在1075米处终止，并且在终止时仍旧在主轨道右侧1.9米处。

该指令设定之后轨道的精度，影响晃动效果和一些物理计算。精度系数需要在0~4之间，超出这个范围的数会被截取到0或4两个值。0代表理想的轨道（没有任何不平），1代表很好的轨道（高速铁路标准），2代表较好的轨道，3代表一般的轨道，4代表较差的轨道。

该指令设定之后轨道的附着系数。这会影响车轮打滑等物理计算。作为参考，干燥轨面大约是135，湿滑轨面大约是70，降雪轨面大约是50。如果附着系数是0，意味着轨面完全理想光滑，列车车轮将一直打滑，根本不可能移动。

This command sets the intensity of the current rainfall, and the weather object to be shown.

This command sets the intensity of the current snowfall, and the weather object to be shown.

● 11.2. 几何变换

该命令改变之后所有轨道的坡度。正值代表上坡，负值代表下坡。0代表平路。坡度可以根据在水平距离米内上升（下降为负）垂直高度米来计算：

该指令使所有轨道从这一位置开始转弯，并指定转弯的半径。正半径代表向右转弯，负半径代表向左转弯。0代表直道。超高以毫米指定弯道的超高。对于该数值正负值的含义，请参见Options.CantBehavior。如果它是0(默认)，超高的设定值将被取绝对值，并向弯道内侧倾斜，同时在直道上不采取超高；如果它是1，超高的符号将被考虑，正数向内倾斜，负数向外倾斜，同时在直道上也会采取超高，负值向左，正值向右。

该指令使轨道在指令插入位置做一个弯折。斜率可以根据在纵向距离米转向横向距离米来计算：

正值代表右转，负值代表左转，0代表直道。

该指令告诉游戏在特定位置地面应当距离主轨道下方的距离。它影响通过Structure.Ground和Track.Ground载入和选定的地面模型的放置位置。由于默认的位置0代表轨道的上表面（我想您应该并不希望地面被糊在轨道上面而不是衬在下面），您应该把它设置为一个合适的正值。在相邻的Track.Height之间，高度值被平滑细分以使地面过渡平滑。 例如，以下两段代码是等效的：

● 11.3. 物件

该指令在指定轨道旁放置一个“自由”的外景物体。在放置前需要先用Structure.FreeObj载入模型。

▸ 方向的可选项：

该指令开始或更新一条轨道两侧的墙壁。在放置前需要先用Structure.WallL以及Structure.WallR载入模型。直到使用Track.WallEnd结束墙壁，对应的墙壁模型会在每个区间块的开始处被不停放置。请注意墙壁是和轨道对应的，这意味着如果先前设定了墙壁，在结束轨道然后重新利用这一相同轨道编号时墙壁依然会被继续放置。

该指令停止在一条轨道两侧放置墙壁模型。该指令从它的位置即刻生效。

▸ 方向的可选项：

该指令开始或更新一条轨道两侧的路堤。在放置前需要先用Structure.DikeL以及Structure.DikeR载入模型。直到使用Track.DikeEnd结束路堤，对应的路堤模型会在每个区间块的开始处被不停放置。请注意路堤是和轨道对应的，这意味着如果先前设定了路堤，在结束轨道然后重新利用这一相同轨道编号时路堤依然会被继续放置。

该指令停止在一条轨道两侧放置路堤模型。该指令从它的位置即刻生效。

该指令开始或更新一条轨道两侧的架线柱。在放置前需要先用Structure.Pole载入模型。架线柱被放在每一个轨道位置是间隔的倍数的区间块开始位置（这就是为什么可能发现指令的执行位置处并没有一个架线柱）。如果额外轨道跨度值是0，位置指定放置的方向。如果位置小于或等于0，模型被按原样放置（对应左侧架线柱）。如果位置大于0，模型会被在X轴向反转180°后放置（对应右侧架线柱）。如果额外轨道跨度值大于等于1，位置指定以3.8米的倍数的放置位置的水平位置。请注意架线柱是和轨道对应的，这意味着如果先前设定了架线柱，在结束轨道然后重新利用这一相同轨道编号时架线柱依然会被继续放置。

该指令停止在一条轨道两侧放置架线柱模型。该指令从它的位置即刻生效。

该指令将一个物件缩放拉伸，以填补轨道之间的空隙。

注意:
如果 轨道编号₁ 处于 轨道编号₂ 的左侧（即：其X坐标更小），则使用Structure.CrackL定义的物件，否则使用CrackR。

该指令设定从这一点开始被放置的地面模型。地面模型总是被放在主轨道下方的一段距离（由Track.Height指定）。如果能查找到定义为地面模型编号的循环模型(Cycle.Ground)，则优先使用；如果没有，则使用普通模型(Structure.Ground)。

● 11.4. 车站

▸ 到达时间的可选项：

▸ 发车时间的可选项：

▸ 停车铃的可选项：

▸ 开门方向的可选项：

▸ 强制红灯的可选项：

▸ 信号系统的可选项：（由于BVE是日本的模拟游戏所以原装只支持日式信号系统）

该指令设定一个新车站。在编写指令时，该指令应该被放置在车站站台的开始处。其后（到下一站之前）的所有Track.Stop指令都被视为和该站有关。如果该站需要停车，该指令后面应该有一个或多个Track.Stop指令指定车站的停车点，以完成车站的定义。

特殊功能：

车站可以被设为“换端车站”。在这样的车站，列车会在满足发车时间后自动被传送到下一站。这个特性可以用来假装列车折返，而不用人工打开菜单跳站。

类似的，车站也可以被设定为”跳站传送“。在这些车站，当到达发车时间，列车就会被传送到指定编号的车站。这样就可以将列车传送到之前的车站，还可以此模拟环线。

▸ 到达时间的可选项：

▸ 发车时间的可选项：

▸ 强制红灯的可选项：

▸ 信号系统的可选项：（由于BVE是日本的模拟游戏所以原装只支持日式信号系统）

该指令早已过时，请不要使用该指令（它连开门方向都指定不了）——请使用包含更多选项的Track.Sta代替它。
该指令创建一个新站。对于它没有提供的参数，默认采用以下值：

该指令设定一个新车站。在编写指令时，该指令应该被放置在车站站台的开始处。其后（到下一站之前）的所有Track.Stop指令都被视为和该站有关。如果该站需要停车，该指令后面应该有一个或多个Track.Stop指令指定车站的停车点，以完成车站的定义。

车站可以被设为“换端车站”。在这样的车站，列车会在满足发车时间后自动被传送到下一站。这个特性可以用来假装列车折返，而不用人工打开菜单跳站。

▸ 方向的可选项:

This command places a stop point for the last created station. If there is more than one stop defined for a station, the following rules are evaluated in order:

1. If a stop point is defined with the exact number of cars in the train, this will be used.
2. If an all cars stop is defined, this will be used.
3. If no stop points are defined with a matching number of cars, the stop point with the closest greater number of cars will be used.
4. If no stop points have a greater number of cars, the first stop point will be used.

▸ 轨道编号₂ 的可选项：

注意:
如果 轨道编号₁ 处于 轨道编号₂ 的左侧（即：其X坐标更小），则使用Structure.FormL, Structure.FormCL 与 Structure.RoofL定义的物件，否则使用FormR, FormCR与RoofR。

● 11.5. 信号与限速

▸ 标牌位置的可选项：

▸ 方向的可选项：

该指令设定从该点开始的速度限制。如果新限速低于原限速，限速将立刻起效；如果新限速高于原限速，限速会在整列列车全部通过标牌之后起效。将限速设为0将解除限速。将标牌位置 设为-1或1会在轨道的对应一侧放置一个默认的日式限速标牌。将方向设为-1或1会给标牌加上方向显示，用来指示该标牌与道岔方向的关系。速度设为0的解除限速标牌从来都不会有方向显示。

该指令开始一个自动闭塞区间。这是真正设置自动闭塞系统使其工作的指令，一般和放置显示自动闭塞系统状态的信号机的Track.SigF指令一起使用。状态_i指定区段传递给信号机的一个信号状态。状态0代表不可有列车通过的红灯，越大的值代表前方清空的区间越多，代表列车可以以更快的速度通过。必须指定状态₀。

默认解读方式： 状态_i指定当前方有i个区间清空（无车）时应该传达给信号机的信号状态。状态被按照书写顺序读入和匹配。但是，如果需要信号机在多种情况下显示相同信息，是可以给多种情况设定相同的信号状态的。

▸ 状态_i的意义：

如果前方有比_n个还要多的清空的区间，最后一个状态_n状态会被传给信号机。

简化解读方式：
状态_i指定这个信号区段会传达给信号机的所有状态。当前方有x个被清空的区间时，被传达给信号机的信号状态就是所有状态_i状态从小到大排的第x个。如果x比状态_i状态的总数还要多，最大的一个状态_i状态会被传给信号机。状态的顺序无关紧要，重复出现的值只会被留下一个。 译注：我是没感觉这怎么简化了……

这是Track.Section与Track.SigF一同使用的方法例子：

该指令放置一个信号机，显示一个由Track.Section指令设定的自动闭塞区间的信号状态。如果将垂直位置设为负值（信号机怎么会遁地呢，是不？），这个值会被重设为4.8米，并在后方放置一个默认的架线杆，来代表有个杆的信号机（如果认为默认架线杆太丑或高度有问题，也可以通过在自定义信号机模型里面给它手动加个杆来达到这个效果）。另参见Track.Section。

在没有自定义相应的Signal(信号机编号)的情况下，可以使用这些默认的日式信号机：

▸ 信号机编号的默认信号模型：

▸ 类型的可选项：

2：一个A型两灯式信号机，有●红和●黄两种状态。
-2：一个B型两灯式信号机，有●红和●绿两种状态。
3：一个三灯式信号机，有●红、●黄和●绿三种状态。
4：一个A型四灯式信号机，有●红、●●双黄、●黄和●绿四种状态。
-4：一个B型四灯式信号机，有●红、●黄、●●黄绿和●绿四种状态。
5：一个A型五灯式信号机，有●红、●●双黄、●黄、●●黄绿和●绿五种状态。
-5：一个B型五灯式信号机，有●红、●黄、●●黄绿、●绿和●●双绿五种状态。
6：一个六灯式信号机，有●红、●●双黄、●黄、●●黄绿、●绿和●●双绿六种状态。

该指令在设置自动闭塞区间的同时放置一个信号机。可以指定状态类型来选择创建任何一种默认日式信号机。如果将水平位置设为0（信号机怎么会搁在轨道正中间呢，是不？），将不会放置信号机，只会设置自动闭塞区间，这和Track.Section的行为有点类似。如果将水平位置设为非零，且垂直位置设为负值（信号机怎么会遁地呢，是不？），这个值会被重设为4.8米，并在后方放置一个默认的架线杆，来代表有个杆的信号机。

Track.Signal和把Track.Section以及Track.SigF一起用有点像。使用Track.Signal更方便，不过，使用Track.Section和Track.SigF可以允许放置自定义信号机，并控制设定更多的参数。

该指令创建一个默认的日式中继信号机。这个信号机一般放在弯道等直线能见度不好的地方，显示与前方下一个信号机相同的信号状态，来让列车驾驶提前注意。如果将水平位置设为0（信号机怎么会搁在轨道正中间呢，是不？），将不会放置信号机，只会设置自动闭塞区间，这和Track.Section的行为有点类似。如果将水平位置设为非零，且垂直位置设为负值（信号机怎么会遁地呢，是不？），这个值会被重设为4.8米，并在后方放置一个默认的架线杆，来代表有个杆的信号机。

● 11.6. 车载信号系统

该指令放置一个有源应答器。使用的模型需要通过Structure.Beacon(BeaconStructureIndex)预先加载。当列车通过它时，它会把类型、关联区间的信号状态、还有一堆其它信息全部发给车载信号系统接收器。

需要注意，由于Track.Beacon(类型)和Track.Transponder(类型)是大致相同的，游戏内置的车载信号系统也会接收Track.Beacon的发信。所以，如果要自行编写ats.dll插件，请尽量避开游戏内置车载信号系统已经使用的标号，避免误发信息，造成混乱。详情参见应答器类型标准。

▸ 类型的可选项：

0：一个ATS-S的S 型发信器，一般放在信号机前600米。
1：一个ATS-S的SN型发信器。一般放在信号机前20米。
2：一个误发车防止型发信器，一般放在车站停站点后。
3：一个ATS-P的更新发信器，一般根据轨道限速等情况放在信号机前600m、280m、180m、130m、85m和50m处。
4：一个ATS-P的停止发信器，一般根据轨道限速等情况放在信号机前25m或30m处。

▸ 关联信号机的可选项：

▸ 自动系统切换的可选项：

该指令放置一个为内置的ATS-SN或ATS-P信号系统使用的有源应答器。请参见ATS系统用户指南来了解ATS系统和它的应答器的工作原理。

需要注意，由于Track.Beacon(类型)和Track.Transponder(类型)是大致相同的，游戏内置的车载信号系统也会接收Track.Beacon的发信。所以，如果要自行编写ats.dll插件，请尽量避开游戏内置车载信号系统已经使用的标号，避免误发信息，造成混乱。详情参见应答器类型标准。

➟ 此处了解更多关于ATS-SN和ATS-P的信息

➟ 这是一篇讲到如何在实际的路线开发过程中使用这五种应答器来正确设置日式ATS-SN与ATS-P信号系统的教程

该指令放置一个ATS-S的S型发信器，关联前方第一个信号机，且自动切换系统。它等同于Track.Tr 0;0;0。

该指令放置一个ATS-P的更新发信器，关联前方第一个信号机，且自动切换系统。它等同于Track.Tr 3;0;0。

▸ 类型的可选项：

该指令为内置的ATS-P系统设定一个限速，使它自动控制速度，防止列车超速。

当一个点限速(类型为0)被插入在要应用的地方，ATS-P会提前了解这个限速的位置，并提前减速列车使列车通过这一点时速度正好在限速之下。一旦列车通过限速点，速度限制就不再有效，列车将会重新加速。

当一个段限速(类型为1)被插入在应用的地方，ATS-P不会提前了解这个限速的位置，只会从这个位置开始减速列车。为了尽量真实，请把限速设定和ATS-P发信器放在一起。段限速则会被ATS-P记忆并保持，并且直到下一个段限速重新设定才会解除。

该指令设定一个段限速，等同于Track.Pattern 1;速度。

● 11.7. 杂项

该指令指定从当前位置开始要显示的背景材质。

该指令可以启用、更新或停用雾效果。如果需要启用雾，起始近距离必须小于终止远距离。如果需要停用雾，只需将起始近距离设得大于等于终止远距离。

雾效果影响物体绘制的颜色。在起始近距离以内的物体颜色保持原样，在终止远距离外的物体颜色和雾颜色完全相同，在两个位置中间的物体颜色是线性平滑渐变的。雾也会影响背景图像。不论实际情况如何，在计算时背景图像都会被假定距离摄像机600米远。

根据Options.FogBehavior的设定，雾的处理方式会有所不同。详情见上。基于区间块模式下，雾的颜色和范围从原先Track.Fog设置时的区间块的到新Track.Fog设置时的区间块以线性插值平滑过渡；线性插值模式下，雾的颜色和范围从两次Track.Fog调用的位置之间线性插值平滑过渡。这和Track.Brightness的效果类似。

该指令控制驾驶台的照明亮度情况。亮度值按照0（黑暗）到255（明亮）测算，并在连续的Track.Brightness指令之间平滑渐变。只要是会影响驾驶室内的亮度的地方（例如隧道、桥梁、车站顶棚、等等，尤其注意隧道灯和顶棚房梁的处理，虽然十分繁琐，但是能大大提高真实度），都应该使用这条指令来进行微调。

▸ 持续距离的意义：

这条指令显示一个所谓的标识图片在屏幕的右上角。可以把它用来传递建议或信息。图片中颜色是 [64,64,64]，即#404040的像素点会被绘制为透明的。

也可以使用一个使用XML文件的Track.Marker指令。 这提供比起原来的标识图片来说更加复杂可控的行为。

请参见 XML标记指南

▸ 持续距离的意义：

▸ 字体颜色的可选项：

这条指令创建一个简单的文字标识，和其他信息一样显示在屏幕左上角。

这条指令创建一个用户可以使用CAMERA_POI_PREVIOUS（小键盘1）或CAMERA_POI_NEXT（小键盘7）跳转的一系列在轨道旁边的可能比较有意思的观察点。摄像机会被按照指定的方向放在指定的位置。如果设置了文字描述，在跳转时它会被显示，让玩家更好的了解这里是哪儿，为什么这里有意思。

这条指令为一列不可见的列车指定它在固定时间要到达的地点，来影响自动闭塞信号显示。与Route.RunInterval来对比，该指令创建的隐形现行列车只是为了影响信号而已，并且可以指定它到达固定地点的特定时间。先行列车不会开倒车(EZY)，也不会做时空穿越，所以时间和位置必须是升序指定的，即不可以让它在更早的时间到达更远的位置，因为这明显违反了客观的物理定律。在第一个指定的时间之前，这列不可见列车留在起始位置。在第一个和最后一个指定的时间之间，这列不可见列车线性（即没有加减速的曲线变化）地在指定的位置之间移动。在最后一个指定的时间之后，这列不可见列车立刻消失，并清空它影响的所有区间。

该指令在玩家驾驶的列车通过该点时在驾驶台中播放一个声音。如果参考速度被设为0（默认），声音被原样播放（例如车内广播）。如果给出了参考速度，声音在列车速度等于参考速度时原调播放，在其他速度情况下按速度变调（例如自定义的轮缘摩擦声、道岔撞击声）。

这条指令在对应位置放置一个环境声音（例如平交道口警报器）。这个声音会被无限重复播放，并具有真实的多普勒效果。（请注意：openBVE中的所有声音都有多普勒效果）

该指令创建一个不可见的缓冲器，用来停住列车。列车可以从从前后双向撞上它。在线路的开始和结束处都放上这个指令，以防止玩家驾车出图。该指令并不会放置可见的物体，所以如果必要，使用Track.FreeObj放置一个可见的实际代表物体。

这条指令设定一个特殊的无源应答机，设定列车的目的地属性变量，并影响支持这个功能的车载信号系统插件和动画外饰物体。要使用的模型需先通过Structure.Beacon(BeaconStructureIndex)载入。

This command places a special beacon, which commands an AI driver to play the horn. Both an AI controlled player train and pure AI trains will trigger this beacon, unless TriggerOnce is set. The object must have been loaded via Structure.Beacon(BeaconStructureIndex) prior to using this command.

该指令可以被用来替代Route.AmbientLight，Route.DirectionalLight和Route.LightDirection。

它允许根据时间改变光照，具体细节在这一页上说明：

Dynamic Lighting

This command defines the ambient light color to be used from this point onwards. All polygons in the scene are illuminated by the ambient light regardless of the light direction.

This command defines the directional light to be used from this point onwards. 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.

This command defines the light direction from this point onwards. 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.

将球面坐标(θ,φ)换算为直角坐标(x,y,z)的公式：

cos(x) 代表余弦，
sin(x) 代表正弦，
arctan(x) 代表反正切，
arctan(x,y) 代表双变量反正切，
sqrt(x) 代表平方根。
如果更喜欢使用直角坐标的话，可以使用这些公式来进行转换。
这几条公式也作为定向光功能的数学证明（三角函数使用弧度制）。