Communitygithub.com

lightning-emperor

Flujo de trabajo y herramientas para componer gráficos generados por computadora (CG, Blender/Cycles) sobre placas de acción real, especialmente para reemplazar pantallas azules o verdes. Cubre la coincidencia de cámara (lente, sensor, distancia al sujeto medida de dos formas), la coincidencia de iluminación real, el keying y despill, el seguimiento de marcadores, las sombras de los actores sobre el CG, la coincidencia de grano y la composición en luz lineal. Úsalo cada vez que el usuario mencione componer CG sobre metraje, reemplazar una pantalla verde/azul o un fondo, fijar un set o pared CG a una placa, igualar la iluminación o cámara CG a una toma, spill, calidad de mate, vibración del seguimiento de cámara, captura de sombras, coincidencia de grano o renderizar una toma de VFX, incluso si nunca dice "VFX" o nombra una herramienta.

¿Qué es lightning-emperor?

Lightning Emperor es un conjunto de herramientas y un flujo de trabajo experto para integrar gráficos generados por computadora (CG) en placas de video de acción real, especializado en el reemplazo de pantallas verdes o azules. Está diseñado para agentes de IA como Claude Code, Cursor y Codex, y se utiliza para tareas que van desde la medición precisa de la cámara y la distancia al sujeto hasta la iluminación, el keying, el seguimiento de marcadores, la coincidencia de sombras y grano, y la composición final en luz lineal. Las herramientas están disponibles a través de un servidor MCP (`lightning-emperor-mcp`), una interfaz de línea de comandos (`lightning-emperor`) y un addon de Blender, todos compartiendo el mismo código subyacente. El flujo de trabajo sigue pasos secuenciales: ingesta de datos (lectura de metadatos de cámara), resolución de la cámara y distancia, planificación de iluminación (basada en la placa real, no en fotos de set), keying con autocalibración, seguimiento de marcadores, cálculo de sombras, medición de grano y composición de un solo cuadro para verificación. Incluye referencias detalladas para cada etapa, priorizando la medición numérica sobre la conjetura visual y aplicando reglas estrictas para evitar errores costosos, como medir la distancia al sujeto de dos formas diferentes o nunca sobrescribir archivos originales.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Lightning Emperor: Composición de CG sobre placa

Un flujo de trabajo más herramientas para poner CG detrás o alrededor de actores de acción real. Las herramientas existen de tres formas, todas ejecutando el mismo código: el servidor MCP (lightning-emperor-mcp), la CLI (lightning-emperor ...) y el addon de Blender. Prefiere las herramientas MCP cuando estén conectadas; de lo contrario, usa la CLI. Este archivo es el criterio: qué medir, qué sale mal, cómo verificar tu propio trabajo.

Reglas que evitan los errores costosos

  1. Mide la placa antes de decidir nada. Lente, sensor, exposición, balance de blancos, color y fuerza de la pantalla, ruido, de dónde viene la luz. Diez segundos de medición superan a una hora de conjeturas.
  2. Primero, obtén la escala absoluta correcta, y hazlo de dos formas. La escala del CG en relación con los actores depende directamente de la distancia de la cámara al sujeto. Mídela a partir del tamaño en píxeles de algo conocido (una cabeza mide aproximadamente 0.24 m de coronilla a mentón) y a partir de la distancia de enfoque del lente en el archivo de cámara. Si no coinciden, detente y resuélvelo. Una distancia mal medida hace que todo el set CG tenga el tamaño incorrecto en cada fotograma. Nunca agregues un factor de corrección para ocultar un error de escala.
  3. Encuentra la luz clave a partir de los actores, no de un brief o una foto del set. Compara los dos lados de un rostro en luz lineal. Las fotos del set muestran qué luces existen; la placa muestra cuál domina.
  4. Compón en luz lineal y di qué es la placa. Video referido a display: linealiza, mezcla, recodifica. No asumas log porque una imagen se vea plana.
  5. Observa la imagen a tamaño completo y en recortes. Las miniaturas ocultan spill, agujeros y bordes irregulares. Siempre abre la vista previa que escribe una herramienta antes de confiar en un mate.
  6. Una corrección puede ser peor que el error. Después de cada corrección, vuelve a mirar el fotograma completo y vuelve a medir lo que estabas protegiendo.
  7. No puedes ver video. Mide el movimiento con números (tamaños de paso, vibración) y di claramente qué solo los ojos del usuario pueden juzgar.
  8. Nunca sobrescribas los originales. Verifica los tamaños/duraciones de entrada antes de un render largo; mantén los archivos fuente intactos.
  9. Sé honesto sobre los límites. Cuando el usuario dice que algo se ve mal, casi siempre tiene razón: investiga, reporta números, di qué entendiste mal.

