BVE Trainsim 5 / 6 の運転台パネルファイル（BveTs Instrument Panel 2.00 / 2.01）を、画面で見ながら編集するツールです。画像を読みこんで部品を作ることもできます。
- 版: 0.2α（試験版です。大事なパネルは、コピーをとってから使ってください）
- ライセンス: MIT License（LICENSE）。使っているライブラリ・同梱素材は THIRD-PARTY-NOTICES.txt
- ダウンロード: Releases の
BvePanelEditor-0.2alpha-win-x64.zip（標準の針・サンプルはこちらに入っています。このリポジトリのソースには入っていません）
- Windows 10 / 11（64bit）
- .NET 10 デスクトップ ランタイム（入っていなければ、起動したときに Windows が入手先を案内します）
- BVE Trainsim 5 / 6 のパネルファイル（Tilt・StopPin・Perspective のキーは BVE 5.8 以降・BVE6。書式 2.00 のパネルでも使えます）
- 配布ファイルを好きなフォルダに展開します（
needles・needle_E217フォルダも exe と同じ場所に置いたままにしてください） BvePanelEditor.exeを起動します- ファイル → 開く で、パネルファイル（.txt / .cfg）を開きます。車両ファイル・シナリオファイルからたどって開くこともできます。パネルファイルを exe や画面にドラッグ＆ドロップしても開けます
開いたばかりのときは「位置ロック」がかかっていて、計器を不意に動かさないようになっています。パネル画面左上の「🔒 位置ロック中」か Ctrl+L で解除します。
- 左: 計器の一覧（ファイル順／レイヤー順）と、問題の一覧
- 中央: パネル画面（ドラッグで配置、ホイールで拡大、スペース＋ドラッグか右・中ドラッグで表示を動かす、Ctrl+0 で表示範囲の全体を表示。操作の案内は画面の右下）と、パネルファイルのテキスト
- 右: 選んだ計器のプロパティと、動作プレビュー（速度・圧力などを動かして針や表示灯の動きを確かめる）
- 見ながら編集: 計器のドラッグ・矢印キーでの移動、プロパティ欄での値の書き換え、テキストの直接編集。どれも Ctrl+Z で元に戻せます
- 書式を崩さない保存: コメント・空行・文字コード・改行はそのまま残し、変えた所だけ書き換えます。最初の保存では元のファイルを
.bakに残します - 計器の追加: 表示灯・指針・デジタル数字・円形ゲージ。標準の針（速度計・圧力計・時計）は回転の中心や角度まで入った状態で置けます。画像・PSD をドロップすると、常点灯画像か、デジタル数字（コマ割済の画像、または 1 コマずつの画像からコマ割を作る）として読み込めます。デジタル数字はテスト画面で 1 コマの高さを確かめられます
- 整理: 複数選択・整列・グループ化・レイヤーの上げ下げ・名前付け。一覧はファイル順／レイヤー順のボタンで並べ替え。一覧での表示／非表示（パネルくんの画面だけ）と、コメントアウト（BVE でも非表示）
- 動作プレビュー: 状態量をスライダーで動かし、針の揺れ・表示灯・数字・ゲージを確かめます。昼⇔夜の切り替え、Tilt（傾き）の表示もできます
- 作る:
- 新規パネル（ベース画像を選ぶ）
- 画像からパネルを作る（昼・夜 × 消灯・点灯の 4 枚の画像から、表示灯を切り抜く。窓ガラス・窓枠などの重ねる画像や、スイッチ・カバーの変化を切り抜く部品用の画像も扱えます）
- PSD から読み込み（レイヤーごとに役割を選ぶ）
- 指針の蓋を作る（パネルの画像から軸の蓋を切り抜く）
- 表示範囲や数字の 1 コマの高さを画像から計算
- バリエーション展開: 全部入りのパネル（マスターパネル）を 1 枚作り、計器ごとに入るバリエーション（路線など）を決めて、バリエーションごとのパネルファイルを書き出します。既存のバリエーション別パネルからマスターを作ることもできます。どのバリエーションに入るかは、パネルファイルにコメント
; @group 名前〜; @endで書きます - 問題の一覧: 画像がない・状態量の書き間違い・使えないキーなどを知らせます。BveEX の状態量（ats256 以上）は「BveEX 対応計器」として別の印で出します。1 行目の文字コードの指定と中身が違うファイルは、中身の文字コードで読み書きし、警告を出します
細かい動きと主な操作キーは 機能の詳細 を見てください。
sample フォルダに、画像・PSD からパネルを作る手順を試せるサンプルと手順書（sample/Readme.txt）があります。
- バリエーション展開の「既存のパネルからマスターを作る」で、計器がうまくバリエーションに振り分けられないことがあります（調査中）。作ったマスターから書き出したパネルは、元のパネルと見比べてから使ってください。元のパネルは書き換えません
- 画像の書き出し（表示灯の切り抜き・蓋・PSD からの書き出しなど）は、PNG を上書きすることがあり、Ctrl+Z では戻せません。上書きの前には確認を出します
- パネルファイルを保存しないまま閉じる（終了・別のファイルを開く・新規）と、そのパネルのために新しく書き出した画像（とそのために作ったフォルダ）をゴミ箱に送るか聞きます。すでにあった画像を上書きしたものは対象にしません
- パネルくんはパネルファイルに、グループ・PSD や切り抜き元とのつながりを
;で始まるコメントで書き込みます（BVE は読み飛ばします） - 「指針を置く」の一覧は exe と同じフォルダの
needles.txtに保存します。書き込みできないフォルダ（Program Files など）に置くと保存できません
- 予期しないエラーが起きたときは、詳しい内容を
%AppData%\BvePanelEditor\logsに、まだ保存していない内容の控えを%AppData%\BvePanelEditor\recoveryに書きます。不具合を知らせるときは、ログのファイルを添えてください - 表示の設定は
%AppData%\BvePanelEditor\settings.txtにあります。消すと初期の設定に戻ります - 版とクレジットは、ヘルプ → バージョン情報 でも見られます
- テキスト欄: AvalonEdit（MIT License）
- 標準の針（
needles）: 作者の自作素材（CC0） - サンプル（
sample）: 作者が過去に公開した車両の素材。動作確認用で、フリー素材ではなく MIT ライセンスの対象外です - E217 の針（
needle_E217）: 内房線製作チーム制作の E217 系に同梱のものを使用させていただいています
ビルド・構成・確認用の起動オプションは 開発者向け を見てください。