openBVE Documentation

本页说明了openBVE v1.6.0或更高版本中支持的基于XML的轨道循迹物件 TFO 的原理和实现。

■基本原则

轨道循迹物件可在主轨道以外的其他轨道上自由运动。

为此，必须为每一个物件使用XML文件设置其运动方式。一个例子如下所示。

在此示例中，这一物件以下述方式运动：

当游戏内时间到达00:01:00之后，且该物件位于游戏中玩家位置50 m至100 m之内时，该物件就会出现，并在显示5分钟后消失。这一物件的外观是7节编组列车，在对应的extensions.cfg中定义。
在游戏中距离200m，右门打开20秒，然后该物件在 Rail2 上以1.71km/h/s的加速度加速至30 km /h。
它在 Rail2 上以60 km/h的速度行驶400 m。
在 Rail2 上，该物体以1.71 km/h/s的速度减速至30 km/h，当它在游戏中达到1000m的距离时，这一列车物件会停止并打开两侧的门。停止10秒钟后，它在 Rail1 上以1.71 km/h/s的速度反向加速至30 km/h。
该物件在 Rail1 处以1.71 km/h/s的速度减速至30 km/h，停止并在主轨道位置200m处打开右门。

<?xml version="1.0" encoding="utf-8"?>
<openBVE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <TrackFollowingObject>
    <Definition>
      
      <AppearanceTime>00.0100</AppearanceTime>
      
      <AppearanceStartPosition>50</AppearanceStartPosition>
      
      <AppearanceEndPosition>100</AppearanceEndPosition>
      
      <LeaveTime>00.0500</LeaveTime>
    </Definition>
    <Train>
      
      <Directory>TrainDirectory</Directory>
    </Train>
    <Stops>
      
      <Stop>
        
        <Decelerate>0.0</Decelerate>
        
        <StopPosition>200</StopPosition>
        
        <Doors>1</Doors>
        
        <StopTime>00.0020</StopTime>
        
        <Accelerate>1.71</Accelerate>
        
        <TargetSpeed>30</TargetSpeed>
        
        <Direction>1</Direction>
        
        <Rail>2</Rail>
      </Stop>
      
      <Stop>
        <Decelerate>0</Decelerate>
        <StopPosition>400</StopPosition>
        <StopTime>00.0000</StopTime>
        <Accelerate>0</Accelerate>
        <TargetSpeed>60</TargetSpeed>
        <Direction>1</Direction>
        <Rail>2</Rail>
      </Stop>
      
      <Stop>
        <Decelerate>1.71</Decelerate>
        <StopPosition>1000</StopPosition>
        <Doors>B</Doors>
        <StopTime>00.0010</StopTime>
        <Accelerate>1.71</Accelerate>
        <TargetSpeed>30</TargetSpeed>
        <Direction>-1</Direction>
        <Rail>1</Rail>
      </Stop>
      
      <Stop>
        <Decelerate>1.71</Decelerate>
        <StopPosition>200</StopPosition>
        <Doors>R</Doors>
        <StopTime>00.0030</StopTime>
        <Accelerate>0</Accelerate>
        <TargetSpeed>0</TargetSpeed>
        <Direction>1</Direction>
        <Rail>1</Rail>
      </Stop>
    </Stops>
  </TrackFollowingObject>
</openBVE>

如您所见，该文件由一个 <Definition> 部分，一个 <Car> 部分和一个 <Stops> 部分组成。 <Stops> 部分由两个或多个 <Stop> 部分组成。

■ 定义属性

<AppearanceTime> 时间 </AppearanceTime>

时间设置物件出现在游戏中的时间。

注意： 如果省略此参数，则该物件将从游戏开始时出现。

<AppearanceStartPosition> 位置 </AppearanceStartPosition>

位置设置物件出现区域的起点的游戏内距离。当玩家的列车经过此点时，该物件将出现。单位是米。

注意： 如果省略此参数，则该物件将从游戏开始时出现。

<AppearanceEndPosition> 位置 </AppearanceEndPosition>

位置设置物件出现区域的终点的游戏内距离。当玩家的摄像机位置超过该点时，该对象将被隐藏。它也必须大于被 <AppearanceStartPosition> 指定的值。单位是米。

注意： 如果省略此参数，则该物件将从游戏开始时出现。

<LeaveTime> 时间 </LeaveTime>

时间设置从物体出现在游戏中到消失为止的持续时间。此时间之后该对象将不可见。此值不是游戏时间。

注意： 如果省略此参数，则该物件将保持可见状态，直到游戏结束或被 <AppearanceEndPosition> 隐藏为止

■ 列车属性

<Directory> 路径 </Directory>

Path 设置包含物件列车的train.dat，sound.cfg和extensions.cfg的目录的相对路径。

注意： 如果列车文件夹仅供AI使用，则 train.dat 文件可以被命名为 train.ai 。

<Reversed> 是否反转 </Reversed>

如果将此属性设置为 true ，那么列车的编组将被反转。

■ Stop (停站) 属性

<Decelerate> 减速度 </Decelerate>

减速度设置物件的减速度。单位是 km/h/s 。

<StopPosition> 位置 </StopPosition>

位置设置物件停止位置的游戏距离。单位是米。

<Doors> 开门方向 </Doors>

开门方向设置物件列车打开的车门。有效值为：

L 或 -1 ：左门打开。
N 或 0 ：两扇门均不打开。
R 或 1 ：右门打开。
B ：两扇门都会打开。

<StopTime> 停车时间 </StopTime>

停车时间 设置物件停车的时间。此值不是游戏时间。

<Accelerate> 加速度 </Accelerate>

加速度 设置物件的加速度。单位是 km/h/s 。

<TargetSpeed> 目标速度 </TargetSpeed>

目标速度设置物件加速后保持的速度。单位是 km/h 。

<Direction> 行进方向 </Direction>

行进方向 设置物件行进的方向。有效值如下。

F 或 1 ：物件将向前运动。
R 或 -1 ：物件向后运动。

<Rail> 轨道编号 </Rail>

轨道编号 设置物件运动所在的轨道。必须通过路线文件的 Track.Rail 命令先定义这一条轨道。