Path to Flight Plan

スプラインで描いたパスからフライトプランカメラを生成し、3DGS（3D Gaussian Splatting）用のデータセットを作るまでを、1 つのウィンドウで進めるツールです。Chaos Vantage でのレンダリング、Metashape Pro でのアライメント、LichtFeld Studio 用の transforms.json の書き出しまでを、ステップ順に行えます。

ウィンドウは上から順に 4 つのステップと、セッションの保存で構成されています。

1. パスとなるスプラインを描きます。開いたスプラインも閉じたスプラインも使えます。Circle [円] や Rectangle [長方形] などのシェイプもそのまま使えます（元のシェイプは変更しません）。
2. スプラインを選択して［選択を追加］を押します。複数のパスを使う場合は、飛ぶ順に追加します。
3. ［セグメント分割数］と［ルックアット］を設定します。一覧の下に、現在の撮影点の数が表示されます。
4. ［フライトプラン生成（カメラ作成）］を押します。

P2F_Cam360 という名前の VRayPhysicalCamera（ターゲットなし）が作られ、撮影点ごとにキーが設定されます。Time Slider [タイムスライダー] の範囲も撮影点の数に合わせて変わり、カメラ名は ② の［カメラ名］に自動で入ります。

パスの形を直したいときは、スプラインのノットを編集してから、もう一度［フライトプラン生成］を押します。新しいカメラが作られます。

［.vrscene を書き出し（現在のシーン）］を押し、保存先を指定します。

Vantage は、.vrscene を書き出したときの「レンダリングするビュー」のカメラを、アニメーション付きのカメラ（Original Camera）として扱います。そのためこのボタンは、書き出す前に次の処理を自動で行います。

• ［カメラ名］のカメラをアクティブなビューポートに設定する
• Render Setup [レンダー設定] のビューのロックを解除し、アクティブなビューを使うようにする（Render Setup [レンダー設定] が開いている場合は閉じます）
• カメラのレンズ効果をオフにする

書き出したあと、ファイルの中でカメラがアニメーション付きになっているかを検証し、結果を表示します。

［Vantage レンダージョブ実行（全フレーム）］を押すと、Vantage がコマンドラインで起動し、全フレームをレンダリングします。次の設定は自動で付けます。

パスを編集したり分割数を変えたりしたあと、変わったフレームだけをレンダリングし直す機能です。

1. パスを編集し、① の［フライトプラン生成］と ② の［.vrscene を書き出し］をやり直します。
2. ［差分レンダリング（変更／追加フレームのみ）］を押します。
3. 前回のレンダリングと比べた結果（そのまま使う／番号を付け替える／新しくレンダリングする枚数）が表示されるので、確認して実行します。

• 全フレームのレンダリング時に、出力フォルダへ p2f_frames.txt（フレーム番号とカメラ位置の一覧）を保存し、これを比較の基準にします。
• カメラ位置が［差分一致許容距離］（既定は 1 mm）以内なら同じ撮影点と見なします。比較するのは位置だけで、向きは比較しません。
• 番号がずれた画像は付け替え、不要になった画像は出力フォルダ内の _p2f_old に移します（Metashape に誤って読み込まれないようにするため）。

1. Vantage で出力した画像を Metashape に読み込みます。
2. Camera type [カメラタイプ] を ② のカメラモードに合わせます（Spherical 360 なら Spherical、通常フレームカメラなら Frame）。
3. File [ファイル] > Import [インポート] > Import Reference [リファレンスのインポート] で CSV を読み込みます。列は label／x／y／z に割り当て（位置のみ。CSV には向きの列もありますが使いません）、座標系は Local Coordinates、精度は 0.005 m に設定します。
4. Align Photos [写真のアライメント] を実行し、Update Transform [変換を更新] を実行します。
5. 点群（Tie Points）を、カラー付き・Local Coordinates の .ply で書き出します。
6. カメラを cameras.xml として書き出します（④ で使います）。

Standard では CSV のインポートを使えないため、③ の CSV、Y-up 回転、スケールは使えません。画像をアライメントしたあと、cameras.xml と .ply を書き出して ④ に進んでください。座標系はそのまま整合します。

• カメラモデルは、② のカメラモードに合わせて自動で切り替わります（Spherical 360 は EQUIRECTANGULAR、通常フレームカメラは PINHOLE）。
• 解像度は、cameras.xml にセンサーの解像度があればそれを使います。
• Spherical 360 のデータを LichtFeld Studio で学習するときは、3DGUT を有効にしてください。通常フレームカメラ（PINHOLE）の場合は不要です。
• 点群の .ply を指定しなかった場合は、点群の指定なしで書き出します。

パスの一覧、注視オブジェクト、各ステップの設定はシーンに保存されます。主な操作のたびに自動で保存され、.max ファイルを開き直すと自動で復元されます。

• ［シーンへ保存］／［シーンから復元］で手動でも保存・復元できます。
• シーンに保存されるので、.max ファイルの保存を忘れないでください。
• Vantage の実行ファイルや出力フォルダなどは、3ds Max の plugcfg フォルダーの path2flightPlan.ini にも保存され、次回の起動時に入力済みになります。

.vrscene を書き出したときの「レンダリングするビュー」がフライトプランカメラになっていない可能性があります。② の［.vrscene を書き出し］で書き出し直してください。書き出し後の検証メッセージで、カメラのアニメーションが正しく書き出されたかを確認できます。

Vantage の自動露出がオンになっていると、画像ごとに明るさが変わり、3DGS の学習に悪影響があります。このツールは自動露出をオフにして起動します。［追加オプション］で自動露出を有効にしていないか確認してください。

③ の［Y-up 回転］をオンにして、CSV の書き出しからやり直してください。プロジェクトの途中で切り替えると、点群とカメラの向きが合わなくなります。

本ソフトウェアの著作権は株式会社オークに帰属します。

Copyright © 2026 株式会社オーク https://oakcorp.net/