Flujo de trabajo

0. Ingreso. Examina cada archivo. Lee los metadatos de la cámara si el formato lo permite (read_camera_metadata / lightning-emperor metadata): distancia focal (¿hizo zoom?), distancia de enfoque, ISO, balance de blancos. Pregunta solo lo que cambie el trabajo: dónde se ubica el CG en relación con los actores, altura de la cámara, formato de entrega.

1. Cámara. solve_camera_distance a partir de un tamaño conocido en la placa y el enfoque del lente; requiere agree: true. Luego plan_camera (pose, tamaño de overscan, píxeles por metro). Renderiza con overscan (aproximadamente 1.25) para que el movimiento rastreado nunca revele el borde del render.

2. Iluminación. Encuentra el lado clave a partir de los rostros. plan_lights da posiciones iniciales y colores (azimut 0 = desde la cámara, +90 = derecha de la cámara, colores en Kelvin). Calibra la exposición del CG con una medición en la placa (parche de piel, fondo), no a ojo. Parpadeos prácticos: practical_states da los fotogramas para renderizar (encendido/apagado).

3. Key. key_frame y abre preview_on_grey.png. La clave se autocalibra con la pantalla, pero lee references/keying.md para saber qué verificar (agujeros en ropa oscura, tintes de color por spill, marcas dejadas como islas).

4. Seguimiento (solo si la cámara se mueve y el fondo se reemplaza). track_markers sigue una constelación de marcadores con una homografía por fotograma. Lee references/tracking.md: los fotogramas con pocos marcadores son ruidosos, un fondo plano es un plano (una homografía es el modelo correcto), sin marcadores a la vista significa que estás sosteniendo o interpolando.

5. Sombras. shadow_offset calcula dónde cae la sombra de un actor sobre un fondo a partir de la geometría de la luz y el espacio entre el actor y la pared. Consulta references/shadows-and-grain.md.

6. Grano. measure_grain desde el área plana de la pantalla; aplícalo al CG para que no parezca pegado. Mide a la resolución final.

7. Composición. composite_frame primero en un solo fotograma. Verifica el tamaño de la pared con los actores, el lado de la sombra, los bordes, los niveles de negro, luego escala. Renderiza trabajos largos en fragmentos y verifica los conteos de fotogramas.

8. Entrega. Cuando no se pueda confiar en el seguimiento en un tramo, dale al artista pases por capas y una bandera de calidad honesta por fotograma, no una composición falsamente terminada.

Mapa de herramientas

NecesidadHerramienta MCPCLIAddon
Lente/exposición desde archivo de cámararead_camera_metadatametadataPanel de placa
Alinear una exportación con el archivo de cámaraalign_clipalign
Distancia al sujetosolve_camera_distancedistanceSujeto + cámara
Pose de cámara, tamaño de renderplan_camera, build_shot_sceneCrear cámara de toma
Rig de lucesplan_lightsLuces
Fotogramas de encendido/apagado prácticopractical_statesParpadeo
Render de estados CGrender_statesRenderizar CG
Mate + despillkey_framekeyHerramientas de placa
Seguimiento de marcadorestrack_markerstrackHerramientas de placa
Desplazamiento de sombrashadow_offsetshadow-offset
Granomeasure_graingrainHerramientas de placa
Comp de un fotogramacomposite_framecomp

Los errores de las herramientas se devuelven como {"error": "..."} con la razón; corrige la entrada y reintenta. Blender se ejecuta como trabajos headless. Nunca intentes abrir un socket que ejecute código dentro de una ventana de Blender en ejecución.

Referencias (léelas en la etapa que corresponda)

  • references/failure-modes.md - qué sale mal, por qué y la corrección. Hojea primero.
  • references/scale-and-distance.md - el error de distancia de cámara y las reglas que lo evitan.
  • references/lighting.md - encontrar la luz clave real, construir y calibrar el rig.
  • references/compositing.md - mate, cuatro tipos de spill, pedestal, suavidad, envoltura de luz, comprobaciones.
  • references/camera-metadata.md - qué te dicen los archivos de cámara y cómo alinear una exportación con ellos.
  • references/review.md - cómo usar agentes críticos sin engañarte.
  • references/keying.md - mate, despill, manejo de bordes y lo que el metraje real nos enseñó.
  • references/tracking.md - seguimiento de marcadores, estabilización, espacios.
  • references/shadows-and-grain.md - geometría de sombras, medición y coincidencia de grano.
  • references/blender-notes.md - notas de scripting para Blender 4.2-5.x para trabajo headless.

Skills relacionados