web594/resolve-multicam-workflow

Criar Projeto de Filme no Resolve (wunder-media)

Pipeline comprovada dos projetos Projeto-A → Projeto-C → Projeto-B. Sempre seguir este fluxo, não reinventar. Pasta de trabalho por projeto: C:\claude\resolve-prep\<nomecurto>\.

Ler primeiro (nesta ordem)

1. references/ablauf.md — os 8 passos de materiais brutos até o corte multicâmera finalizado com título. As "decisões" anteriormente abertas agora estão respondidas em Permissões e respostas fixas — não pergunte novamente.
2. references/api-werkzeuge.md — o que o Resolve pode fazer via script (rctl.py, grade-set, node-add, Fusion, modelo de título) e onde estão os limites rígidos da API.
3. references/fallstricke.md — armadilhas aprendidas a duras penas. Antes de cada passo, verifique rapidamente se há algo lá sobre o passo atual. Isso evita a maioria dos becos sem saída.
4. ⭐ references/farbgebung.md — qual skill de look será usado: o padrão é resolve-kino-look-nodekette, a alternativa é resolve-lut-look-kette; LUTs/ferramentas compradas primeiro; e a verificação da câmera (camcorder de consumo Rec.709 → emulação de filme nenhuma ou apenas pouquíssimos %). Leia antes de cada correção de cor. Depois references/kino-look-nodekette.md — a mesma cadeia como receita com todos os valores medidos e o modelo DRX (cadeia inteira em 0,04 s em vez de uma hora de cliques).
5. ⭐ references/vorbild-projekt.md — o modelo para projetos multicâmera: estrutura de pastas, estado desejado da mídia (incluindo o bin Criar), o fluxo de cor comprovado e o limite Claude ↔ Humano. Leia para cada projeto multicâmera — descreve exatamente o estado até o qual o Claude cria de forma autônoma.
6. references/timecode-sync.md — variante para o passo 2: câmeras executam o Atomos AirGlu com timecode compartilhado → offsets diretamente dos arquivos em vez de correlação cruzada. Contém a configuração do dispositivo (servidor/cliente, região Europa, a armadilha "Fonte trava no HDMI") e a contraprova obrigatória vorlagen/tc_pruefen.py. Leia quando os materiais brutos vierem de Shogun/Ninja Ultra e tiverem timecode.
7. references/grafik-einblendungen.md — passo 9: inserir infográficos/overlays e exportar o vídeo (YouTube longo + Instagram curto). Leia sempre para séries de palestras/entrevistas com palestrantes recorrentes antes de criar gráficos.
8. vorlagen/ — scripts de modelo prontos para uso (do Projeto-B, o projeto mais limpo). Copie para C:\claude\resolve-prep\<nomecurto>\, ajuste as constantes do cabeçalho, execute. overlay_tools.py é executado diretamente (check / zoomsafe / mov / place).

Resumo do fluxo

