Skip to content

Commit 0ecfd11

Browse files
committed
feat: add COLMAP pipeline GUI
1 parent 81aa64a commit 0ecfd11

3 files changed

Lines changed: 459 additions & 4 deletions

File tree

README.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -274,7 +274,16 @@ This entire section is provided by the "Advanced Yaw Selector" module.
274274
* **Preset:** Specifies the encoding speed vs. compression balance (e.g., `medium`, `slow`). Default is `medium`.
275275
* **CQ/CRF:** Specifies the encoding quality. Lower values mean higher quality (and larger files). Range 0-51, typically 15-28. Default is `18`. (Handled as CQ for CUDA, CRF for CPU).
276276

277-
**4.4. Controls and Progress**
277+
**4.4. COLMAP Pipeline**
278+
279+
* **COLMAP Rig Folder:** Select the `colmap_rig` folder (must contain `images/` and `rig_config.json`).
280+
* **COLMAP Executable:** Path to `colmap.exe` (or `colmap` on macOS/Linux).
281+
* **Matcher:** Choose `sequential` for video-style matching or `exhaustive` for full pair matching.
282+
* **Postshot Output:** Output folder for Postshot-ready data. Default is `<colmap_rig>/postshot`.
283+
* **Database:** `database.db` is created inside the COLMAP Rig folder. Existing DB requires confirmation to overwrite.
284+
* **Run COLMAP:** Executes feature_extractor → rig_configurator → matcher → mapper → image_undistorter.
285+
286+
**4.5. Controls and Progress**
278287

279288
* **Parallel Processes:** Specify the number of viewpoints to process simultaneously (number of FFmpeg processes). Selectable from 1 up to the number of logical CPU cores on your PC. The default value is automatically set based on the total number of pitch angles in the "Output Pitch Angle List" (capped by the PC's logical core count). This default updates if you change the number of pitch angles. Increasing this may speed up processing but also increases CPU load and memory usage. The optimal value varies by environment; manual adjustment may be beneficial.
280289

@@ -289,7 +298,7 @@ This entire section is provided by the "Advanced Yaw Selector" module.
289298
* **Application Log Tab:** Displays start/completion messages, settings, messages from the application, error information, etc.
290299
* **FFmpeg Output Log Tab:** Displays detailed messages from FFmpeg during command execution (version info, encoding progress, etc.). Useful for in-depth troubleshooting if problems occur.
291300

292-
**4.5. Menu Bar**
301+
**4.6. Menu Bar**
293302

294303
The application window includes a menu bar at the top.
295304

@@ -389,7 +398,16 @@ The application window includes a menu bar at the top.
389398
* **Preset:** エンコード速度と品質のバランス指定(例: `medium`, `slow`)。デフォルト`medium`
390399
* **CQ/CRF:** エンコード品質指定。数値が低いほど高品質(ファイルサイズ大)。0~51の範囲、通常15~28程度。デフォルト`18`(CUDAはCQ, CPUはCRFとして扱われる)。
391400

392-
**4.4. コントロールと進捗**
401+
**4.4. COLMAPパイプライン**
402+
403+
* **COLMAP Rigフォルダ:** `colmap_rig` フォルダを選択(`images/``rig_config.json` が必要)。
404+
* **COLMAP実行ファイル:** `colmap.exe`(または macOS/Linux では `colmap`)のパス。
405+
* **Matcher:** `sequential`(動画向け)または `exhaustive`(全組み合わせ、重いが繋がりやすい)を選択。
406+
* **Postshot出力先:** Postshot用データの出力先。デフォルトは `<colmap_rig>/postshot`
407+
* **Database:** `database.db` は COLMAP Rigフォルダ内に作成。既存DBは上書き確認あり。
408+
* **COLMAP実行:** feature_extractor → rig_configurator → matcher → mapper → image_undistorter を実行。
409+
410+
**4.5. コントロールと進捗**
393411
* **並列処理数:** 同時に処理する視点の数(FFmpegプロセス数)を指定。PCのCPUコア数に応じ1から最大論理コア数まで選択可。デフォルト値は「出力するピッチ角リスト」のピッチ角総数(PC論理コア数上限)に自動設定され、ピッチ角数変更に追随。値を大きくすると処理が速くなる可能性があるがCPU負荷やメモリ使用量が増加。最適値は環境依存のため手動調整も可。
394412
* **変換開始ボタン:** 全設定確認後、クリックで変換処理開始。
395413
* **中止ボタン:** 変換処理中にクリックで処理中断。
@@ -402,7 +420,7 @@ The application window includes a menu bar at the top.
402420
* **アプリケーションログタブ:** 処理開始/完了、設定内容、アプリからのメッセージ、エラー情報等表示。
403421
* **FFmpeg出力ログタブ:** FFmpegコマンド実行時の詳細メッセージ(バージョン情報、エンコード進捗等)表示。問題発生時の詳細調査に役立つ。
404422

405-
**4.5. メニューバー**
423+
**4.6. メニューバー**
406424
アプリケーションウィンドウの上部にはメニューバーがあります。
407425

408426
* **言語 (Language) メニュー:**

0 commit comments

Comments
 (0)