portrait_image_breakdown

Portrait Image Breakdown はポートレート撮影現場向けに設計されたデスクトップツールで、3つの実用的な課題に焦点を当てている。写真内の人物の2Dポーズ、向き、フレーミング、構図の分析、分析結果を短く具体的でモデルに直接伝えられる現場指示への変換、そして参考画像と現在の画像を比較し、ポーズ、被写体位置、構図に関する調整提案を行うことである。 メイン画面は「2D分析」「現場指示」「画像比較」の3ページのみで構成され、ワークフローは撮影パラメータの理論的導出よりも、撮影時の即時判断を優先している。2D分析ページの右上には、独立して開く3D再構築ツールも用意されており、画像に対応し得るカメラとシーンの仮説を探索するために使用する。このモジュールは観測値（Observed）、推定値（Estimated）、未知項目（Unknown）を明確に区別し、単一画像からの推論を精密な測定として扱わないようにしている。 プロジェクトはPython 3.12+を使用し、uvで依存関係を管理する。.jpg、.jpeg、.png、.bmp、.webp形式の画像に対応し、2Dページでキャンバスをクリックするか写真をドラッグして読み込める。コードはcore（2Dポーズ、構図、現場指示）、gui（3つのメインページとオプションの3Dウィンドウ）、reverse_engineering（メインフローから分離されたオプションの3D推論モジュール）などに分かれており、pytestテストとPyInstallerによるWindowsパッケージ設定も提供している。