openBVE Documentation

このページでは、OpenBVE1.6.0以降で実装されている XMLベースの Track Following Object の原理とその実装方法について説明します。

■ 基本原則

openBVEでは自由に他の線路にTrack Following Objectを走らせることができます。

これを行うには、Track Following ObjectのXMLファイルを使用して走らせる各オブジェクトを設定する必要があります。以下に例を示します。

この例では、オブジェクトは次のように走ります。

ゲーム内時間 00:01:00が経過し、ゲーム内のプレーヤーのカメラ位置から50mから100m以内にオブジェクトが存在する場合に表示されます。表示してから5分経過すると非表示になります。外観は、7両編成で、extensions.cfgで定義されています。
ゲーム内の距離 200mで、右側のドアが20秒間開かれた後、オブジェクトはRail2で1.71km/h/sの加速度で30 km/hに加速します。
Rail2を時速60kmで400mを走行します。
オブジェクトはRail2で1.71km/h/sで30km/hに減速し、ゲーム内距離1000mに達すると、停止して両側のドアを開きます。 10秒間停止した後、Rail1では1.71 km/h/sの加速で、30 km/hに逆方向に加速します。
オブジェクトはRail1で1.71km/h/sで30km/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>

ご覧のとおり、ファイルは1つの**<Definition>**セクション、1つの**<Car>**セクション、および1つの**<Stops>**セクションで構成されています。 **<Stops>**セクションは、2つ以上の**<Stop>**セクションで構成されます。

■ Definition属性

<AppearanceTime> 時間 </AppearanceTime>

時間は、オブジェクトがゲームに表示される時間を設定します。

注: このパラメーターを省略すると、オブジェクトはゲームの開始から出現します。

<AppearanceStartPosition> 位置 </AppearanceStartPosition>

位置には、オブジェクトが表示され始めるゲーム内の距離を設定します。プレイヤーの列車がこのポイントを通過すると、オブジェクトが表示されます。単位はメートルです。

注: このパラメーターを省略すると、オブジェクトはゲームの開始から出現します。

<AppearanceEndPosition> 位置 </AppearanceEndPosition>

位置には、オブジェクトが非表示になるゲーム内距離を設定します。プレイヤーのカメラ位置がこのポイントを通過すると、オブジェクトは非表示になります。また、<AppearanceStartPosition>に指定された値よりも大きくする必要があります。単位はメートルです。

注: このパラメーターを省略すると、オブジェクトはゲームの開始から出現します。

<LeaveTime> 時間 </LeaveTime>

時間には、オブジェクトがゲームに表示されてから消えるまでの時間を設定します。この時間を過ぎると、オブジェクトは非表示になります。この値はゲーム内時間ではありません。

注:このパラメーターを省略すると、オブジェクトはゲームが終了するまで、または<AppearanceEndPosition>**によって非表示になるまで表示されたままになります。

■ Train属性

<Directory> パス </Directory>

パスには、オブジェクトのtrain.dat、sound.cfg、extensions.cfgを含むディレクトリへの相対パスを設定します。

注: trainフォルダーがAI専用である場合、train.datファイルの名前はtrain.aiに変更できます。

<Reversed> true </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コマンドで軌道を定義する必要があります。