ver2.0.5 - v2.0.50204.1

[automatic9045]

基本的には、本バージョンの仕様がそのまま正式版の仕様として引き継がれます。ただし、万が一重大な欠陥などが判明した場合は、一部の仕様が変更となる可能性があります。次版 (ver2.1) が正式版最初のバージョンとなる予定です。

BveEX についてはこちら→ AtsEX BVE拡張キット - 岡オカ営業所
※サイト工事中につき、「AtsEX」の表記が残っています。

ver2.0.4 → ver2.0.5 アップデートのポイント

操作できる機能を大量追加

車両からマップまで、過去最大級の機能追加を行いました。以下はその一例です。

• 車両データのパラメーターファイルで設定する値全て
• マップファイルの構文解析ロジックの根本部分
• INI ファイルの読込ロジック
• 3D モデルの読込方法を拡充

あまりの量の多さに、ここではその全てをご紹介することができませんが、下記「ver2.0.4 からの主な更新内容」の「クラスラッパー」項目をご覧いただければその量が分かるかと思います。

BveEX オリジナルの演算子を追加

論理演算に便利な各種演算子を追加しました。

• 比較演算子: <、>、<=、>=
• 等価演算子: ==、!=
• 論理演算子: &&、||、!

C 言語などの有名な言語と基本的な仕様を合わせているので直感的に扱えます。マップ if 文 (後述) の条件式と相性抜群です！

マップ if 文を完全刷新

できないことが多かった従来の if 文に代わり、どんな操作にも対応できる新形式の if 文を実装しました。

従来の if 文では、以下のように変数への代入や距離程の変更、他のマップファイルの include などを条件分岐の中で行うことができませんでした。

$a = rand();
$b = 0;
BveEx.If.BeginIf($a, '<', 0.5);
    $b = 1;
BveEx.If.EndIf();

BveEx.Dialog.Show('$b は ' + $b + ' です。');
// $b は 50% の確率で 0、1 のどちらかになるかと思いきや、常に 1 になってしまう

これは、BVE 本体のマップ読込ロジックへの介入箇所に起因する問題でした。

そこで、新形式の if 文では更に構文解析の根本部分へと介入する形で実装。これにより、どのような構文を条件分岐の中に記述しても正常に処理できるようになりました。

$a = rand();
$b = 0;
ex_if ($a < 0.5) {
    $b = 1;
}

BveEx.Dialog.Show('$b は ' + $b + ' です。');
// $b はちゃんと 50% の確率で 0、1 のどちらかになる

詳しい使い方は「マップ if 文・演算子等サンプル」を参照してください。

引数付きの拡張 include 文を実装

以下のように、引数を付けて他のマップファイルを呼び出せるようになりました。1 行で完結するので、インクルードを関数的な方法で使う際に便利です。

800;
    $foo = 12345;
    ex_include 'SubMap.txt', 100, 'hello', $foo;

インクルードされる側のマップファイルでは、以下のように渡された引数の値を取得できます。

ex_argdistance;
// ex_include 構文が記述されていた距離程 (800 m) を取得できる

    BveEx.Dialog.Show('arg1 は ' + ex_arg1 + ' です。'); // 100
    BveEx.Dialog.Show('arg2 は ' + ex_arg2 + ' です。'); // 'hello'
    BveEx.Dialog.Show('arg3 は ' + ex_arg3 + ' です。'); // 12345

詳しい使い方は「マップ if 文・演算子等サンプル」を参照してください。

ライセンス

従来の AtsEX からライセンスが変更となっています。暫定的なもののため、次版以降は異なるライセンスに変更となる可能性があります。

商用利用について

商用利用をご希望の場合は個別の許諾となります。事前にご連絡ください。

連絡の要・不要の指針は後日ホームページにて公開予定ですが、現時点では一律で要連絡とさせていただきます。

ver2.0.4 (v2.0.50104.1) からの主な更新内容

共通

• 参照する Harmony のバージョンを 2.2.2 から 2.3.3 にアップデートしました。→ 07eee56

BveEX 本体

• 【破壊的変更】 同一プラグインを複数回読み込んだとき、AssemblyPluginBase.Location プロパティが「そのプラグインが初めて読み込まれたときのパス」ではなく「PluginUsing などで指定されたパスそのもの」を返すようになりました。→ a99693b
  • 従来の戻り値は直感に反するものですが、これは .NET Framework のアセンブリ (dll) 読込の仕様に起因するものです。

マップファイルの構文関連

