----------------------------------------------------------------------------------
BlocklyAts習作
車両走行ノイズ再生プラグイン（door_ptpt）

2021/09/03版 rev.2
----------------------------------------------------------------------------------

【概要】
ドアのバタつきや車輪回転音など、車両走行時に鳴るノイズを再現するプラグインです。
RUN音とは違いこのプラグインで鳴らされる音は速度に対して音程が変化しません。
GeneralAtsPluginのShock.dllにも同じような機能がありますが、
このプラグインでは3種類の音を速度によって自由にミックスすることが可能です。
なおATS機能などはついていませんので、DetailManager.dllなどを利用して組み合わせてください。

v1.1.0.0のリリースにより仕様が変わったため新しく作り直しています。
ATS_SoundNoとデバッグ出力の可否を設定できるようにしました。
後退時にも対応しました（処理忘れてた）

プラグインはBlocklyAts（v1.1.0.0）で製作されており、ソースも同梱しています。
ソースは自由に参考・改変・公開していただいて構いません。（連絡は不要です）

BlocklyAts公開先
https://github.com/zbx1425/BlocklyAts


！！注意！！
DetailManager.dll等で他プラグインと併用を前提にしているプラグインですが、
一部プラグインとの相性問題を確認しています。
detailmodules.txtの順番変更で治る場合もありますが、基本的に何か妙な挙動があったら
このプラグインを真っ先に外して様子を見てください。
詳細な原因は不明ですが、問題のあったプラグインを報告していただけると助かります。
もしかするとBlocklyAtsの修正で治るかもしれません。


【内容物】
○本体
door_ptpt.ini		……	設定ファイル
door_ptpt_x86.dll	……	32bit版プラグイン（BVE5用）
door_ptpt_x64.dll	……	64bit版プラグイン（BVE6用）

○ツールおよびソース（車両には同梱しないでください）
_door_ptpt.exe		……	設定確認ソフト
door_ptpt.batsxml	……	プラグインソース　　※BlocklyAts v1.1.0.0用


【dllを更新する場合】
door_ptpt.iniにATS_SoundNoの設定項目が増えているので必ず設定してください。
（デフォルト設定はされていません）


【door_ptpt.iniの設定方法】
○設定項目
[ptpt1]　	……	トラック1番の設定（旧204番）
speed1 = 〜	……	　速度設定
value1 = 〜	……	　値設定
atsNo = 〜	……	　ATS_SoundNo				←　New!

[ptpt2]　	……	トラック2番の設定（旧205番）
speed2 = 〜	……	　速度設定
value2 = 〜	……	　値設定
atsNo = 〜	……	　ATS_SoundNo				←　New!

[ptpt3]　	……	トラック3番の設定（旧206番）
speed3 = 〜	……	　速度設定
value3 = 〜	……	　値設定
atsNo = 〜	……	　ATS_SoundNo				←　New!

[debug]
output = 0	……	　1にするとdoor_ptpt_test.txtに出力	←　New!
※カンマ区切りのCSVが閲覧できるツールがあると見やすくなります。


・設定例
>[ptpt1]
>speed1 = 0,  95, 200	← 0km/h・95km/h・200km/h
>value1 = 0, 100, 100
0〜95kmにかけて音量を0%から100%に変化させながら再生。
96km/h以上から200km/hまで100%で再生。201km/h以上は無音。


・ダメな設定例
>[ptpt1]
>speed1 = 0,  95
>value1 = 0, 100
このように設定すると95km/hで音が途切れます。
必ず最高速度から余裕を持ったところに終了速度を設定してください。
※運転時に警告が出てしまいます。

>[ptpt1]
>speed1 = 0, 100, 50
>value1 = 0,  50, 100
速度は必ず順番（昇順）に並べてください。
※読み込み時に警告が出ます。

>[ptpt1]
>speed1 = 0,  75 ,100
>value1 = 0, 100
速度と値の数が合わないとエラーになります。
※読み込み時に警告が出ます。

※iniに日本語でコメントを入れる際は必ず「Shift-JIS」で保存してください。


・door_ptpt.exe（設定確認ツール）
起動するとdoor_ptpt.iniを読み込んでグラフを表示します。
door_ptpt.iniにエラーがある場合はエラーの内容を表示します。


【製作者】
かんたんのゆめ　NT/fiv
http://kty-bvememo.hatenablog.jp/
https://twitter.com/ntfiv
