Lightning Emperor : Composition CG dans un plan live-action
Un workflow et des outils pour placer de la CG derrière ou autour d'acteurs réels. Les outils existent sous trois formes, exécutant le même code :
le serveur MCP (lightning-emperor-mcp), la CLI (lightning-emperor ...) et l'add-on Blender. Privilégiez les outils MCP lorsqu'ils sont connectés ; sinon, utilisez la CLI. Ce fichier est le jugement : quoi mesurer, ce qui ne va pas, comment vérifier son propre travail.
Règles qui évitent les erreurs coûteuses
- Mesurez le plan avant de décider quoi que ce soit. Objectif, capteur, exposition, balance des blancs, couleur et force de l'écran, bruit, d'où vient la lumière. Dix secondes de mesure valent mieux qu'une heure de suppositions.
- Obtenez d'abord la bonne échelle absolue, et obtenez-la de deux façons. L'échelle CG par rapport aux acteurs dépend directement de la distance caméra-sujet. Mesurez-la à partir de la taille en pixels d'un objet connu (une tête mesure environ 0,24 m du sommet au menton) et de la distance de mise au point de l'objectif dans le fichier caméra. S'ils divergent, arrêtez-vous et résolvez le problème. Une distance mal mesurée rend l'ensemble du décor CG à la mauvaise taille dans chaque image. N'ajoutez jamais de facteur d'ajustement pour cacher une erreur d'échelle.
- Trouvez la lumière clé à partir des acteurs, pas d'un brief ou d'une photo de plateau. Comparez les deux côtés d'un visage en lumière linéaire. Les photos de plateau montrent quels éclairages existent ; le plan montre lequel domine.
- Composez en lumière linéaire et dites ce qu'est le plan. Vidéo destinée à l'affichage : linéarisez, mélangez, re-codez. Ne supposez pas un format log parce qu'une image semble plate.
- Regardez l'image en taille réelle et en recadrages. Les vignettes cachent les dévers, les trous et les franges. Ouvrez toujours l'aperçu qu'un outil écrit avant de faire confiance à un matte.
- Une correction peut être pire que le bug. Après chaque correction, re-regardez l'image entière et remesurez ce que vous protégiez.
- Vous ne pouvez pas regarder une vidéo. Mesurez le mouvement avec des chiffres (tailles de pas, gigue) et dites clairement ce que seuls les yeux de l'utilisateur peuvent juger.
- Ne remplacez jamais les originaux. Vérifiez les tailles/durées d'entrée avant un long rendu ; conservez les fichiers source intacts.
- Soyez honnête sur les limites. Lorsque l'utilisateur dit que quelque chose ne va pas, il a presque toujours raison : enquêtez, rapportez des chiffres, dites ce que vous avez mal fait.
Workflow
0. Réception. Sondez chaque fichier. Lisez les métadonnées de la caméra si le format le permet (read_camera_metadata / lightning-emperor metadata) : distance focale (a-t-elle zoomé ?), distance de mise au point, ISO, balance des blancs.
Demandez uniquement ce qui change le travail : où se trouve la CG par rapport aux acteurs, hauteur de la caméra, format de livraison.
1. Caméra. solve_camera_distance à partir d'une taille connue dans le plan et de la mise au point de l'objectif ; exigez agree: true. Ensuite plan_camera (pose, taille d'overscan, pixels par mètre).
Rendez avec un overscan (environ 1,25) pour que le mouvement suivi ne révèle jamais le bord du rendu.
2. Éclairage. Trouvez le côté clé à partir des visages. plan_lights donne les positions et couleurs de départ (azimut 0 = depuis la caméra, +90 = à droite de la caméra, couleurs en kelvin).
Calibrez l'exposition CG par rapport à une mesure dans le plan (patch de peau, fond), pas à l'œil. Éléments clignotants : practical_states donne les images à rendre (allumé/éteint).
3. Keying. key_frame et ouvrez preview_on_grey.png. La key se calibre automatiquement sur l'écran, mais lisez references/keying.md pour savoir quoi vérifier (trous dans les vêtements sombres, dévers de couleur, marques laissées comme des îlots).
4. Suivi (uniquement si la caméra bouge et que le fond est remplacé). track_markers suit une constellation de marqueurs avec une homographie par image. Lisez references/tracking.md : les images avec peu de marqueurs sont bruitées, un fond plat est un plan (une homographie est le bon modèle), aucun marqueur visible signifie que vous tenez ou interpolez.
5. Ombres. shadow_offset calcule où l'ombre d'un acteur tombe sur un fond à partir de la géométrie de la lumière et de l'écart acteur-mur. Voir references/shadows-and-grain.md.
6. Grain. measure_grain à partir de la zone plate de l'écran ; appliquez à la CG pour qu'elle ne semble pas collée. Mesurez à la résolution finale.
7. Composition. composite_frame d'abord sur une seule image. Vérifiez la taille du mur par rapport aux acteurs, le côté de l'ombre, les bords, les niveaux de noir, puis montez en échelle. Rendez les longs travaux par morceaux et vérifiez les nombres d'images.
8. Remise. Lorsque le suivi n'est pas fiable sur une étendue, donnez à un artiste des passes en couches et un indicateur de qualité honnête par image, pas une composition prétendument finie.
Tableau des outils
| Besoin | Outil MCP | CLI | Add-on |
|---|---|---|---|
| Objectif/exposition depuis fichier caméra | read_camera_metadata | metadata | Panneau Plateau |
| Aligner un export avec le fichier caméra | align_clip | align | |
| Distance sujet | solve_camera_distance | distance | Sujet + caméra |
| Pose caméra, taille de rendu | plan_camera, build_shot_scene | Créer caméra de prise | |
| Éclairage | plan_lights | Lumières | |
| Images d'éléments allumé/éteint | practical_states | Clignotement | |
| Rendu des états CG | render_states | Rendu CG | |
| Matte + despill | key_frame | key | Outils Plateau |
| Suivi de marqueurs | track_markers | track | Outils Plateau |
| Décalage d'ombre | shadow_offset | shadow-offset | |
| Grain | measure_grain | grain | Outils Plateau |
| Composition d'une image | composite_frame | comp |
Les erreurs des outils reviennent sous forme de {"error": "..."} avec la raison ; corrigez l'entrée et réessayez.
Blender s'exécute en tant que jobs sans tête. N'essayez jamais d'ouvrir un socket qui exécute du code à l'intérieur d'une fenêtre Blender en cours d'exécution.
Références (à lire à l'étape où elles s'appliquent)
references/failure-modes.md- ce qui ne va pas, pourquoi, et la correction. Parcourir d'abord.references/scale-and-distance.md- l'erreur de distance caméra et les règles qui l'empêchent.references/lighting.md- trouver la vraie lumière clé, construire et calibrer l'éclairage.references/compositing.md- matte, quatre types de dévers, piédestal, douceur, enveloppe lumineuse, vérifications.references/camera-metadata.md- ce que les fichiers caméra vous disent, et aligner un export sur eux.references/review.md- comment utiliser les agents critiques sans se tromper soi-même.references/keying.md- matte, despill, gestion des bords, et ce que les images réelles nous ont appris.references/tracking.md- suivi de marqueurs, stabilisation, lacunes.references/shadows-and-grain.md- géométrie des ombres, mesure et appariement du grain.references/blender-notes.md- notes de script Blender 4.2-5.x pour le travail sans tête.