Lightning Emperor: CG-into-plate compositing
実写アクターの背後や周囲に CG を配置するためのワークフローとツール。ツールは次の 3 つの方法で提供され、すべて同じコードを実行します。
MCP サーバー (lightning-emperor-mcp)、CLI (lightning-emperor ...)、および Blender アドオンです。MCP ツールが接続されている場合はそれを優先し、それ以外の場合は CLI を使用します。このファイルは判断基準です。何を測定するか、何が問題になるか、自身の作業をどのように確認するかを示します。
高額なミスを防ぐルール
- プレートを決定する前に測定する。 レンズ、センサー、露出、ホワイトバランス、スクリーンの色と強度、ノイズ、光の方向。10秒の測定で1時間の推測が不要になります。
- 絶対スケールを最初に正しく取得し、それを2つの方法で確認する。 アクターに対する CG スケールは、カメラから被写体までの距離に直接依存します。既知のもののピクセルサイズ(頭部は頭頂からあごまで約 0.24 m)と、カメラファイルのレンズ焦点距離の両方から測定します。それらが一致しない場合は、停止して解決します。距離を誤ると、すべてのフレームで CG セット全体のサイズが間違ったものになります。スケールエラーを隠すために補正係数を追加してはいけません。
- キーライトは、ブリーフやセット写真ではなく、アクターから見つける。 リニアライトで顔の両側を比較します。セット写真は存在するライトを示しますが、プレートはどれが支配的かを示します。
- リニアライトで合成し、プレートが何であるかを明示する。 ディスプレイ参照ビデオ:線形化、混合、再エンコードします。画像がフラットに見えるからといってログを想定してはいけません。
- 画像をフルサイズと部分拡大で確認する。 サムネイルはスピル、穴、フリンジを隠します。ツールが書き込んだプレビューを信頼する前に、必ず開いて確認します。
- 修正がバグよりも悪化する場合がある。 各修正後、フレーム全体を再確認し、保護していたものを再測定します。
- 動画を見ることはできない。 動きは数値(ステップサイズ、ジッター)で測定し、ユーザーの目だけが判断できることを明確に述べます。
- オリジナルを決して上書きしない。 長時間のレンダリングの前に入力サイズ/時間を確認し、ソースファイルはそのままにしておきます。
- 限界について正直になる。 ユーザーが何かおかしいと言うとき、それはほとんどの場合正しいです。調査し、数値を報告し、何を間違えたかを伝えます。
ワークフロー
0. 取り込み。 すべてのファイルをプローブします。フォーマットが許可する場合はカメラメタデータを読み取ります(read_camera_metadata / lightning-emperor metadata):焦点距離(ズームしたか?)、焦点距離、ISO、ホワイトバランス。作業に影響するものだけを尋ねます:CG がアクターに対してどこに位置するか、カメラの高さ、出力形式。
1. カメラ。 プレート内の既知のサイズとレンズ焦点距離から solve_camera_distance を実行し、agree: true を要求します。次に plan_camera(ポーズ、オーバースキャンサイズ、メートルあたりのピクセル数)を実行します。オーバースキャン(約 1.25)でレンダリングし、トラッキングされた動きがレンダリング端を露出しないようにします。
2. 照明。 顔からキーサイドを見つけます。plan_lights は開始位置と色を提供します(方位角 0 = カメラから、+90 = カメラ右、ケルビン色)。CG 露出は、プレート内の測定値(肌パッチ、背景)に合わせて校正し、目視では行いません。点滅する照明器具:practical_states はレンダリングするフレーム(オン/オフ)を提供します。
3. キー。 key_frame を実行し、preview_on_grey.png を開きます。キーはスクリーンに自己校正しますが、references/keying.md を読んで確認すべき点(暗い服の穴、スピルの色かぶり、島として残るマーク)を確認します。
4. トラック(カメラが動き、背景が置き換えられる場合のみ)。 track_markers は、ホモグラフィを使用してフレームごとにマーカー群を追跡します。references/tracking.md を参照してください:マーカーの少ないフレームはノイズが多く、平らな背景は平面です(ホモグラフィが適切なモデル)、視野内にマーカーがない場合はホールドまたは補間していることを意味します。
5. 影。 shadow_offset は、ライトのジオメトリとアクターと壁の隙間から、アクターの影が背景に落ちる位置を計算します。references/shadows-and-grain.md を参照してください。
6. グレイン。 平らなスクリーン領域から measure_grain を実行し、CG に適用して貼り付けたように見えないようにします。最終解像度で測定します。
7. 合成。 最初に1フレームで composite_frame を実行します。壁のサイズがアクターに比べて適切か、影の側面、エッジ、黒レベルを確認してからスケールアップします。長時間のジョブはチャンクでレンダリングし、フレーム数を確認します。
8. 引き継ぎ。 トラッキングが一定期間信頼できない場合は、アーティストにレイヤードパスとフレームごとの正直な品質フラグを渡し、完成したふりをした合成は渡しません。
ツールマップ
| ニーズ | MCP ツール | CLI | アドオン |
|---|---|---|---|
| カメラファイルからのレンズ/露出 | read_camera_metadata | metadata | プレートパネル |
| 書き出しをカメラファイルに合わせる | align_clip | align | |
| 被写体距離 | solve_camera_distance | distance | 被写体 + カメラ |
| カメラポーズ、レンダリングサイズ | plan_camera, build_shot_scene | ショットカメラを作成 | |
| ライトリグ | plan_lights | ライト | |
| 照明器具のオン/オフフレーム | practical_states | 点滅 | |
| CG ステートのレンダリング | render_states | CG をレンダリング | |
| マット + デスピル | key_frame | key | プレートツール |
| マーカートラッキング | track_markers | track | プレートツール |
| 影のオフセット | shadow_offset | shadow-offset | |
| グレイン | measure_grain | grain | プレートツール |
| 1フレーム合成 | composite_frame | comp |
ツールエラーは {"error": "..."} と理由が返されます。入力を修正して再試行してください。
Blender はヘッドレスジョブとして実行されます。実行中の Blender ウィンドウ内でコードを実行するソケットを開こうとしないでください。
リファレンス(該当する段階で読むこと)
references/failure-modes.md- 何が問題になるか、その理由と修正方法。最初にざっと読むこと。references/scale-and-distance.md- カメラ距離の誤りとそれを防ぐルール。references/lighting.md- 実際のキーライトを見つけ、リグを構築し校正する方法。references/compositing.md- マット、4種類のスピル、ペデスタル、ソフトネス、ライトラップ、チェック項目。references/camera-metadata.md- カメラファイルが伝える情報と、書き出しをそれに合わせる方法。references/review.md- 批判エージェントを自己欺瞞なく使用する方法。references/keying.md- マット、デスピル、エッジ処理、実際の映像から学んだこと。references/tracking.md- マーカートラッキング、安定化、ギャップ処理。references/shadows-and-grain.md- 影のジオメトリ、グレインの測定とマッチング。references/blender-notes.md- ヘッドレス作業のための Blender 4.2-5.x スクリプティングノート。