#	Passo	Ferramenta
1	Inspecionar materiais brutos (ffprobe: câmeras, partes, fps, canais de áudio, Log/Rec709)	references/ablauf.md
2	Sincronizar áudio com o áudio principal (Tascam/dr10L), offsets como JSON	vorlagen/sync.py
2b	Com gravadores Atomos com AirGlu: offsets diretamente do timecode em vez de correlação cruzada — comprove antes com tc_pruefen.py	references/timecode-sync.md, vorlagen/tc_pruefen.py
3	Criar projeto + bins + importar + timeline de origem por câmera	vorlagen/prep.py
4	Transcrição (faster-whisper large-v3, CUDA)	vorlagen/transcribe.py
5	Plano de corte automático a partir de pausas de fala (parâmetros calmos, veja abaixo)	vorlagen/make_cutplan.py
6	Timeline de corte. Com ≥2 câmeras SEMPRE multicâmera com cortes — clipe multicâmera via construção DRT, NÃO via GUI	vorlagen/mcbuild/build_mc_drt.py
6b	Prova de áudio e vídeo (obrigatória): a timeline de corte está COMPRIMIDA em relação ao tempo de áudio (partes puladas sem imagem) - recortar o áudio, depois medir	vorlagen/sync_pruefen.py
7	Verificar (lacunas, sobreposições, ângulos, renderização de tela preta), depois correção de cor (skill resolve-kino-look-nodekette, nós compartilhados)	vorlagen/verify_cut.py, references/farbgebung.md
8	Pós-processamento: encontrar o início correto, remover partes organizacionais, trocar ângulos tremidos/desfocados; título de abertura (overlay)	references/ablauf.md
8b	Limpeza + entrega: timelines temporárias no bin Criar, verificar o estado desejado contra o modelo	references/vorbild-projekt.md
9	Sobreposições gráficas + entrega (infográficos a partir da transcrição, Instagram curto 9:16, legendas, −14 LUFS)	references/grafik-einblendungen.md, vorlagen/overlay_tools.py, vorlagen/infografik/, vorlagen/verify_overlays.py, vorlagen/instagram_kurz.py

Pré-requisito sempre: Resolve em execução, Configurações → Sistema → Geral → "Scripting externo" = Local. Se scriptapp("Resolve") is None → reiniciar o Resolve completamente.

⛔ NÃO ESQUECER: O multicâmera é criado COMPLETAMENTE via script — nunca com o mouse

Instrução do usuário (27/07/2026, expressamente): Este conhecimento não pode ser perdido novamente, e DEVE ser executado assim, não de outra forma. Versões anteriores deste skill afirmavam que o clipe multicâmera só poderia ser feito "manualmente na GUI". Isso está errado. Ele é construído com vorlagen/mcbuild/build_mc_drt.py → import_mc2.py → verify_mc.py (verificado em 27/07/2026, Resolve 21.0.3: clipe multicâmera + 21 ângulos cortados sem um único clique).

Resumo do procedimento (detalhes em references/ablauf.md passo 6):

1. Construir timeline de corte aninhada (apply_cut.py) e exportar como DRT (Timeline.Export(caminho, 1)).
2. Exportar um DRT como modelo de um projeto antigo com multicâmera qualquer.
3. build_mc_drt.py insere no novo DRT um elemento <Sm2MpMulticamClip> + um SeqContainer de definição (uma faixa por câmera, UserDefinedName = "Ângulo N", MediaRef = DbId da timeline de origem) e redireciona os clipes de corte para o multicâmera.
4. ImportTimelineFromFile → timeline de corte multicâmera pronta.

⭐⭐ A única armadilha onde falha: A associação Sequência multicâmera → contêiner de definição não está no XML de texto simples, mas sim codificada em UTF-16 nos FieldsBlobs zstd MpFolder.xml. Portanto, nunca gere novos UUIDs — os DbIds do elemento multicâmera, sequência e contêiner do modelo devem ser mantidos inalterados (o Resolve atribui novos IDs na importação de qualquer forma). Caso contrário, um clipe multicâmera sem ângulos: Frames 0, tela preta.

Permissões e respostas fixas — NÃO perguntar novamente

O usuário já decidiu; o Claude implementa sem questionar e cria o projeto até o corte multicâmera finalizado com título de forma autônoma.

Permissões a serem obtidas imediatamente no início (não perguntar individualmente):

• Liberar uso do computador imediatamente: request_access(["DaVinci Resolve"]), motivo "Controlar o Resolve (multicâmera, correção de cor, títulos)". Cobre toda a pipeline; só pergunte novamente se um programa ADICIONAL for necessário. Inicie o Resolve via open_application se necessário.
• Scripts/verificação executados via Bash + py C:\claude\resolve-ctl\rctl.py … e os scripts de modelo — parte integrante, apenas execute (sem necessidade de perguntar).
• Mídia offline (projeto criado em outro disco, ex.: E: → F:)? Vincular novamente sem perguntar: mp.RelinkClips(clips, r"<Pasta do projeto no disco atual>").

