AtsEX - ATSプラグイン拡張キット for BVE 5 & 6
ATSプラグインの機能を拡張するプラグインです。今までのATSプラグインではできなかった、新しい表現が可能になります。
入力デバイスプラグイン経由でAtsEXを呼び出す「入力デバイスプラグイン版」、ATSプラグインの要領で車両に組み込んで動作させる「ATSプラグイン版」の2種類を提供しています。
はじめに……ユーザー向けコンテンツ一覧
ダウンロード
AtsEX本体の他、サンプルマップ・車両を同梱しています。
現時点で完成している機能を手軽に試せます。
リリース - automatic9045/AtsEX (GitHub)
インストールガイド公開しました！ NEW
インストールの方法が少々複雑で分かりづらかったため、詳しい説明を公開しました。
こちら→AtsEXインストールガイド
BVE5.8でAtsEX搭載車両を使用したい場合
そのままでは使用できませんが、BVE5.8本体に少しだけ手を加えると動作するようになります。
詳細→BVE5でAtsEXを使用するには
マッププラグインが組み込まれたマップをAtsEX非搭載車両で運転したい場合
入力デバイスプラグイン版の場合
特に車両への加工などは必要なく、そのままの形で動作します。
ATSプラグイン版の場合
車両にAtsEXを搭載すれば動作するようになります。
詳細→準備中 サンプル車両の構成を参照してください。
よくある質問
こちら→よくある質問
以下のコンテンツは開発者向けです
以下のコンテンツはマップアドオン・車両アドオン・ATSプラグイン開発者向けです。
特長
BVEの何もかもを編集可能に
標準機能で提供されているものに加え、走行位置、速度、現在時刻から、駅リストや他列車、先行列車、ストラクチャ、サウンド、BVE本体のフォーム（ウィンドウ）、右クリックメニューまで、
BVEで使用されている幅広いデータや機能を取得・編集可能に拡張します。
かゆい所に手が届く自由度の高さ、何を作るかはあなた次第です。
テクスチャの動的書きかえに対応
zbx1425氏が開発された車両・マップ内のテクスチャを動的に変更できるようにするライブラリ
「DXDynamicTexture for BVE Trainsim 5/6」に公式で対応しています。
AtsEXの他の機能と連携することで、車両プラグインからも、マッププラグインからも、簡単に運転台パネルやマップ内のテクスチャを書きかえることができます。
マップにプラグインを埋め込める「マッププラグイン」機能
車両よりもマップへの依存度が高いプラグインのために、マップにプラグインを組み込める「マッププラグイン」機能を搭載しています。
車両側のATSプラグインにAtsEXを組み込んでおくだけで、AtsEXがマップに設定されたプラグインを自動で読み込みます。
マップ内のテクスチャの書きかえやスタフの表示などの高度な演出を取り入れる場合、従来はATSプラグインとして車両に組み込む必要がありました。
そのため、そのシナリオで使用できる車両が限られてしまう上、車両を改造することになるため車両制作者との緊密な連携が必要不可欠でした。
AtsEXのマッププラグイン機能を利用することで、マップに関係する処理は全てマップに同梱できるようになり、
そういった高度な演出を含むシナリオから使用可能車両の制限を無くすことができます。
また、プラグイン独自の構文をマップ内に組み込むこともできます。特定の距離程を通過した時にプラグインを実行、といったことが可能になります。
.NETによるオブジェクト指向プログラミングの強力なサポート
従来のC++ベースのATSプラグインはC#などのオブジェクト指向言語との親和性があまり良くありませんでしたが、 AtsEXはオブジェクト指向プログラミングに最適化したラッパーを提供。さらに、DLLExportの複雑な導入作業も全てAtsEXが肩代わりします。
大規模なプロジェクトでも可読性が格段に向上します。AtsEXで拡張された機能を使わない開発にもおすすめです。
Any CPUビルドに対応
BVE6の登場によって、ATSプラグインは64bit版、32bit版の2つを準備しなければならなくなりました。
しかし、AtsEXならプラグインはAny CPUビルドでOK。地味～に面倒だった2バージョンの準備はもう要りません。
AtsEXによって作れるようになるプラグインの例
車両プラグインの例
サウンド系プラグインの音声をポーズで止める
モーター音やエンジン音を拘ろうとした場合、BVEの標準機能では足りず独自にプラグインを開発することになる訳ですが、
従来はポーズ中であるかどうかを判別できなかったためポーズ中に音を止めることはできませんでした。
AtsEXからポーズ中であるかどうかを取得することで、しっかりとポーズ中に音を止めることができます。
ワンマンモニターの再現
従来は、モニターにそれらしい画像を表示させることで疑似再現するのが一般的でした。 AtsEXではBVE本体がマップの描画に使用しているストラクチャの3Dモデルを取得できるため、Direct3Dを駆使すれば実際の景色をモニターに表示することができます。
トンネル抵抗の再現
実際の鉄道車両は、トンネル内では抵抗を受けて加速しづらくなることが知られています（これを「トンネル抵抗」と言います）。しかし、従来のBVEではシナリオの途中で走行抵抗を変更することができませんでした。
AtsEXでは走行抵抗係数の変更に対応しているため、トンネル抵抗はもちろん、他にも向かい風やジェットコースターの減速レールなど、あらゆる走行抵抗の変動を再現することが可能です。
マッププラグインの例
車止めで強制停止
従来のATSプラグインでも速度を取得することはできましたが、設定することはできませんでした。
AtsEXでは速度の設定にも対応しているため、特定の距離程を通過した時に速度をゼロにすることで実装可能です。
手動での駅ワープを必要としないスイッチバックの表現
スイッチバックを含むシナリオでは、到着時用の駅、方向転換後発車時用の駅を別々に用意し、当該駅到着後に時刻表から発車時用の駅にワープすることで疑似的に再現するのが一般的です。
AtsEXでは現在位置、現在時刻の設定に対応しているため、当該駅到着を検知後に発車時用の駅が存在する距離程にワープさせ、方向転換に要した時間を現在時刻に足すことで、
スイッチバックの表現を自動化することができます。
沿線道路を走る自動車の動きを多彩に
近年沿線の道路を自動車が走っているシナリオが増えてきていますが、そのような演出のためには走行用の他軌道を用意する必要があります。
地方にあるような片側1車線の1本道ならそこまで大変ではありませんが、1つでも交差点であったり停留所で幅寄せするバスを作ろうと思うと、その瞬間必要な他軌道の数が指数関数的に増えていってしまいます。
この大量の他軌道をひとつひとつ位置を計算して敷設するのは非常に大変です。
AtsEXでは他列車を軌道の位置に関わらず動かすことができるため、従来よりも圧倒的に短時間で、多彩な動きをする自動車を実装することができます。
下の映像は、ユーザーのキー入力で他列車のバスを操作できるようにした例です。
AtsEX本体に同梱のサンプルシナリオ「他列車操作サンプル EX」より、ご自身のお手元で体験いただけます！
踏切の遮断桿動作の再現
前項「沿線道路を走る自動車の動きを多彩に」から派生した例です。従来は信号を使ったアニメーションで表現する方法が一般的でしたが、テクスチャの準備や先行列車の位置の微調整に大変な労力を要しました。
AtsEXの「他列車を軌道の位置に関わらず動かす」機能を使えば、下の映像のように滑らかに動く遮断桿を簡単に実装できます。
逝っとけダイヤの再現
従来のBVEでは、表示される時刻表でバレてしまうため、種別・行先変更を伴う大規模なダイヤ乱れを再現することは困難でした。
AtsEXでは駅リストの編集に加え時刻表やダイヤグラムの再描画にも対応しているため、輸送指令からの指示に合わせて、運行中に後から運行予定を変更することができます。
踏切障検動作等による強制的な停止現示信号の再現
従来のBVEでは、信号の現示は先行列車と自列車の位置関係、駅に紐づけられた出発信号などの絶対信号の現示によって自動的に決定されていたため、信号の現示を操作することは困難でした。
AtsEXの「特定の信号の現示を上書きする」機能を使えば、見出しにある「障検動作」や、昭和初期のATSなどに見られる特殊な信号現示の推移を再現することができます。
下の映像では、前から2つ目の信号の現示をAtsEXプラグインから介入しています。
AtsEX マッププラグインのサンプル
AtsEX SDK同梱のマッププラグイン「他列車操作サンプル」より抜粋（一部改変しています）
AtsEX 車両プラグインのサンプル
AtsEX SDK同梱の車両プラグイン「状態取得・設定サンプル」より抜粋（一部改変しています）
対応BVEバージョン
少しでも異なるバージョンでは正常に動作しない可能性が高いです。
BVE Trainsim 5
- 5.8（Version 5.8.7554.391）
BVE Trainsim 6
- 6.0（Version 6.0.7554.619）
動かないときは……
BVE6.0 RC版の一部のバージョンでは動作しないとのことです。お手持ちのBVEがRC版ではなく正規版かどうか今一度ご確認ください。
よくある質問
こちら→よくある質問
ダウンロード
AtsEX本体の他、サンプルマップ・車両を同梱しています。
現時点で完成している機能を手軽に試せます。