Files
jhonny-editor/code/plugins/premiere-pro/skills/editar-por-voz/criterios/05-zoom.md
T
João Henrique 9edde2df37 feat: aprimorada a edição por voz com validação de frases, margens
- aprimorada a edição por voz com validação de frases, margens seguras e backup único antes da timeline.
- adicionada consulta expansível dos detalhes de cada trilha diretamente do banco

Resumo:
- 23 arquivos alterados
- 5 novos
- 18 modificados
- 0 removidos

 18 files changed, 321 insertions(+), 216 deletions(-)

Arquivos:
  - .gitignore
  - .jhonny/analises.db
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/cep-plugin/styles.css
  - code/engine/analisar_trilhas.py
  - code/engine/aplicar_plano_de_edicao.py
  - code/engine/editor/__init__.py
  - code/engine/editor/backup_de_sequencia.py
  - code/engine/persistencia/__init__.py
  - code/engine/testes/test_aplicar_plano_de_edicao.py
  - code/plugins/premiere-pro/skills/edit-video-by-voice/SKILL.md
  - code/plugins/premiere-pro/skills/editar-por-voz/SKILL.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/05-zoom.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/06-texto-corte-marcador.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/08-formato-de-saida.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/10-revisao-humana.md
  - code/plugins/premiere-pro/skills/transcript-to-edit-actions/SKILL.md
  - code/engine/consultar_detalhes_de_trilha.py
  - code/engine/editor/validacao_semantica.py
  - code/engine/persistencia/leitura_semantica_do_plano.py
  - code/engine/testes/test_leitura_semantica_do_plano.py
  - code/engine/testes/test_validador_semantico_de_plano.py
2026-09-10 14:38:42 -04:00

3.3 KiB
Raw Blame History

05 — Zoom (punch-in)

Escopo: Onde dar punch-in, qual janela e qual escala — e o que a escala significa além do zoom. Quando: Fase 5 — ver a ordem de trabalho em ../SKILL.md.

Quando usar

No momento em que o argumento vira. Um pico acústico só merece zoom se for também um pico de sentido.

Palavra gritada sem peso narrativo não ganha nada — e isso inclui os picos que caem em artigos e conectivos, que são picos de entrega, não de conteúdo.

A janela

start — na palavra de ênfase.

end — no fim da frase. A frase inteira, não o fim do segmento da transcrição.

O Whisper corta frases no meio, por respiração e não por gramática:

"Aquela mama com um formato mais estruturado, que valoriza o seu colo, que dá aquele ar" | "de elegância, isso é desejo de muitas mulheres, né?"

Soltar o zoom no fim do primeiro segmento libera no meio do pensamento — é o que faz um punch-in parecer arbitrário. suggest_zoom_windows já estende até a pontuação final (. ! ? …), e nunca atravessa uma fronteira de tomada.

A forma — o programa decide sozinho

Você escolhe start e end; a forma sai da posição da janela dentro do trecho:

Situação Comportamento Por quê
Começa a >0,5s do início do trecho entrada rápida (~0,25s) o movimento chega junto com a palavra
Começa a ≤0,5s do início entra já ampliado, sem transição o corte já foi a transição; uma rampa ali lê como a imagem se acomodando
Frase termina no meio do trecho saída seca, 1 frame volta ao enquadramento sem chamar atenção
Frase termina a ≤1s do corte não volta — segura até o corte o próximo trecho já abre no enquadramento dele; voltar antes é movimento desperdiçado

Os limiares são diferentes de propósito: no fim o corte esconde um retorno inacabado, mas no início a rampa é visível desde o primeiro frame.

Para forçar manualmente, existem start_at_peak e hold_at_end — mas o automático acerta na quase totalidade dos casos.

Escala

Valor Uso
1,15 sutil
1,18 – 1,3 padrão
1,5 forte

Em vídeo institucional, fique na faixa baixa. Acima de 3,0 é rejeitado.

Não espalhe zoom "por segurança". Cada ação é aplicada diretamente ao clipe e excesso de escala vira trabalho de correção manual. Zoom não ativa legenda nem muda o texto por efeito colateral no fluxo atual.

O zoom é relativo ao enquadramento existente: se o clipe já tem escala 1,77 (material gravado de lado e reenquadrado), um zoom 1,18 anima de 1,77 para 2,09 e preserva rotação e posição.

Dois zooms no mesmo clipe

Depois do corte, dois picos que você escolheu podem cair no mesmo trecho sobrevivente (nenhum corte os separou em clipes distintos) — é comum quando a corrida limpa de uma tomada é longa. O sistema resolve isso sozinho, e a regra é a mesma que rege o resto: janelas distantes empilham (os dois zooms convivem, cada um voltando ao enquadramento real entre um e outro); janelas que se sobrepõem substituem (é o mesmo evento sendo reajustado, não dois). Você não precisa calcular isso na hora de decidir — só respeitar o min_gap de 07-ritmo.md, que já garante que dois zooms escolhidos por você nunca se sobrepõem.