Respostas técnicas fixas (nunca perguntar novamente): 0. Ritmo de corte: ligeiramente mais calmo que antes (usuário, 27/07/2026). No Projeto-A, alguns cortes vieram cedo demais: após um corte, o espectador precisa de alguns segundos para se ajustar à nova imagem — se uma contraposição curta vier logo em seguida, parece agitado. Poucos segundos a mais por plano são suficientes. Valores em make_cutplan.py: MIN_SHOT 6.0, CUT_MIN 6.0, CUT_MAX 11.0, PARA_GAP 1.2, MAX_STD 50, CALM_GAP 12.0 (pausa de calma: nenhum novo cutaway após esse intervalo), divisão mecânica 55/42/10. Além disso: primeiro trecho sempre câmera principal e nenhum cutaway antes do início do conteúdo (ANFANG), caso contrário, um corte cai logo atrás do início do filme.

1. ≥2 câmeras → SEMPRE entregar o multicâmera cortado (clipe multicâmera real via construção DRT, vorlagen/mcbuild/), para que o usuário possa alternar cada clipe para uma câmera diferente ao editar. Não pergunte mais "Nesting ou multicâmera". ⭐⭐ Isso também se aplica a TODO vídeo derivado — versão curta, trecho, cópia de trabalho, versão Instagram (usuário, 23/08/2026, expressamente): Elas devem ser timelines multicâmera reais com os ângulos do corte principal, caso contrário, o usuário não pode trocar mais nenhum plano no ajuste fino. ⛔ AppendToTimeline com o clipe multicâmera NÃO é suficiente — embora clipes multicâmera apareçam na timeline de destino, todos no Ângulo 1; a escolha do ângulo se perde. O ângulo está apenas no FieldsBlob do clipe e não pode ser definido pela API. Caminho correto: vorlagen/kurzvideo_drt.py + vorlagen/kurzvideo_import.py (exportar o corte principal como DRT, adotar clipes dos trechos desejados com FieldsBlob inalterado, recalcular Start/Duration/In, importar; depois ajustar o áudio por trecho via API para A1). A correção de cor vem junto no DRT. 1b. ⭐⭐ Taxa de quadros de reprodução = Taxa de quadros da timeline — DEFINIR IMEDIATAMENTE ao criar (usuário, 23/08/2026). proj.SetSetting("timelinePlaybackFrameRate", "<fps>") deve entrar no mesmo bloco de configurações que timelineFrameRate, antes de criar a primeira timeline. Se estiver errada (padrão geralmente 24), o áudio soa mal durante a reprodução — e assim que uma timeline existe no projeto, SetSetting se recusa a alterar (False, mesmo no nível da timeline). Na interface ainda funciona: engrenagem no canto inferior direito → Configurações principais → Formato da timeline → digitar "Taxa de quadros de reprodução" → Salvar. Definir ao criar evita esse desvio.
2. Look — o padrão está definido, NÃO pergunte sobre a direção, apenas construa (usuário, 18/08/2026). Detalhes e a verificação da câmera: references/farbgebung.md.
   • ⭐ Padrão: Skill resolve-kino-look-nodekette — a cadeia de 4 nós Emulação de filme → Balanço de branco+Brilho (ajustável) → LUT de finalização (40%) → Gerador de look de filme (Halation/Vinheta). Completamente transferível via DRX (0,04 s). Requer projeto em DaVinci YRGB (não Color Managed).
   • Alternativa: Skill resolve-lut-look-kette — a mesma ideia como cadeia pura de LUT (Log→ARRI Rec.709 · Nó ajustável · Rec.709→ARRI LogC · Emulação de filme · Look de cinema). Use se os plugins estiverem faltando/não forem compatíveis com a câmera, uma série já estiver construída sobre ele ou o usuário desejar.
   • Em ambas as cadeias, primeiro as LUTs e ferramentas COMPRADAS; as versões gratuitas apenas se uma ferramenta estiver faltando ou a câmera não tiver perfil no plugin.
   • ⚠️ Antes de construir, verifique quais câmeras estão no projeto. Material Log (FS7 II, S-Log3) → Cadeia conforme planejado. Camcorder de consumo Rec.709 (Sony AX100, CX900E e similares) → Emulação de filme nenhuma ou apenas pouquíssimos %, caso contrário, as cores ficam artificiais; obter o caráter cinematográfico pelos outros nós. → Sempre construa a cadeia de nós, sem perguntar. Apenas confirme o brilho fino.