• 【重要】 2 項演算子 <、>、<=、>=、==、!=、&&、|| を追加しました。→ af8d846
• 【重要】 単項演算子 ! (否定) を追加しました。→ af8d846
• 【重要】 if 文を新しい書式で追加しました。→ 3053ce8
  • ex_if (condition) { ～ } ex_elif (condition) { ～ } ex_else { ～ } のように記述します。
  • BveEx.If.BeginIf(int condition) などによる旧書式の if 文と異なり、条件分岐の中でも正常に変数への代入や距離程の変更を行うことができます。
• 【重要】 引数を付加可能な拡張 include 文を実装しました。→ 8cec62a

BveEX コア拡張機能

ビルトイン マップ構文

• 【破壊的変更】 新書式の if 文の実装に伴い、旧書式の if 文を廃止しました。→ 1b28295 / c73dd42
  • エラーにはならず、設定した条件自体が無視されます。

クラスラッパー

• 【破壊的変更】 BasicBrake クラスを BrakePiston に改名しました。→ 897f1bb
• 【重要】 BpValve クラス、CircuitBreaker クラス、Compressor クラス、CscFilteredTimeDelayedHandleSet クラス、LoadCompensator クラス、TimeDelayedHandleSet クラス、BcValve.IsBcServo プロパティ、BcValve.RapidReleaseSpeed プロパティ、BcValve.RapidApplySpeed プロパティ、BrakePiston.Stroke プロパティ、BrakePiston.Force プロパティ、BrakeSystem.TimeDelayedHandles プロパティ、BrakeSystem.BrakeBlender プロパティの set アクセサ、BrakeSystem.BrakeController プロパティの set アクセサ、BrakeSystem.Compressor プロパティ、CarInfo.Tachogenerator プロパティ、CarInfo.MotorState プロパティ、CarInfo.BrakePistonForce プロパティ、Cl.Er プロパティ、Cl.Bp プロパティ、ConstantSpeedRelay.Input プロパティ、ConstantSpeedRelay.Output プロパティ、ConstantSpeedRelay.Initialize メソッド、HandleSet クラスのコンストラクタ、HandleSet.Sync メソッド、JerkRegulator.ElectricBrakeCommand プロパティ、JerkRegulator.CurrentIncrease プロパティ、JerkRegulator.CurrentDecrease プロパティ、NotchInfo クラスのコンストラクタ、OneLeverCab クラスのコンストラクタ、Passenger.Load プロパティ、Passenger.BodyWeight プロパティ、Passenger.BoardingSpeed プロパティ、Passenger.AlightingSpeed プロパティ、ReAdhesionControl.SlipAcceleration プロパティ、ReAdhesionControl.SlipDeceleration プロパティ、ReAdhesionControl.SlipVelocity プロパティ、ReAdhesionControl.BalanceAcceleration プロパティ、ReAdhesionControl.HoldingTime プロパティ、ReAdhesionControl.ReferenceAcceleration プロパティ、ReAdhesionControl.ReferenceDeceleration プロパティ、Smee.Sap プロパティ、Smee.Bp プロパティ、Tachogenerator クラスのコンストラクタ、Tachogenerator.Acceleration プロパティ、Tachogenerator.ResistanceAcceleration プロパティ、TwoLeverCab クラスのコンストラクタ、Vehicle.Initialize メソッドのオーバーロード、Vehicle.Tick メソッド、VehicleDynamics クラスのコンストラクタ、VehicleDynamics.InertiaRatio プロパティ、VehicleDynamics.TotalMass プロパティ、VehicleDynamics.TotalInertia プロパティ、VehicleDynamics.MassRatio プロパティ、VehicleDynamics.Tick メソッド、VehicleDynamics.Initialize メソッド、VehicleDynamics.Setup メソッド、VehicleElectricity.TimeDelayedHandles プロパティ、VehicleElectricity.Breaker プロパティ、VehicleInstrumentSet クラスのコンストラクタ、VehicleInstrumentSet.LoadCompensator プロパティ、VehicleInstrumentSet.Initialize メソッドのオーバーロード、VehicleLocation クラスのコンストラクタ、VehiclePerformanceBase.LoadFromFile メソッド、VehicleVibration クラスのコンストラクタ、VehicleVibration.Initialize メソッドを追加しました。→ 71a93bb
  • 車両データのパラメーターファイルで設定する値を全て操作できるようになりました。
• AirSupplement クラス、BrakeBlenderBase クラス、BrakeControllerBase クラス、BrakePiston クラス、BrakeSystem クラス、CarBrake クラス、Cl クラス、Ecb クラス、LockoutValve クラス、Smee クラス、VehicleElectricity クラス、VehicleInstrumentSet クラスに ITickable インターフェイスを実装しました。→ b2e1064 / 49e4d35 / 71a93bb / a62248d
  • これにより、各クラスに Initialize メソッド、Tick メソッドが追加されました。
