Product Launch Motion
Uma disciplina de produção para criar filmes de lançamento que parecem ter sido feitos por um motion designer — não um slideshow com narração sobreposta.
O resultado é um MP4 renderizado. O meio é HTML, CSS e GSAP, renderizado quadro a quadro por um renderizador determinístico baseado em seek (HyperFrames por padrão). Tudo aqui é transferível para qualquer renderizador que possa buscar uma linha do tempo; as leis são neutras em relação ao renderizador, os exemplos de encanamento são do HyperFrames.
Esta skill existe porque ferramentas verdes não são o mesmo que um bom filme. Uma composição pode passar no lint, renderizar sem erro e ainda ser um slideshow. O valor abaixo é o ofício que separa os dois, mais as armadilhas que custam horas reais para encontrar — cada uma registrada com a medição que a prova, não com a vibração que a sugeriu.
É uma disciplina, não um template. As leis abaixo são fixas; a aparência não é, e decidi-la é seu trabalho como diretor. Dois filmes construídos a partir desta skill devem ser inconfundivelmente diferentes um do outro — paleta, terreno, personalidade da câmera, tipo, textura, som e estrutura diferentes — porque estão defendendo argumentos diferentes para públicos diferentes. Antes de construir qualquer coisa, escreva três direções visuais genuinamente diferentes e mate duas: references/11-creative-direction.md. Alcançar a aparência do filme de referência porque está documentado aqui é o único modo de falha que torna todo o resto inútil.
Quando usar isso
Use para: um filme de lançamento de produto ou anúncio de funcionalidade (20–90s), um vídeo hero para página de destino, um demo reel, um sizzle de conferência, um filme de atualização para investidores ou um resgate em um vídeo que "parece básico".
Não use para: edição de talking head, gravação de tela com legendas colocadas por cima ou qualquer coisa onde a entrega seja uma página web ao vivo em vez de um arquivo de vídeo.
As dez leis
Quebre uma e o filme parece amador, por mais boas que sejam os quadros individuais. Observe o que elas não cobrem: nenhuma delas diz como o filme deve ser.
1 · Verdade primeiro. Cada número, logotipo, rosto, screenshot e depoimento na tela é real e tem origem. Antes de animar qualquer coisa, anote os números aprovados — a lista exata de numerais permitidos — e recuse qualquer outro número. Métricas inventadas e rostos de banco de imagens são a maneira mais rápida de fazer um produto real parecer falso. → references/02-story-and-truth.md
2 · Sincronia palavra-a-palavra. Cada revelação é acionada pelo tempo de início medido da palavra que ilustra. Não para uma grade de batidas, não para uma estimativa — para uma transcrição no nível da palavra do arquivo de narração real. Um quadro em t=0 mostra apenas o que a voz está dizendo em t=0. → references/03-word-locked-sync.md
3 · Determinismo. Sem Math.random, sem Date.now, sem transições CSS, sem repeat/yoyo. Qualquer valor disperso ou ruidoso é derivado de um índice ou do playhead. Um seek para o tempo T deve reproduzir saída idêntica byte a byte, ou sua renderização é uma loteria. → references/01-renderer-contract.md
4 · Uma câmera, dois nós. Uma rotação de plano inteiro e uma escala de plano médio devem viver em elementos diferentes. No mesmo elemento, eles disputam uma matriz de transformação e o movimento trepida. Nó externo = dolly (escala), nó interno = giro 3D (rotação + perspectiva). → references/05-camera-3d-cursor.md
5 · O cursor é um adereço de palco. Um ponteiro em tamanho real (~32px em 1920) desaparece em qualquer controle saturado. Desenhe-o com ~44×54, um contorno pesado e uma sombra profunda, coloque-o dentro do nó que a câmera move e coloque a origem do zoom exatamente no controle que ele clica — esse ponto se torna um ponto fixo da transformação e a mira sobrevive ao zoom sem matemática compensatória. → references/05-camera-3d-cursor.md
6 · Som é aritmética, não gosto. O volume de uma deixa não pode resgatar um arquivo de origem baixo. Se o ativo está 20 dB abaixo do leito da narração, aumentar seu volume move a mixagem em décimos de dB — medido, não adivinhado. Nivele o ativo, então verifique se a deixa caiu no arquivo entregue. → references/07-sound-and-master.md
7 · Nada termina em movimento. Cada plano se resolve. O movimento é acionado pelo significado; um plano ainda à deriva quando corta parece um protetor de tela, e um plano onde tudo deriva independentemente também parece um. Escopo: isso governa a resolução, não a imobilidade. Um filme de take único cuja câmera nunca para satisfaz isso desacelerando para descansar antes do final; um plano que mantém um movimento lento deliberado enquanto seu conteúdo está estabelecido também satisfaz. O que proíbe é um plano cortando enquanto a coisa que estava dizendo ainda está chegando. → references/04-motion-grammar.md
8 · Racionando o destaque. Dois terrenos (um para o argumento, um para o produto), uma cor ou gradiente de destaque e um orçamento escrito para onde pode aparecer — tipicamente: uma palavra de ênfase por título, numerais de estatísticas, o passo ativo, mudanças de estado, o CTA. Um terceiro matiz é quase sempre um erro. → references/06-look-and-grade.md
9 · Portas verdes são necessárias, não suficientes. Passagens de lint, layout e contraste não pegam nenhuma das coisas que tornam um filme ruim. Após cada renderização, extraia quadros do arquivo entregue nas batidas que você mudou, olhe para eles e escreva o que está errado antes que qualquer outra pessoa o faça. → references/08-qa-and-direction.md
10 · Sem estilo de casa. A aparência é derivada da reivindicação, marca, público e categoria deste produto — nunca herdada do último filme ou dos exemplos neste repositório. Escreva três direções diferentes, escolha uma e dê ao filme um movimento de assinatura que nenhum outro filme tem. Um filme que poderia ser de um concorrente com o logotipo trocado não tem direção. → references/11-creative-direction.md
Bandeiras vermelhas
Estes são os pensamentos que precedem cada etapa pulada. Cada um é um sinal para parar e fazer a coisa que você está prestes a se convencer a não fazer.
| O pensamento | O que realmente significa |
|---|---|
| "Vou estimar os tempos e corrigir depois" | Você não vai. Cada deixa estará errada, e redescobri-las todas custa mais do que fazer uma vez agora |
| "Três direções é exagero para esta" | Você tem uma ideia e nenhuma base para acreditar que ela é boa. Duas das três estão destinadas a morrer |
| "A marca é roxa, então esta paleta está bem" | Verifique se você a derivou ou herdou dos exemplos aqui |
| "Para mim, soa bem" | Você está ouvindo na máquina que renderizou, em um volume que escolheu, sabendo o que ouvir. Meça |
| "A mudança está na fonte, então está no filme" | Dois bugs documentados na história deste repositório foram exatamente isso. Amostre o arquivo entregue |
| "As portas passaram" | Portas pegam quebrado, não ruim. Elas nunca pegaram um filme chato |
| "É um pequeno ajuste, não precisa verificar novamente" | Pequenos ajustes são como um mestre de −14 LUFS se tornou um clippado |
| "Vou apenas sobrescrever a última renderização" | Então você não pode provar que a correção funcionou, e a versão que o diretor preferiu se foi |
| "Eles disseram para fazer 3D, então vou adicionar rotação" | Leve a observação como um sintoma, não uma especificação. "Faça 3D" significava um rig de câmera, uma reconstrução de cursor e uma refatoração de coordenadas |
| "Vou adicionar o movimento da câmera no final" | Uma câmera muda o que cada coordenada significa. Adaptar um rig significa refazer cada posição no plano |
| "Está quase na palavra" | 200ms de diferença parece lag para um espectador que não consegue nomear o porquê |
Violar a letra de uma lei é violar a lei. "Quase determinístico" é não determinístico; "aproximadamente na palavra" está fora da palavra.
O pipeline
Quatorze etapas. Não pule 1, 2, 5 ou 13 — são as que as pessoas pulam e são as que decidem se o filme é bom.
Etapas 1–3 são um loop, não uma sequência: a direção depende de quais ativos reais existem, e a passagem de verdade frequentemente mata uma direção por completo (você não pode filmar um filme de produto com luz de contraluz para um produto que não foi fabricado). Cicla-as até que concordem, então vá em frente.
| # | Etapa | Saída | Referência |
|---|---|---|---|
| 1 | Intake — o produto, o público, a ÚNICA afirmação, o ângulo (geralmente o título do próprio produto) | BRIEF.md | assets/BRIEF.md |
| 2 | Direção — três direções visuais genuinamente diferentes, julgadas e cortadas para uma, mais um movimento de assinatura | bloco de direção | references/11-creative-direction.md |
| 3 | Passagem de verdade — colete ativos reais, telas reais, clientes reais e corrija a lista de números aprovados | assets/, lista de figuras | references/02-story-and-truth.md |
| 4 | Roteiro — 40–60s escrito para o ouvido; uma cláusula por batida; a afirmação cai nos primeiros 10s | SCRIPT.md | references/02-story-and-truth.md |
| 5 | Narração — renderize ou grave a VO antes de construir qualquer coisa; as durações dos quadros vêm do comprimento real da VO | assets/voice/*.wav | references/03-word-locked-sync.md |
| 6 | Tempos de palavra — transcreva com carimbos de tempo no nível da palavra em uma tabela de deixas | audio_meta.json | scripts/word-timings.mjs |
| 7 | Storyboard — quadros, durações, o mapa de registro da sua direção e um plano por batida | STORYBOARD.md | references/09-shot-catalog.md |
| 8 | Construir quadros — um arquivo HTML por quadro; rig de câmera e cursor do esqueleto; cada tween com deixa para uma palavra | compositions/frames/*.html | references/04-motion-grammar.md |
| 9 | Montar — índice, transições, áudio, grade — nesta ordem, sempre | index.html | references/01-renderer-contract.md |
| 10 | Portas — lint/runtime/layout/motion com a grade ligada; contraste com a grade desligada | 0 erros | references/08-qa-and-direction.md |
| 11 | Renderizar + masterizar — loudnorm de duas passagens, limitador, re-codificar | renders/*.mp4 | scripts/master.sh |
| 12 | Verificar no arquivo entregue — quadros nas batidas alteradas, níveis das deixas medidos | evidência | scripts/verify-cue.sh |
| 13 | Dirigir — assista, liste os defeitos você mesmo, corrija, re-renderize como um NOVO arquivo | v2, v3, … | references/08-qa-and-direction.md |
| 14 | Entregar o conjunto — corte vertical, legendas, poster, loop, stills, licenças | deliverables/ | references/12-deliverables.md |
Ordem de construção (etapa 9) não é negociável
O índice é gerado, então qualquer coisa adicionada manualmente é destruída na remontagem e deve ser reinjetada. Cada script de fiação aqui é idempotente (ele substitui seu próprio bloco marcado), então o movimento seguro é sempre re-executar toda a cadeia:
node scripts/assemble.mjs # film.json + VO medida → index.html
node scripts/transitions.mjs # as travessias entre os quadros
node scripts/wire-audio.mjs # leito musical + deixas SFX sincronizadas com palavras
node scripts/wire-grade.mjs # grão + vinheta + varreduras especulares
assemble.mjs lê film.json (assets/film.example.json é um preenchido) e mede cada quadro de sua narração com ffprobe, para que você nunca digite uma duração. Ele aplica a aritmética da qual cada deixa downstream depende: hold = VO + pad — a respiração após a última palavra, porque um plano que corta na última sílaba parece apressado — e duration = hold + a transição de saída. O próximo quadro começa em hold, não em duration; a diferença é a sobreposição na qual a transição vive.
Mapa de referência
Carregue apenas o que a etapa atual precisa.
| Arquivo | O que contém |
|---|---|
references/11-creative-direction.md | Leia isto primeiro. O que é fixo e o que é livre, os mostradores de direção, derivar uma aparência do produto, divergir para três direções, o movimento de assinatura, cinco direções trabalhadas e as verificações anti-uniformidade |
references/01-renderer-contract.md | Como HTML se torna vídeo: trilhas temporizadas, a linha do tempo buscável, regras de determinismo, ordem de construção e o que fazer no Remotion em vez disso |
references/02-story-and-truth.md | Ângulo, arco, o mapa de registro, a disciplina de números aprovados, regras de honestidade e como obter ativos reais para qualquer produto |
references/03-word-locked-sync.md | Obter tempos de palavra, escrever a tabela de deixas, ritmo, seguras, e por que a VO vem primeiro |
references/04-motion-grammar.md | Easing, entradas, escalonamentos, antecipação, rampas de velocidade, tipo cinético e os dois modos de falha (slideshow / protetor de tela) |
references/05-camera-3d-cursor.md | O rig de câmera de dois nós, toca-discos, dolly, zoom para detalhe, rack focus, paralaxe z e a especificação completa do cursor falso |
references/06-look-and-grade.md | Racionamento de paleta, bordas de vidro sem backdrop-filter, grão de filme, vinheta, varreduras especulares e a armadilha do modo de mistura |
references/07-sound-and-master.md | Design de SFX, sub-graves, silêncio antes da batida heroica, a lei da aritmética de volume, nivelamento de ativos e a cadeia de masterização |
references/08-qa-and-direction.md | As portas, revisão de snapshot, verificação do arquivo entregue e o loop do diretor que transforma um v1 em um v7 |
references/09-shot-catalog.md | 14 construções de plano para adaptar — prompt/compositor, lista de resultados, espaço de trabalho, rastreador de pipeline, contagem de estatísticas, depoimento, comparação, hero de hardware, terminal, mapa, gráfico, cartão final. Nunca uma ordem de execução para copiar |
references/10-traps.md | Cada armadilha que encontramos, cada uma com a medição que a prova. Leia isto antes de depurar qualquer coisa |
references/12-deliverables.md | O conjunto que realmente é enviado: re-layouts verticais, áreas seguras da plataforma, legendas a partir dos seus tempos de palavra existentes, quadro de pôster, loops, nomeação e entrega |
Scripts
Todos são Node/bash com poucas dependências, todos idempotentes, todos seguros para re-executar.
| Script | Faz |
|---|---|
scripts/assemble.mjs | Escreve index.html a partir de film.json, medindo o comprimento de cada quadro de sua narração em vez de permitir que você o adivinhe |
scripts/transitions.mjs | Injeta as travessias entre quadros — dissolve, zoom-through, push, cut — no instante em que a narração de cada quadro termina |
scripts/wire-audio.mjs | Monta um leito musical + uma tabela de deixas de SFX no índice montado, resolvendo tempos de deixa relativos ao quadro contra inícios reais de quadro |
scripts/wire-grade.mjs | Injeta a grade do filme: grão semeado pelo playhead, vinheta e varreduras especulares em momentos que você passa (--sweeps 7.9:0.9,…; sem varreduras a menos que você as queira |
scripts/master.sh | Fluxo ffmpeg de duas passagens: loudnorm → loudnorm → limitador → re-codificar h264, mantendo metadados e deixando um arquivo WAV mestre para verificação |
scripts/verify-cue.sh | Extrai a amostra em torno de um carimbo de tempo, mede o pico verdadeiro e imprime se a deixa caiu nos níveis esperados |