Communitygithub.com

lightning-emperor

Fluxo de trabalho e ferramentas para composição de CG (Blender/Cycles) em placas de live-action, especialmente substituindo telas azuis ou verdes. Cobre correspondência de câmera (lente, sensor, distância do objeto medida de duas formas), correspondência de iluminação real, keying e despill, rastreamento de marcadores, sombras de atores no CG, correspondência de granulação e composição em luz linear.

O que é lightning-emperor?

O Lightning Emperor é um conjunto de habilidades focado em composição de elementos gerados por computador (CG) em placas de filmagem real (live-action), especialmente para substituir fundos de tela azul ou verde. Ele fornece um fluxo de trabalho completo e ferramentas para medir e ajustar a câmera (lente, sensor, distância do objeto), corresponder a iluminação real, fazer keying e despill de croma, rastrear marcadores, calcular sombras de atores sobre o CG, medir e aplicar granulação, e compor em luz linear. A habilidade é acessível via três modos: servidor MCP, CLI e um add-on do Blender, todos executando o mesmo código. É particularmente útil para artistas de VFX, técnicos de composição e desenvolvedores que precisam integrar CG em cenas reais de forma precisa, evitando erros comuns como escala incorreta, iluminação incompatível ou artefatos de keying. O sistema enfatiza a medição e verificação rigorosa antes de qualquer decisão, seguindo regras que previnem retrabalho caro. A documentação inclui referências detalhadas para cada etapa do processo, desde a medição da câmera até a entrega final, com ferramentas para cada necessidade mapeadas em uma tabela. A habilidade suporta Blender 4.2-5.x e opera em jobs headless, sem necessidade de interface gráfica aberta no Blender. A abordagem prioriza a honestidade sobre limitações: quando o rastreamento não é confiável, o sistema orienta a entregar passes em camadas com flags de qualidade, em vez de um composto falso-finalizado.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. Nunca sobrescreva originais. Verifique tamanhos/durações de entrada antes de uma renderização longa; mantenha arquivos fonte intocados.
  9. 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

NecessidadeFerramenta MCPCLIAdd-on
Lente/exposição do arquivo de câmeraread_camera_metadatametadataPainel da placa
Alinhar uma exportação com o arquivo de câmeraalign_clipalign
Distância do objetosolve_camera_distancedistanceObjeto + câmera
Pose da câmera, tamanho de renderizaçãoplan_camera, build_shot_sceneCriar câmera de cena
Rig de luzesplan_lightsLuzes
Quadros ligado/desligado de práticospractical_statesPiscar
Renderização de estados CGrender_statesRenderizar CG
Matte + despillkey_framekeyFerramentas de placa
Rastreamento de marcadorestrack_markerstrackFerramentas de placa
Deslocamento de sombrashadow_offsetshadow-offset
Granulaçãomeasure_graingrainFerramentas de placa
Composição de um quadrocomposite_framecomp

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.

Habilidades Relacionadas