BVE-I-WEB

C++向けAtsプラグイン作成方法その1

今回は1年間私が作成してきた、Atsプラグインの作成方法を備忘録としてこちらにまとめておきたいと思います。

今回は基本構造的なC++の知識を必要とします。そこまでの基礎的な知識は書店等でのC++の初心者向けの方を半分程度学ぶことをおすすめします(私も同じようなことをしましたが、途中でコードをいじることで学んだので、すべてやる必要は特段必要ないかもしれません)

基本的に必要とされるのは、プラグラミング能力というより、「どのように再現をするのか」再現の構造を想像することが必要とされます。

ベースとして私はTn_E235様の「ATSプラグイン制作メモ」を基にプラグインを作ってきました。

基本的には前述のページの通り進んでいただければ大丈夫です。

0.VisualStudioをダウンロードしてメモの「準備」、「プロジェクトの設定」からVisualStudioの環境を整える
1.BVEの公式ページの保安装置ページからats1-2.zipをダウンロードする
2.メモの「ほぼ空のプログラムにする」を参照して制作のベースを整える
3.メモの「ほぼ空のプログラムにする」の7.の38から46行目を削除し、かわりに

 g_output.Brake = g_brakeNotch;

を記述してください

次(その2)

C++向けAtsプラグイン作成方法その2

C++の基本的な部分について説明します。

.hファイルには変数(値を入れる箱)を定義します。
変数にはいくつか種類があり
bool型:trueとfalseつまり0と1しか扱うことができません
int型:整数を扱うことができます。小数を入れると切り捨てられます
double型、float型:基本的にこの２つは小数を扱うことができます。
.cppファイルにはどのように実行するのかの命令を書きます。 .cppファイルの中にはいくつかの関数があります。
関数の役割は様々なページで紹介されていますが、こちらでも紹介させていただきます。

BOOL APIENTRY DllMain

はDLLファイル出力についての処理が記述されています。基本的にこの部分を削除してしまうとDLLファイルの出力がうまく行かずエラーが出てしまいます。

ATS_API int WINAPI GetPluginVersion

は0x00020000という数字を返します。使用用途は不明です。

ATS_API void WINAPI SetVehicleSpec

はparameter.txtに記述されている車両情報を取得します。ノッチ段数やATS確認最小ノッチ、両数を取得できます。

ATS_API void WINAPI Initialize

は駅ジャンプ時やロードされたときに呼び出される関数です。主に初期化に使います。コラム:値系の代入はinitで行うと、変な値を引っ張ってしまうので、initでは行わず、initでtrueにした変数を用いてElapseで値を代入して変数をfalseに戻すと変な値を取得することが少なくなります。

ATS_API ATS_HANDLES WINAPI Elapse

毎フレーム呼び出される関数です。基本的な処理はここで行われます。たとえば

sound[0] = ATS_PLAY_LOOPING;

と入れるとsoundの0番をずっとループ再生するコードになります。

ATS_API void WINAPI SetPower

は力行ノッチが変化したときに呼び出される関数です。

ATS_API void WINAPI SetBrake

は制動ノッチが変化したときに呼び出される関数です。

ATS_API void WINAPI SetReverser

はレバーサーが変化したときに呼び出される関数です。コラム:レバーサーの情報はdetailmanagerで先に読み込まれたプラグインによって書き換えられている可能性があります。(ドア開扉時に切になる) 一番最初に読み込まれたプラグインが正しく情報を取得できるので、レバーサーに関与するプラグインは最初に読み込ませるほうが良いです。(具体的な解決策が見つけられてないので情報ある方はご教授ください)

AtsExプラグインを併用することによって解決できます。

ATS_API void WINAPI KeyDown

はキーを押されたときに呼び出される関数です。Bveの設定のAts部分のキーアサインに記述されているキーに限り情報を取得することができます。(Atsのキーアサイン以外のキー情報を取得する情報は後日記載します。)

ATS_API void WINAPI KeyUp

はキーを離したときに呼び出される関数です。Bveの設定のAts部分のキーアサインに記述されているキーに限り情報を取得することができます。

ATS_API void WINAPI HornBlow

は警笛を扱われたときに呼び出される関数です。警笛を取り扱い始めたときしか取得できないので、用途はEBスイッチぐらいしかありません。(警笛をAtsプラグイン側で鳴らす方法は後日記載します。)

ATS_API void WINAPI DoorOpen

ドアが開いたときに呼び出される関数です。

ATS_API void WINAPI DoorClose

ドアが閉まりきったときに呼び出される関数です。(ドアの閉まり始めはAtsExプラグインによって取得する方法は後日記載します。)

ATS_API void WINAPI SetSignal

現示が変化するときに呼び出される関数です。

ATS_API void WINAPI SetBeaconData

地上子を踏み越えたときに呼び出される関数です。
beaconData.Type:int型で地上子の種類を取得します。
beaconData.Signal:int型で対になる信号機の現示を取得します。(地上子を超えた段階での現示しか取得できないので、現示アップしても先行現示の情報は取得できない)
beaconData.distance:float型で次の現示までの距離を取得します。(signalまでの距離ではなくsectionまでの距離なのが注意)
beaconData.Optional:int型で地上子のsendDataの情報を取得します。

ATS_API void WINAPI Load

はプラグインが読み込まれたときのみ呼び出されます。駅ジャンプ時などには呼び出されないので読み込まれたときだけ初期値を代入するなどで使うことができます。

ATS_API void WINAPI Dispose

はプラグインが読み込み解除されたときのみ呼び出されます。

私的完璧路線制作のコツ

どうも。
BVE_I_です。
ブログの本更新第一回目にして、個人的に少し思ったことをまとめていきます。

とある日某氏に
「そんな見えないところを作ったって意味がないよ」
と言われたのですが(下記画像のように)
私は一概に意味がないとは言い切れないと考えています。
例えば下記画像のように基準地点を決めて路線を作れば(ここでは$standardH13が変数としてそれを基準に路線を作っています。)
+と-を入れ替えるだけで上下線を簡単に再現できると考えています。
(厳密にいえばstructuresを載せているtrackを0であるというのはあまりよくないのでそれを変更すればよさそう)
現に逆方向をむいて走行してみると動画のようになるのです。

(逆方面のホームをまったく作っていないのはご愛敬です。)

私的には逆方面などを制作する拡張性を大事にしてこのように作っているのですが、みなさんはどのように作られているのでしょうか。

私には到底想像もつきませんが、あくまで上下線再現する上ではこのような手法でつくるとなるとある程度この手法は楽なのかなと思いました。
(なお上下線をつくる将来性は当方にはないので完全に無駄)

もしどなたかの参考になっていただければ幸いです。

補足
BVEを作るうえでこれは絶対にやめた方がいいことがあります。

structurekeyをすべて番号管理するのは絶対にやめましょう！

私はこれで痛い目を見ているので絶対にお勧めしません。
わかりにくくて結局どんなstructureか説明するものをつける羽目になるので絶対にやめましょう

関係サイト
HP

twiiter

youtube
コメントは当方の独断により削除される場合があります。ご了承ください。

諸情報

どうも。
BVE_I_です。
個人的にBVEの技術的+表現方法の備忘録が欲しかったので、ブログという形で立ち上げました。

(もしtwiiterの方が死んだらこちらで主に活動するかもしれません。)

関係サイト
HP

twiiter

youtube

コメントは当方の独断により削除される場合があります。ご了承ください。