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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Nunca sobrescribas los originales. Verifica los tamaños/duraciones de entrada antes de un render largo; mantén los archivos fuente intactos.
- 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
| Necesidad | Herramienta MCP | CLI | Addon |
|---|---|---|---|
| Lente/exposición desde archivo de cámara | read_camera_metadata | metadata | Panel de placa |
| Alinear una exportación con el archivo de cámara | align_clip | align | |
| Distancia al sujeto | solve_camera_distance | distance | Sujeto + cámara |
| Pose de cámara, tamaño de render | plan_camera, build_shot_scene | Crear cámara de toma | |
| Rig de luces | plan_lights | Luces | |
| Fotogramas de encendido/apagado práctico | practical_states | Parpadeo | |
| Render de estados CG | render_states | Renderizar CG | |
| Mate + despill | key_frame | key | Herramientas de placa |
| Seguimiento de marcadores | track_markers | track | Herramientas de placa |
| Desplazamiento de sombra | shadow_offset | shadow-offset | |
| Grano | measure_grain | grain | Herramientas de placa |
| Comp de un fotograma | composite_frame | comp |
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.