Imperador Relâmpago: Composição de CG em placa
Um fluxo de trabalho mais ferramentas para colocar CG atrás ou ao redor de atores em live-action. As ferramentas existem de três formas, todas executando o mesmo código:
o servidor MCP (lightning-emperor-mcp), a CLI (lightning-emperor ...) e o add-on do Blender. Prefira as ferramentas MCP quando
estiverem conectadas; caso contrário, use a CLI. Este arquivo é o julgamento: o que medir, o que dá errado, como verificar seu próprio trabalho.
Regras que evitam os erros caros
- Meça a placa antes de decidir qualquer coisa. Lente, sensor, exposição, balanço de branco, cor e intensidade da tela, ruído, de onde vem a luz. Dez segundos de medição valem mais que uma hora de adivinhação.
- Acerte a escala absoluta primeiro, e de duas formas. A escala do CG em relação aos atores depende diretamente da distância câmera-objeto. Meça-a a partir do tamanho em pixels de algo conhecido (uma cabeça tem cerca de 0,24 m do topo ao queixo) e a partir da distância de foco da lente no arquivo da câmera. Se discordarem, pare e resolva. Uma distância mal medida faz todo o conjunto CG ficar com o tamanho errado em todos os quadros. Nunca adicione um fator de ajuste para esconder um erro de escala.
- Encontre a luz principal a partir dos atores, não de um briefing ou foto do set. Compare os dois lados de um rosto em luz linear. Fotos do set mostram quais luzes existem; a placa mostra qual domina.
- Componha em luz linear e diga o que a placa é. Vídeo referenciado a exibição: linearize, misture, recodifique. Não suponha log porque uma imagem parece chapada.
- Olhe a imagem no tamanho real e em recortes. Miniaturas escondem spill, buracos e franjas. Sempre abra a pré-visualização que uma ferramenta escreve antes de confiar em um matte.
- Uma correção pode ser pior que o bug. Após cada correção, reolhe o quadro inteiro e remeça o que você estava protegendo.
- Você não pode assistir vídeo. Meça movimento com números (tamanhos de passo, trepidação) e diga claramente o que apenas os olhos do usuário podem julgar.
- Nunca sobrescreva originais. Verifique tamanhos/durações de entrada antes de uma renderização longa; mantenha arquivos fonte intocados.
- Seja direto sobre limitações. Quando o usuário diz que algo parece errado, ele quase sempre está certo: investigue, reporte números, diga o que você errou.
Fluxo de trabalho
0. Intake. Examine cada arquivo. Leia os metadados da câmera se o formato permitir (read_camera_metadata / lightning-emperor metadata): distância focal (houve zoom?), distância de foco, ISO, balanço de branco.
Pergunte apenas o que muda o trabalho: onde o CG fica em relação aos atores, altura da câmera, formato de entrega.
1. Câmera. solve_camera_distance a partir de um tamanho conhecido na placa e do foco da lente; exija agree: true. Depois plan_camera (pose, tamanho de overscan, pixels por metro).
Renderize com overscan (cerca de 1.25) para que o movimento rastreado nunca revele a borda da renderização.
2. Iluminação. Encontre o lado da luz principal a partir dos rostos. plan_lights fornece posições e cores iniciais (azimute 0 = da câmera, +90 = direita da câmera, cores em kelvin).
Calibre a exposição do CG com uma medição na placa (pedaço de pele, fundo), não a olho. Práticos piscando: practical_states fornece os quadros para renderizar (ligado/desligado).
3. Key. key_frame e abra preview_on_grey.png. O key auto-calibra para a tela, mas leia references/keying.md para o que verificar (buracos em roupas escuras, castigo de cor spill, marcas deixadas como ilhas).
4. Rastreamento (apenas se a câmera se move e o fundo é substituído). track_markers segue uma constelação de marcadores com uma homografia por quadro. Leia references/tracking.md: quadros com poucos marcadores são ruidosos, um fundo plano é um plano (uma homografia é o modelo certo), nenhum marcador à vista significa que você está segurando ou interpolando.
5. Sombras. shadow_offset calcula onde a sombra de um ator cai sobre um fundo a partir da geometria da luz e da distância ator-parede. Veja references/shadows-and-grain.md.
6. Granulação. measure_grain a partir da área plana da tela; aplique ao CG para que não pareça colado. Meça na resolução final.
7. Composição. composite_frame em um único quadro primeiro. Verifique o tamanho da parede em relação aos atores, lado da sombra, bordas, níveis de preto, depois escale. Renderize trabalhos longos em blocos e verifique as contagens de quadros.
8. Entrega. Quando o rastreamento não puder ser confiável por um trecho, dê a um artista passes em camadas e uma flag honesta de qualidade por quadro, não um composto falso-finalizado.
Mapa de ferramentas
| Necessidade | Ferramenta MCP | CLI | Add-on |
|---|---|---|---|
| Lente/exposição do arquivo de câmera | read_camera_metadata | metadata | Painel da placa |
| Alinhar uma exportação com o arquivo de câmera | align_clip | align | |
| Distância do objeto | solve_camera_distance | distance | Objeto + câmera |
| Pose da câmera, tamanho de renderização | plan_camera, build_shot_scene | Criar câmera de cena | |
| Rig de luzes | plan_lights | Luzes | |
| Quadros ligado/desligado de práticos | practical_states | Piscar | |
| Renderização de estados CG | render_states | Renderizar CG | |
| Matte + despill | key_frame | key | Ferramentas de placa |
| Rastreamento de marcadores | track_markers | track | Ferramentas de placa |
| Deslocamento de sombra | shadow_offset | shadow-offset | |
| Granulação | measure_grain | grain | Ferramentas de placa |
| Composição de um quadro | composite_frame | comp |
Erros de ferramenta retornam como {"error": "..."} com o motivo; corrija a entrada e tente novamente.
Blender executa como jobs headless. Nunca tente abrir um socket que execute código dentro de uma janela do Blender em execução.
Referências (leia no estágio em que se aplicam)
references/failure-modes.md- o que dá errado, por que e a correção. Folheie primeiro.references/scale-and-distance.md- o erro de distância da câmera e as regras que o previnem.references/lighting.md- encontrar a luz principal real, construir e calibrar o rig.references/compositing.md- matte, quatro tipos de spill, pedestal, suavidade, light wrap, verificações.references/camera-metadata.md- o que os arquivos de câmera dizem, e alinhar uma exportação a eles.references/review.md- como usar agentes críticos sem se enganar.references/keying.md- matte, despill, tratamento de bordas, e o que filmagens reais nos ensinaram.references/tracking.md- rastreamento de marcadores, estabilização, lacunas.references/shadows-and-grain.md- geometria de sombra, medição e correspondência de granulação.references/blender-notes.md- notas de script do Blender 4.2-5.x para trabalho headless.