3. LUTs APENAS para esses três passos de look. Qualquer correção (balanço de branco, brilho, dominante de cor/ Magenta/Azul, saturação, contraste) como valor de nó ajustável no Resolve, nunca como uma LUT adicional embutida — para que permaneça rastreável o que se desvia do original e valores individuais possam ser revertidos.
4. ⭐ Mesmos conteúdos de nós entre câmeras = NÓS COMPARTILHADOS (Shared Nodes): os nós de look idênticos (conversão ARRI, estoque de filme, cinema) como nós compartilhados, para que uma alteração afete TODOS os clipes/câmeras. Apenas correções específicas da câmera (ex.: ajuste de longe → perto) permanecem locais. Detalhes em references/ablauf.md/fallstricke.md. 4b. ⭐⭐ Nó de balanço de branco: UM nó compartilhado por ângulo — sempre configurar assim (usuário, 24/08/2026, expressamente "por favor, lembre-se para sempre"). O nó ajustável 2 ("Balanço de branco + Brilho") se torna por ângulo um nó compartilhado que fica em todos os clipes desse ângulo — então uma correção altera todo o ângulo de uma vez. Ele não é compartilhado entre ângulos (cada ângulo tem valores próprios). Os nós de look 1/3/4 já são compartilhados. Receita (verificada em 24/08/2026 no Projeto-M, 3 ângulos × 21/22 clipes):
   1. Na timeline … import do ângulo, vá para um clipe de referência (SetCurrentTimeline + SetCurrentTimecode, OpenPage("color")).
   2. Um único clique de uso do computador: Clique com o botão direito no nó 2 → "Salvar como nó compartilhado". (A API não pode fazer isso; um clique é aceitável.)
   3. Todo o resto via script: refItem.CopyGrades(todos_os_outros_clipes_do_ângulo) — CopyGrades transfere nós compartilhados como o mesmo objeto, o rótulo em todos se torna … Shared Node <n>. Isso também se aplica entre timelines: as cópias das timelines do ângulo que surgem na importação DRT dos vídeos curtos (… nah import 1…12), inclua no mesmo passo, caso contrário, os vídeos curtos ficam presos em uma correção antiga e não transportada.
   4. Verificar: Ler os rótulos dos nós (todos iguais?) e medir um quadro por ângulo.
   5. Resolver junto: Definir interpolação de LUT para tetraédrica — Shift+9 → Gerenciamento de cor → "Look-up-Tables" → "Interpolação 3D-LUT" → Salvar (nenhuma chave de API).

4c. ⭐ Excluir cópias não utilizadas de nós compartilhados no final (usuário, 27/08/2026, para sempre). Cada aplicação de uma DRX/cadeia de look que contém nós compartilhados cria na lista de nós compartilhados uma nova entrada, em vez de usar a existente — com aplicação por clipe, portanto, uma cópia por clipe (Projeto-M: 198 entradas, das quais apenas 12 usadas, 186 arquivos mortos, todas byte-idênticas). A imagem permanece correta, mas a lista se torna inutilizável e o banco de dados do projeto cresce.

• Evitar: Aplicar a cadeia uma vez...

... [truncado para tradução]