Image 2 Sculpt は何をしますか?
1枚の画像から、証明可能な彫刻が出力されます。画像に写っているすべての表面は、その画像自身の法線、輪郭、深度にフィットし、隠れた表面は、事前に相互に一致確認された生成ビューからのみ作成されます。そして、構築のすべてのステップはBlenderに記録され、再生可能です。
入力ルーティング
どのような入力でも、最終的には同じケース構成になります(i2s.py new CASE --input ...)。詳細は references/inputs.md を参照してください。
| 入力 | 操作方法 | 備考 |
|---|---|---|
| キャラクター/クリーチャー/オブジェクトのレンダリングまたはAI画像 | new → run | メインパス |
| 実物の写真(フィギュア、おもちゃ、製品、像) | new --kind photo → run | MoGeが実際の焦点距離と深度を提供 |
| 透明部分のあるカットアウトPNG | new → run | アルファチャンネルがマスクになります。マスク呼び出しは不要 |
| 複数のものが写った込み入った画像 | prep --select "the red dragon" | SAM-3が被写体を選択 |
| ドローイング、スケッチ、フラットなイラスト | prep --restyle | nano bananaが姿勢を保ったまま、まず3Dレンダリングに変換 |
| 同一物体の複数写真 | views --import DIR | あなたの写真が生成ビューを置き換えます。角度は位置合わせで自動決定 |
| アイデアのみ | imagine OUT.png "idea" → new | 出発点となるクリーンな全身レンダリングを生成 |
| APIキーなし | カットアウトPNG(+ 自分で用意したビュー) | フロントのみでも動作:シルエットが膨張し、奥行きは背後の推測値になります |
ワークフロー
すべてのチェックポイントでラベル付きのビジュアル(checks/sheet_*.png、ビューシート、ターンテーブルフレーム)を提供します。画像が先、数値はその後です。修正ラウンドではステップを追加します。記録されたものは決して編集されません。
- スキャフォールディング
i2s.py new CASE --input IMG --subject "短い名詞句"。画像を見て、被写体フレーズを自分で書いてください("stocky cartoon troll"、"ceramic owl figurine")。このフレーズはすべてのビュープロンプトに挿入されます。入力画像はsha256とともにコピーされ、最も近いジェネレーターのアスペクト比にパディングされるため、すべてのビューが1つのレンズを共有します。 - フロントマップ
i2s.py prep CASE(マスク、MoGe-3深度+焦点距離、Marigold法線。単位は被写体に正規化)。先に進む前にref/front_mask.pngとref/front_normals.pngを確認してください。間違った被写体が選択された場合は--selectを。ドローイングの場合は--restyleを。 - ビュー
i2s.py views CASE(9ビュー+1ホールドアウト、推定約$2。最小限の場合は--set minimalで5ビュー)。生成されたすべての画像を確認してください。ポーズが変わっている、余分な手足がある、被写体が切れている場合は不良ビューです。位置合わせは、矛盾するビュー(他のビューのハルに対するIoUが0.80未満)を拒否しますが、見たものを報告してください。どのビューも見ていない領域は、より多くのスムージングではなく、その領域を見渡せる角度からの新しいビュー(--angles "-30:25")が必要です(references/views.md)。 - ハル
i2s.py hull CASE:すべてのビューの位置合わせ(要求した角度は事前情報にすぎません。左右の入れ替わりは検出され、フロント/バックは維持されます)、再センタリング、スクリーニング、記録されたカービング、対称性の検出。case.jsonで位置合わせ後の角度を読んでください。i2s.py symmetry CASE on|offで検出されたミラー平面をオーバーライドします。 - フィット
i2s.py fit CASE --stage all(フォーム→サーフェス→ディテール、38の記録パス)、その後cut(写真に写っている指、脚、腕と体の間の隙間を開ける)、smooth(ウェブや斑点を除去)、fit --stage polish。i2s.py run CASEはこのデフォルトプランでステップ2~8を順に実行します(references/fitting.md)。 - チェックと反復
i2s.py check CASEはビューごとにシート(リファレンス、リファレンス法線、スカルプト、法線誤差、シルエット差分)を作成します。しこり、ウェブ、欠落した隙間、平坦化された特徴がないか確認してください。それらをターゲットにします:parts CASE --prompt "hands"してからfit --stage focus --region hands、cut --region hands、smooth --region box:...(references/checking.md)。改善前/後のシートなしに、修正を主張しないでください。 - 仕上げ、Blender、フィルム
finish(面スムージング、OBJ/STL)、blender(すべてのステップが写真のカメラから再生、360°ターンテーブル、各ビュー、sculpt.blend、GLB)、film(360°回転で終わる2パネルタイムラプス、ターンテーブル、ビューシート、ヒーロー画像)。(references/blender-and-delivery.md)。 - レポートと停止
reportはout/REPORT.md、out/index.html、およびステップごとのチャートを作成します。タイムラプス、ビューシート、測定結果の表を示し、弱点を述べて停止します。次にどうするかはユーザーが決定します。
ハードルール
- 写真は、それが見える範囲を支配します。 生成ビューは、写真が見えない部分を埋めるためだけに使用されます。生成ビューの深度は決して使用されません(ビュー間で数センチ単位で一致しません)。生成ビューの法線を写真の法線と平均化しないでください。
- すべてのビューを位置合わせし、要求角度を決して信用しないでください。 トロールの場合、生成ビューは要求から20~155°ずれており、ほとんどが左右の入れ替わりでした。検索はこれらのずれを許容しますが、フロントビューは前面に、バックビューは背面に維持します(対称な被写体の背面は前面と輪郭が似ています)。
case.jsonで位置合わせ後の角度を読んでください。 - カービングの前にスクリーニングしてください。 他のビューと矛盾するビューは、異なる被写体やポーズです。スカルプトをカットする前に、そのビューを拒否し(そしてその理由を伝えてください)、スカルプトをカットしないでください。
- 1つのビューをホールドアウトします。 そのビューは決してサーフェスを動かさず、そのカメラはフィッティング前に固定されます。フィットに使用されたビューとは別に報告してください。これも生成ビューであるため、真実ではなく一貫性を測定します。
- 目視だけでなく測定してください。 IoU、輪郭距離、法線角度、リファレンス自身のラフネスに対するラフネス、写真の深度を確認してください。単一の数値が「品質」を表すことはありません。それらを並べて報告してください。
- 距離フィールドは正確に保たれます。 すべての操作はグリッドを再距離化します(バンド内は正確な三角形距離、それ以外はEDT)。不正確なフィールドのオフセット、フィールド自体のミラーリング、または法線ターゲットのブラーは、このケースで階段状ノイズ、モアレ縞、平坦化された鼻を引き起こしました(
references/lessons.md)。 - すべてを記録してください。 すべてのカーブ、パス、カット、スムージングは
build/steps/とbuild/log.jsonlのステップとして記録され、Blenderで再生され、タイムラプスで表示されます。記録されたステップを編集せず、新しいステップを追加してください。 - 有料呼び出し: すべてのfal呼び出しはケースの予算(
settings.budget_usd)を通過し、そのリクエストIDは待機前にcase.jsonに保存され、何も盲目的に再送信されません。FAL_KEYは決して印刷されたり書き込まれたりしません。 - すべてのチェックポイントで視覚的なフィードバック を提供し、すべてのフィルムのフレーム0は完成したサムネイルにします。
- 何が創作されたかを伝えてください。 正面からしか見えていない被写体の背面は、ジェネレーターの推測です。
リファレンス
| ファイル | 読むタイミング |
|---|---|
references/inputs.md | 通常とは異なる入力のルーティング時、マスク、リスタイル、選択、インポート写真、アイデアのみの場合 |
references/views.md | ビューの生成、判定、位置合わせ、スクリーニング、追加時 |
references/fitting.md | パスの動作、ステージ、パラメータ、カット/スムーズ/フォーカス、デフォルトプランについて |
references/checking.md | マップシートとメトリクスの読み方、ホールドアウトビュー、次に修正すべき点について |
references/blender-and-delivery.md | Blender再生、フィルム、エクスポート、レポート、レビューページについて |
references/conventions.md | ワールドフレーム、カメラ、単位、ファイル形式(新しいツール作成時) |
references/lessons.md | 最初のケースで何が問題だったか、上記のルールが存在する理由 |
テンプレート:templates/CONTRACT.md(すべてのケースにコピー)、templates/acceptance.json(ターゲット)。