Film build (Construção de Filme)
Início
sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<filme> # recusa uma pasta não vazia
cd marketing/videos/<filme> && npm i && npx playwright install chromium # se disser NEXT
O kit fornece a você:
| Arquivo | O que é |
|---|---|
film/core.js | a engine: scene({name, from, to, build, run, after}) (tempos em beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start() |
film/film.js | um inicializador com todos os helpers abaixo e quatro shots de exemplo (linha, prompt, divisão, cartão de persona). O comentário de cada helper diz de qual rejeição veio. Substitua os shots, mantenha os helpers. |
film/mock.js | window.MOCK: HTML para peças reais de UI (dashboards, janelas, telas de celular), em px de tela |
film/index.html | carrega fontes de assets/fonts/{display,ui}.woff2 (com fallbacks sans locais) |
scripts/render.mjs | --sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all |
scripts/sync.mjs | copia timeline.json para a página |
scripts/review.py | kit de crítica a partir do MP4 renderizado: contact sheet, tiras de ação mais rápida, visualização de telefone, zonas seguras 9:16, métricas |
tools/probe.mjs | cuts (cada corte e o ponto médio de cada shot, em segundos de vídeo) ou qualquer expressão, ex.: "window.UNWARP(12.4)" |
tools/sheet.py | organiza stills em uma única folha legendada |
tools/pack_grid.py | corta uma folha de personagem 4×3 (transparente ou em branco) em uma tira de 12 células para sprite(); imprime o tamanho da célula |
tools/cut_cast.py | corta uma fila de uma linha em stills de personagens individuais |
assets/characters/ | quatro personagens de exemplo (fundador, desenvolvedor, vendedor, estudante), tiras de 12 quadros com células de 360 px |
tools/same.sh | save / check regressão PSNR entre stills antes e depois |
Helpers no inicializador (use-os, não reinvente)
io(quíntico in-out) para movimentos de câmera e morphs;oq(quíntico out) para entradas;backpara um pequeno overshoot.cam(e, s, fx, fy)coloca o ponto de foco (fx, fy) de um plano 1920×1080 no centro do quadro na escala s.camDfaz o mesmo mas nunca mostra além das bordas do plano (escala de cobertura; essencial em 9:16).posIn(e, root)lê a posição de um elemento dentro do plano em movimento (para alvos do cursor, acompanhamento de cursor).typed()para palavras aparecendo letra por letra em uma linha;keyed()para um teclado real: temporização irregular por caractere, pausas mais longas em espaços, um cursor piscando depois.wordsHTML()coloca cada palavra em sua largura final desde o primeiro quadro, transparente até seu momento, para que a linha nunca reflua ("transição de texto não é suave de jeito nenhum").cursor()/putCursor()/bump(): um cursor de seta real que desliza, chega cedo, mergulha 15% em um clique.pop()para itens pequenos pousando.sprite(parent, src, cellW, cellH, h)/putSprite(e, t, a, z, loops)para um personagem desenhado: percorre seus 12 quadros de a a z, com uma pequena respiração para que nunca fique parado. É um<img>, então a engine espera por ele.shot(name, t0, t1, build, run)envolvesceneem segundos.- Warp de ritmo na parte inferior:
SLOW(esticamento global),EVsegura (congela um momento para leitura) e inserções;window.CUTSewindow.UNWARPfornecem tempos de vídeo para posicionamento de som e voz. PT/pk(a16, a9)escolhe valores por formato em um arquivo.
Regras da engine (determinismo)
O filme é uma função pura de t. Qualquer quadro deve pintar igual seja renderizado primeiro ou após qualquer outro quadro.
- Apenas transforms 2D: sem
translate3d, semwill-change, sem transições CSS, semMath.random(use um hash de um índice). - Elementos ocultos no início:
reg(el, {o: 0}), nuncaopacity:0inline. - Meça layout em
after()ou uma vez embuild, nunca dentro derun(ele lê o quadro anterior). - Visualizações 3D: reinsira cada quadro com
insertBefore(v, firstChild)para que nenhum raster em cache sobreviva. - Animações CSS incorporadas (ex.: widget de produto próprio): pause-as e defina
animation-delay: calc(-1s * var(--t)). - Aguarde imagens e fontes (
decode(),document.fonts.ready) antes do primeiro quadro. - Escopo CSS do produto sob uma classe raiz única; use nomes de classe únicos no filme (
.wvazou uma vez). classList.add, nuncaclassName =.node scripts/render.mjs --verifydeve imprimir 12/12 antes de qualquer renderização que você enviar.
Realismo: leia references/realism.md antes de construir qualquer tela
Versão curta: aplicativos reais em densidade real, logotipos reais dos próprios sites das marcas, chrome do SO com aplicativos que existem naquele SO, papéis de parede reais, telefones na grade real do launcher em tamanhos reais de dp desenhados pelo próprio renderizador do produto, UI do produto mais rica do que você pensa que precisa ser, uma linha de uso nominativo sempre que uma marca aparecer.
Loop de construção (orientado por revisão)
- Lista de shots do storyboard aprovado em
film.js, umshot()cada, sobrepostos para transições. - Stills primeiro.
node tools/probe.mjs cuts→ renderize um still no ponto médio de cada shot e em cada transição:node scripts/render.mjs --at …entãopython3 tools/sheet.py review/stills/16x9 review/sheet.jpg <tempos>. Leia a folha você mesmo. Corrija. Repita. (Cerca de 1–2 min por rodada, vs 25+ para uma renderização completa.) - Passo de QA antes de QUALQUER revisão que você enviar: percorra o filme em ≤ 1,5 s e em cada transição (contact sheet de 10–15 fps sobre cada transição). Verifique
references/qa.mdlinha por linha: sobreposições, clipping, quadros em branco, tempo de leitura, suavidade do texto, digitação, aviso de logotipo, realismo do SO, tamanhos de telefone. - Envie stills (a folha) para o proprietário para a primeira olhada. Aguarde.
- Rascunho:
node scripts/render.mjs --draft(30 fps, ~4 min),python3 scripts/review.py 1 --draft, leia as tiras. Envie o MP4 do rascunho. Diga claramente que é um rascunho de 30 fps sem blur (parece mais entrecortado que o final). - Ao "renderizar final":
node scripts/render.mjsem segundo plano (60 fps, motion blur; ~25–35 min para 60 s). Nunca editefilm.jsenquanto renderiza: copie o projeto primeiro se precisar continuar trabalhando. - Commit código do filme e timeline após cada rodada aprovada.
Ritmo
Os primeiros cortes são quase sempre muito rápidos. Texto na tela precisa de cerca de 0,3 s por palavra + 1 s com opacidade total (nunca menos de 1,5 s). Prefira o warp (SLOW 1,1–1,25, EV segura em linhas) a reajustar o tempo de cada shot. Após qualquer mudança de ritmo, execute novamente probe.mjs cuts porque as posições de som e voz se movem.
9:16: leia references/formats.md
Reenquadre o mesmo filme em um arquivo com pk(); prove que 16:9 não foi alterado com tools/same.sh (cada still PSNR = inf); --verify --fmt 9x16; folha de stills para o proprietário; então --fmt 9x16 final em segundo plano, depois --mux --fmt 9x16.