multiview-constraint-solver

マルチビュー制約ソルバー

参照画像同士で食い違いがある場合は、再構築をやり直す前にこれを使用してください。ビューごとの調整を許容しない限り、レンダラーで相互に両立しない正投影寸法を1つの剛体メッシュに適用することはできません。

ワークフロー

1. すべての参照ビューを共通の軸の取り決めに合わせて正規化します。
   • 正面：幅 X、高さ Z。
   • 側面：奥行き Y、高さ Z。
   • 上面：幅 X、奥行き Y。
   • 背面：幅 X、高さ Z。
2. ラベル、背景、オーラではなく、視認できるボディのバウンディングボックスを測定します。ただし、モデルの仕様に含まれるものは除きます。
3. 共通軸を比較します。
   • 正面の幅と上面の幅。
   • 正面／背面の高さと側面の高さ。
   • 側面の奥行きと上面の奥行き。
4. 比率が許容範囲を超えて異なる場合は、競合レポートを作成し、ポリシーを選択します。
   • front_side_canonical：正面のブランドの見え方と側面の奥行き／高さを優先します。
   • front_top_canonical：正面のブランドの見え方と上面のフットプリントを優先します。
   • corrected_templates_required：剛体の再構築で最終的な適合性を満たすことを主張できません。
   • view_specific_cheats：カメラ／ビュー別のバリエーションを許可し、1つの剛体アセットにはしません。
5. ジオメトリ、UV、ライティングの作業を始める前に、選択したポリシーを fit-repair-optimizer に渡します。

必須ゲート

• 正規ポリシーが決まるまで、モデリングを再開しないでください。
• 上面ビューのオーラ／コンテキストをボディの奥行きとして扱わないでください。
• ユーザーが近似的なスタイル調整を明示的に求めていない限り、矛盾する寸法を平均しないでください。
• パーツ数の不一致は、バウンディングボックスの不一致とは分けて記録してください。

スクリプト

• scripts/view_constraint_report.py は、ビューごとのボディバウンディングボックスを含む JSON ファイルを読み込み、共通軸の互換性と推奨される正規ポリシーを出力します。