Communitygithub.com

Lightning Emperor

Workflow et outils pour composer des images CG (Blender/Cycles) dans des plans live-action, en particulier pour remplacer un fond bleu ou vert. Couvre l'appariement de la caméra (objectif, capteur, distance sujet mesurée de deux façons), l'appariement de l'éclairage réel, le keying et le despill, le suivi de marqueurs, les ombres d'acteurs sur la CG, l'appariement du grain et la composition en lumière linéaire.

Qu'est-ce que Lightning Emperor ?

Lightning Emperor est un workflow complet destiné aux artistes VFX et aux intégrateurs travaillant avec des outils comme Claude Code, Cursor ou Codex. Il permet de composer des éléments CG (rendus avec Blender/Cycles) dans des plans live-action, en remplaçant un fond vert ou bleu. Le projet fournit des outils sous trois formes : un serveur MCP, une interface en ligne de commande (CLI) et un add-on Blender. L'ensemble du processus est guidé par des règles strictes pour éviter les erreurs coûteuses : mesurer le plan avant de décider, obtenir l'échelle absolue de deux manières, trouver la lumière clé à partir des acteurs, et composer en lumière linéaire. Le workflow se décompose en étapes : 1) Appareil photo (distance, pose, overscan), 2) Éclairage (côté clé, calibration des lumières CG), 3) Keying et despill, 4) Suivi de caméra par homographie, 5) Ombres des acteurs, 6) Appariement du grain, 7) Composition d'un essai, 8) Remise à l'artiste. Chaque étape est accompagnée d'outils spécifiques et de documents de référence détaillés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LucidMach/LightningEmperor/tree/HEAD/skill/lightning-emperor

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. Ne remplacez jamais les originaux. Vérifiez les tailles/durées d'entrée avant un long rendu ; conservez les fichiers source intacts.
  9. 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

BesoinOutil MCPCLIAdd-on
Objectif/exposition depuis fichier caméraread_camera_metadatametadataPanneau Plateau
Aligner un export avec le fichier caméraalign_clipalign
Distance sujetsolve_camera_distancedistanceSujet + caméra
Pose caméra, taille de renduplan_camera, build_shot_sceneCréer caméra de prise
Éclairageplan_lightsLumières
Images d'éléments allumé/éteintpractical_statesClignotement
Rendu des états CGrender_statesRendu CG
Matte + despillkey_framekeyOutils Plateau
Suivi de marqueurstrack_markerstrackOutils Plateau
Décalage d'ombreshadow_offsetshadow-offset
Grainmeasure_graingrainOutils Plateau
Composition d'une imagecomposite_framecomp

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.

Skills associés