• ElectricBrakeCommand クラス、BrakeBlenderBase.ElectricBrakeCommand プロパティを追加しました。→ 085220d
  • 電気ブレーキ力の目標値が操作できるようになりました。
• VehicleLocation.Tick メソッド、Tachogenerator.Tick メソッドを追加しました。→ 6c1583a
• Map.AdhesionObjects プロパティ、Map.BrakeShoeFrictionObjects プロパティを追加しました。→ 465064e
• CabBase クラス、VehicleInstrumentSet クラスに IDisposable インターフェイスを実装しました。→ 71a93bb
  • これにより、各クラスに Dispose メソッドが追加されました。
• Model.CreateRectangleWithTexture メソッドのオーバーロード、Model.FromMesh メソッドを追加しました。→ 2e5af71
  • これまで以上に様々な方法で Model オブジェクトを作成できるようになりました。
• IniReader クラスを追加しました。→ 4d94324
  • BVE 標準の INI ファイルの読込ロジックを参照できるようになりました。
• SpeedLimitList.VehicleLength プロパティを追加しました。→ 258a663
  • 速度制限を解除する位置を計算するための自列車長さを操作できるようになりました。
• IMapLoader インターフェイス、MapGrammar クラス、ClassicMapParser.Parse メソッド、MapLoader.ThrowError メソッド、MapParser.Parse メソッド、MapParserBase.Parent プロパティを追加しました。→ 7180a77
  • マップファイルの構文解析ロジックを根本から操作できるようになりました。
• ValveMode 列挙型、Valve.Pressure プロパティ、Valve.Mode プロパティを追加しました。→ 4e37c46
• BrakeControllerBase.Handles プロパティ、BrakeControllerBase.OutputPressure プロパティを追加しました。→ a62248d

TypeWrapping

• 読込時のエラーで、文面が分かりづらいものの一部を修正しました。→ 2719c17

サンプル

• 駅のホームの方向を逆転しました。→ 1736e51
  • 見た目上は右側にあるものの、Station.Put 構文では左側に設定されていたため、見た目に合わせて右側へ統一しました。

マップ if 文

• 【重要】 if 文の書式変更や演算子の追加に対応し、「マップ if 文・演算子等サンプル」としてリニューアルしました。→ 638de8f / d283ee9

ver2.0.3 (v2.0.50103.3) からの主な更新内容

BveEX 本体

• 【重要】 プラグインの Tick メソッドから ATS ハンドル出力が上書きできない問題を修正しました。→ 78c8733
• Markdig が正常に動作していなかったため、参照する System.Runtime.CompilerServices.Unsafe パッケージのバージョンを調整しました。→ d728e1c
• Markdown変換に失敗した場合でも、アップデート情報ダイアログが表示されるようになりました。→ 3ad67d9

BveEX コア拡張機能

SoundFactory

• 内部実装を変更し、ISoundFactory.LoadFrom メソッドを使用できる期間を延長しました。→ 093456e
  • AtsPlugin クラスのコンストラクタの実行後から BveHacker.ScenarioClosed イベントの発生まで使用可能です。
  • 呼出タイミングの関係により、車両プラグインのコンストラクタからは直接呼び出せるようになりました (マッププラグイン、拡張機能のコンストラクタからの呼出は引き続き不可です)。
  • 使用可能かどうかを ISoundFactory.IsAvailable プロパティから取得できるようになりました。
  • 使用不可能なタイミングで ISoundFactory.LoadFrom メソッドを呼び出した場合、独自の InvalidOperationException がスローされるようになりました。

ver2.0.2 (v2.0.50103.2) からの主な更新内容

レガシーモード

• 車両データに AtsEx.Caller.x**.dll が組み込まれていることを検出したときも、自動でレガシーモードへ切り替わるようになりました。→ a976b70 / 9b7aadd

ver2.0.1 (v2.0.50103.1) からの主な更新内容

レガシーモード

• 通常モード・レガシーモードの切替に失敗することがある不具合を修正しました。→ 2613fe8 / 5a7c941

ver2.0 (v2.0.41222.1) からの主な更新内容

BveEX 本体

• バージョン情報ダイアログ内のリンクを修正しました。→ 7e36293

BveEX Launcher

• IPC チャンネルの登録解除忘れを修正しました。→ fda4571
  • これにより、「チャネル 'ipc client' は既に登録されています」エラーが解消されました。
• BveEX 本体の読込に時間がかかると IPC 通信がタイムアウトし、エラーとなる不具合を修正しました。→ 07f4bd0
  • これにより、「IPC ポートに接続できません」エラーが解消されました。
• アップデート情報の取得先が旧名リポジトリのままであったため修正しました。→ 0356d37

