更新ダウンロードプラグイン+サンプルシナリオプラグイン本体のほかにプラグインの使用例シナリオが同梱されていいます。4,876,124bytes)プラグイン単体プラグイン本体だけが必要な方はこちらからダウンロードしてください。173,586bytes)概要アナログ計器の挙動をリアルにするATSプラグインです。当プラグインはアナログ計器の指針表示の再現性の向上に寄与する二つの機能を備えています。一つ目の機能では低速時における速度計指針の振動を再現することができます。一つは目盛が等間隔でない計器の指示を補正する機能です。Gaugeを使用しなかったときの指針挙動イメージです。0.1kA(100A)ずつ電流値を増やしています。この例では特に数値が大きい領域で実際の値と指示の乖離が大きくなってしまいます。Gaugeによって指針挙動に補正を行った後の指針挙動イメージです。いかなる値に対しても正確な指示を出すようになっています。同梱のサンプルデータの動作例と、開発者モードの使い方の紹介を行っています。当プラグインの動作にランタイムは不要です。Gaugeを既存の車両アドオンに適用する手順を解説します。ここではmackoy様制作の京成3500形車両アドオン中の速度計と電流計への適用例を示します。簡略化のため、指針の影の再現を担う部分への適用は省略します。プラグイン本体であるRealAnalogGauge.dllを適当な場所に置き、車両設定ファイルもしくはRock_On様作成のDetailManager.dllの設定ファイルであるDetailModules.txtからこれをATSプラグインとして指定します。DetailManagerを利用して他のATSプラグインと組み合わせる場合、必ず定速制御を行うプラグインの前に配置してください。次にRealAnalogGauge.dllを配置したフォルダと同じ場所に「RealAnalogGauge.ini」という名前の設定ファイルを作成します。このファイルに以下のテキストをコピー&ペーストし保存します。1FileNameセクションは個別の計器に対する設定ファイル名を、DeveloperModeセクションは開発者モード使用の有無を設定するためのものです。アドオンの公開時にはDeveloperModeセクションを削除してください。各計器の振る舞いを設定するために使用される、以下の4つのファイルを先ほどと同じフォルダに作成します。これらのファイル名のうち拡張子を除く部分は、上記設定ファイル中のセクションで指定したものと同じにします。Speedometer.iniSpeedometer.csvAmmerter.iniAmmerter.csvそれから運転台パネルファイルから計器設定ファイルへの設定値の移植や、プラグイン動作のために必要となる運転台パネルファイルの設定変更を行います。以下は速度計に対する設定を例として解説を進めます。運転台パネルファイルとINI形式の計器設定ファイル(Speedometer.ini)を開きます。Gaugeを適用したい指針の設定を担っているNeedleセクションに移動します。計器設定ファイルにSubjectKeyセクションを追加した上で、運転台パネルファイル中のSubjectキー指定値を計器設定ファイルに移植します。移植元の設定箇所には、ATSプラグインからの出力値を受け取るために「ats*」(*は0~255の整数インデックス値)を指定します。計器設定ファイルにPanelIndexセクションを追加し、Needleキーにも同じインデックス値を指定します。この数値は、既存プラグインで使用されているものと被らないようにしてください。今度はCSV形式の計器設定ファイル(Speedometer.csv)を開き、このファイルに目盛最小値とその指示角と、目盛最大値とその指示角の設定値を以下の図の通りに移植します。移植元の設定箇所には、プラグインの動作に必要となる固定値を指定します。以下のテキストをコピーした後、運転台パネルファイル中に現存する当該設定項目を削除しそれと置き換えてください。360000以上の設定移植作業を、同様に電流計の設定ファイルに対しても行います。Gaugeに対応させるための必要最低限の設定は完了です。Gaugeの機能を実際に利用するためにはさらなる設定が必要です。低速時における速度計指針の振動を再現したい場合には、INI形式の計器設定ファイル中にVibrationセクションを追加します。設定テキストの一例を以下に示します。60Amplitudeキーには指針の振れ幅の大きさを指定します。Periodは10km/hにおける振動周期を指定します。この値が大きいほど指針はゆっくり振動し、小さければその逆となります。Thresholdの指定値より速度が大きいときには振動が起こらなくなります。不等間隔な目盛を持つ計器の指針指示を正確にしたい場合は、CSV形式の計器設定ファイルを編集します。このファイルには、計器へのある入力値とその入力値が指し示す角度のペアを複数記述します。設定テキストの一例を以下に示します。0,-114.7100,-93.1200,-72300,-47.6400,-21.8500,3.4600,30.6700,56.4800,79.7900,981000,114.7このファイルの設定に必要となる指示角度値は、プラグインが適用済みの計器に対して開発者モードを発動することで容易に得られます。詳しいプラグインの設定方法や仕様につきましては、後に続きます「プラグイン設定ファイル構成」と「プラグイン設定仕様書」セクションをご覧ください。現行バージョン3種類の設定ファイルによりプラグインの挙動設定を行います。1のファイル(プラグインと同一名のiniファイル)では各指針の設定ファイル名の指定と、開発者モードに関する設定を行います。2のiniファイルは各指針の挙動に関する設定を担います。3のcsvファイルは各指針の指示角度を補正するためのものです。設定内容の詳細につきましては後述する「プラグイン設定仕様書」をご覧ください。グレーアウトしている部分は、互換性保持のために残した旧バージョンにおける設定ファイル構成です。旧バージョン2017-10-07のアップデートで設定ファイルの構成を変更しましたが、互換性を維持し旧バージョン用の設定ファイルは現バージョンでもそのままお使いいただけます。そのため、プラグインのアップデートはプラグイン本体の上書きだけで完了し、設定ファイルの編集が必要になることはございません。参考までに、以下に旧バージョンにおける設定ファイル構成を示します。旧バージョンのプラグインにおける設定ファイルは「1開発者モード」と「2指針の挙動設定」を両方記載するiniファイルと、「3指針の指示角度補正データ」を記述するcsvファイルの二種類です。この二つの設定ファイル名は、いずれもプラグインと同じファイル名にする必要があります。各指針の設定ファイル名と開発者モードの設定ini形式の設定ファイルです。FileNameセクション指針設定ファイル名を指定します。指針設定ファイル名(拡張子無し)DeveloperModeセクション開発者モードの有効・無効を切り替えます。当プラグインを組み込んだアドオンの公開時にはEnabledに0を指定するか、当セクションを丸ごと削除してください。0で無効、1で有効KeyIndexセクション開発者モードにおけるキーアサインを設定します。調整値のゼロリセットこのセクションで使用する設定用文字列の一覧は以下の通りです。0StepValueセクション開発者モードにおける調整用数値の変化量を設定します。指針の挙動設定ini形式の設定ファイルです。SubjectKeyセクションプラグインで指示する値のソースを設定します。指示値のソースこのセクションで指定可能な設定用文字列のうち、車両物理量の指定に使用する文字列はBVEと同じです。Gaugeの独自設定です。ATS-PIサウンド制御値PanelIndexセクションプラグインからの出力値に割り当てられる運転台パネルファイルのsubjectKey(ats0~ats255)を、0~255の間の数値で設定します。この範囲外の値が設定された場合、BVEへの出力を行いません。指針指示出力Vibrationセクション低速時における速度計指針の振動再現に関する設定を行います。PeriodもしくはAmplitudeの数値を0に設定した場合、針の振動を行いません。指針の指示角度補正データこのcsv形式の設定ファイルには、「ある車両状態量」と「そのときの指針の向き(角度)」の組を複数記述します。これと線形補間を組み合わせて、BVE上における指針指示を適切に補正します。指針の角度は、プラグインの開発者モードを利用することにより簡単に取得することができます(開発者モードの説明は後述します)。csv形式の設定ファイルには一列目に車両状態量を実数値で、二列目にその車両状態量が指し示すべき指針指示角度を度数法で記述します。数値として認識できない文字列が記述された場合は無視されます。LastAngleの設定仕様と共通です)。目盛間隔の補正機能を使用しない場合は、csvファイルに以下の通りに運転台パネルファイルのNeedleセクションにおける各キーの数値を記述すれば、プラグインを使わない時と同じ挙動になります。開発者モードini形式の設定ファイル中のDeveloperModeセクションの設定を変更することにより、開発者モードを利用することができます。非テンキーの2キー)を押すと以下の通りにBVEへの数値出力モードが切り替わります。......各モードにおける挙動は次の通りです。表示モードBVEから受け取った車両状態量を角度に変換して表示します。開発者モードが無効な場合、表示モードに固定されています。調整モードある車両状態量における指針の指示角度の調査に利用します。プラグインとBVE本体のキーアサインが共にデフォルトな場合における、操作キーと角度の変化量の対応は以下の通りです。非テンキーの2キー)を押すと指示角度が0にリセットされます。Spaceキー)を押すと、クリップボードに現在の指針指示角度が出力されます。目盛に指針を合わせて指示角度を取得する作業を繰り返し、車両状態量と指針指示角度の関係を順次調べていくことにより、指針の指示角度補正データを作成します。確認モードここでは車両状態量と角度の関係が正しく設定されていることを、キー操作によって入力状態量を任意に変化させることにより確認します。プラグインとBVE本体のキーアサインが共にデフォルトな場合における、操作キーと状態量の変化量の対応は以下の通りです。非テンキーの2キー)を押すと状態量が0にリセットされます。-100回転モードini形式設定ファイルのStepValueセクション・Rotateキーに設定された速度で指針が回転し続けます。指針の回転中心位置決めの補助としてご利用下さい。