クラスラッパー

• XML ドキュメントの誤りを修正しました。→ 66c4fb4

サンプル

マップ if 文サンプル

• AtsEX 向けの古い構文が残っていたため修正しました。→ 1fde1cb

レガシーモード

• 【重要】 レガシーモード下で BVE を終了した場合でも、次回起動時には自動で通常モードへ復帰するようになりました。→ 05fc250
• 【重要】 AtsEX 向け・BveEX 向けのコードが混在していると再起動を繰り返し、無限ループしてしまう不具合を修正しました。→ 9bc779b / 8673eb4
• 【重要】 AtsEx.Caller.x**.VehiclePluginUsing.xml からの車両プラグインの自動読込に再対応しました。→ 1e2ebda
  • AtsEX ATS プラグイン版向けの車両プラグイン組込方法です。古い機能のためレガシーモードでは実装しなかったのですが、多くのご要望を頂いたため予定を変更して実装しました。

同梱プラグイン一覧

拡張機能

• BveEX コア拡張機能
  • ConductorPatch
    • 車掌の動作を自由に変更できるようにするパッチを提供します。
  • ContextMenuHacker
    • メインフォームの右クリックメニューを編集するための機能を提供します。
  • DiagramUpdater
    • 時刻表、ダイヤグラムなどの行路に関わるオブジェクトの更新機能を提供します。
  • MapStatements
    • プラグインからオリジナルのマップ構文を簡単に定義・参照できるようにします。
  • PreTrainPatch
    • 先行列車の走行位置を自由に変更できるようにするパッチを提供します。
  • SignalPatch
    • 閉塞の信号現示を自由に変更できるようにするパッチを提供します。
  • SoundFactory
    • プラグインから音声を簡単に読み込めるようにします。
  • StructureModelFinder
    • ストラクチャーの 3D モデルを簡単に検索するための機能を提供します。
  • TrainDrawPatch
    • 他列車を自由に移動・回転できるようにするパッチを提供します。
• AtsArrayExtender
  • ATS パネル・サウンドで使用可能なインデックスを、従来の 4 倍の範囲 (0 ～ 1023) に拡張します。詳しいことは ホームページ をご覧ください。
• DXDynamicTexture
• MultiStructureList
  • 複数のストラクチャーリストを読み込めるようにするプラグインです。
• RichLoad
  • リッチなシナリオ読込画面を実装できるようにするプラグインです。

車両プラグイン

• 運転台パネルに値を渡すサンプル
• 車掌サンプル
• マッププラグイン連携サンプル
• 運転台パネル操作サンプル
• シンプルな ATS サンプル
• 状態取得・設定サンプル

マッププラグイン

• 車両プラグイン連携サンプル
• DXDynamicTexture 連携サンプル
• 新・マップ構文サンプル
• 先行列車操作サンプル
• 信号現示操作サンプル
• SoundFactory サンプル
• 駅リスト編集サンプル
• 他列車操作サンプル
• 他列車操作サンプル EX (自動制御版)
• 他列車操作サンプル EX (手動制御版)

ダウンロード

【推奨】BveEX 本体＋サンプルシナリオ＋BveEX SDK　exe インストーラー版

BveEX 本体に加えて、車両プラグイン・マッププラグインの動作が確認できるサンプルシナリオ、BveEX SDK (サンプルプラグインのソースコードのセット) を同梱しています。

下の Assets より BveEX_v2.0.50204.1_Setup.exe をダウンロードし、実行してください。

BveEX 本体＋サンプルシナリオ　7z 手動インストール版

BveEX 本体に加えて、車両プラグイン・マッププラグインの動作が確認できるサンプルシナリオを同梱しています。
※手動インストール版には BveEX SDK は同梱されません

下の Assets より BveEX_v2.0.50204.1.7z をダウンロード・解凍し、シナリオフォルダおよび BVE 本体の Input Devices フォルダに配置してください。

インストール方法の説明はこちら→ AtsEXインストールガイド - AtsEX ATSプラグイン拡張キット - 岡オカ営業所
旧・AtsEX 向けの説明ですが、手順に大きな変更はありません。

BveEX SDK

サンプルプラグインのソースコードのセットです。内容は ver2.0 から変更ありません。

下の Assets より BveEX_v2.0.50204.1_SDK.7z をダウンロード・解凍してください。実行には別途 BveEX 本体のダウンロードが必要です。
※自動インストーラー版には BveEX SDK が初めから同梱されているため、こちらを別途ダウンロードする必要はありません。

解凍には 7-zip などの解凍ソフトが必要です。

---

This discussion was created from the release ver2.0.5 - v2.0.50204.1.