Stickman Video Master Skill — Do Roteiro ao Reel Final
Um pipeline completo e testado: curtas de terror/mistério em Hindi (1080×1920, 30fps) que são criados por código — pesquisa, roteiro, design de personagens, construção de cenas, narração, mixagem, controle de qualidade. Produção de referência: Reel de Bhangarh (o vídeo de demonstração está no repositório — demo/demo_10s.mp4, e todo o código no mesmo estilo está nas pastas code/ e vo/).
PASSO 0 — Pesquisa (antes do roteiro)
- Pesquisa aprofundada sobre o local/história real: Wikipedia + fontes oficiais (como placas do ASI — evidências primárias).
- Marque cada alegação: [DOCUMENTADO] (com evidência) · [LENDA] (folclore) · [NÃO ENCONTRADO] (não inclua no roteiro).
- Nunca inclua alegações virais falsas — sempre verifique. (Lição de Bhangarh: "único forte onde é proibido entrar à noite" estava ERRADO, removido do roteiro.)
- Verifique a demanda: assista aos maiores vídeos do YouTube sobre o mesmo tópico — qual ângulo funcionou (visita noturna, close-up da placa, história pura)?
PASSO 1 — Roteiro
- Primeira frase = o evento inteiro (gancho). A pista para a resposta está escondida na primeira linha/quadro.
- Cada frase 6–12 palavras; total ~150 palavras ≈ 49 seg @ ~190 ppm.
- Dê NOMES aos personagens. Revelação primeiro, "porque" depois.
- No meio, um desafio ao "você" + no final um comentário de uma palavra (SIM ou NÃO?).
- Muletas: "na verdade / ou seja / olhe com atenção / pense um pouco". PROIBIDO: palavras de IA (mistério, fato, emoção, sensação).
- Regra de diálogo: apenas 2–4 diálogos selecionados na voz dos personagens; o resto é narração. Nenhum diálogo inventado.
- Verificação de ritmo: VO 2,3–2,7 palavras/seg · pausa morta >12% = corte · título não deve estragar a resposta.
PASSO 2 — Storyboard + Bloqueio Geométrico
- Linha → tabela de cena (t0–t1 de cada linha definido primeiro). Depois, bloqueio de coordenadas ASCII: chão (FLOOR) de cada cenário, posições dos personagens, câmera em cada batida.
- Esboço primeiro, aparência depois — sem esboço, NÃO vá direto para o código final.
PASSO 3 — Design de Personagens (código code/my_builder.js)
- Personagem = ator SVG projetado (~640 unidades): braço FK de 2 segmentos (quadril→joelho, ombro→cotovelo), juntas redondas, formato de rosto em forma de mandíbula por papel.
- Cada papel tem um paleta de DNA: pele, íris, roupa, marca especial (maang-tikka, tilak, pagri).
- Detalhes da testa (tilak) feitos DEPOIS da camada de cabelo — senão ficam escondidos embaixo do cabelo.
- API de atuação:
setFaceMood·lookEyes·poseArms·speakHuman(formatos de lábios) ·walkHuman(ciclo de caminhada real — deslizamento = FALHA GRAVE). - Mãos: palma + polegar + linhas dos dedos. Loop de piscar + respiração em cada ator.
- Referência de qualidade: personagem NÃO deve ser feito de formas primitivas (cabeça redonda, corpo cilíndrico) — apenas caminhos esculpidos são aceitos.
PASSO 4 — Design de Cenário (código code/my_head.js, my_scenes_a/b.js)
- Materiais primeiro: cada superfície com gradiente multi-parada (iGrad) + sombra projetada real; cor sólida = FALHA.
- Cômodo = casca 3D: parede traseira + paredes laterais em perspectiva + polígono do chão + rodapé.
- Parede de pedra: cada pedra com tom diferente + linha de destaque + manchas de intempérie (textura procedural de pedra) — repetição de azulejo de banheiro = FALHA.
- Pedreira/rocha: polígono irregular de 12 pontos + 3 tons de faceta + trinca + mancha de areia + sombra de contato. Octógono/laje = FALHA GRAVE.
- Adereços vivos: lâmpada balançando, chamas de havan + fumaça, corvos, névoa (leve!) — mas NÃO deixe os efeitos FX ligados; cada FX deve ter um momento OFF obrigatório.
- Lei da câmera: antes de cada
camTo, calcule a parte inferior da vista —cy + 960/s ≤ 1920, senão o céu/faixa preta aparecerá na parte inferior do quadro. - O retângulo do céu deve ter sempre altura total.
PASSO 5 — Montagem + Renderização
- Núcleo do motor = prefixo de qualquer HTML montado (shell svg#stage + defs + rig + helpers E/iGrad/makeCam/seekWrap) + arquivo de cena + tags de fechamento. Mantenha
gsap.min.jsjunto — não coloque cópias de arquivo em cadeia&&(se uma falhar, todas param). - Timeline em GSAP; render determinístico por seek: Playwright 1080×1920 →
window.seekToTime(t)a cada frame → JPEG q88 → ffmpeg libx264 crf18. Renderize em chunks de ~20s (evite reinícios de VM), padrão de retomada (se frame >10KB, pule). - Lição do GSAP: em grupos que já têm transform (translate+scale), NÃO use tween x/y — use tweens absolutos de transform attr.
- Linhas de legenda longas: no script de render, execute um fixador
getComputedTextLength() > 1030comtextLength=1030. - Sinal do poseArms: girar armR para a esquerda do quadro = rotação POSITIVA. Personagem caído: com wrap −84°, a cabeça vai ~530 unidades para a esquerda — calcule a posição final da cabeça antes de definir o wrap.
PASSO 6 — Loop de Auto-auditoria (a cada cena)
- Gere stills de teste (meio de cada cena + quadros problemáticos) → veja você mesmo (incluindo zooms) → correções → gere stills novamente.
- 3 auditorias: Artística (composição, cores) · Física (anatomia, sombras, contato com o chão) · História (correspondência da narração, expressão não está invertida?).
- Pontuação /100; 95+ é o APROVADO FINAL. Falha grave (braço quebrado, objeto flutuante, sombra invertida, adereço trocado) anula a pontuação.
- Coloque faixa/legenda no espaço da tela: screen-y da cabeça = (wy − cy)·s + 960; faixa 118–222, legenda 1652+ para fora.
PASSO 7 — Narração (código vo/fit_lines.py)
- Modelo APENAS gemini-3.8-flash-tts (principal) / gemini-3.1-flash-tts-preview (fallback apenas para erro 429). 2.5 TTS PROIBIDO. Cota 10 chamadas/dia/modelo — calcule o orçamento primeiro.
- Narração = UMA única chamada, o roteiro inteiro de uma vez. Envie o texto RAW — estilo de direção longo deixa o ritmo 2,5× mais lento e às vezes até diz a direção.
- Vozes: narração Puck (preferência de Raj, padrão dos reels @i.raj1801) · vilão/outra voz Algenib.
- TTS WAV vem a 48000 Hz — matemática de pitch na taxa real: pitch ×1,12 = asetrate 53760 (NUNCA use rubberband — causa eco). Para engrossar o vilão, use ×0,96.
- Ajuste de linha: pegue os segmentos das tomadas do Whisper (modelo small, idioma
hi) → corte cada linha → compressão de pausa (silenceremove) → pitch → atempo por linha para encaixe exato na janela de legenda. - Forneça o WAV decodificado com stdlib wave+numpy do Python (PyAV
metadata_errorscausa TypeError).
PASSO 8 — Mixagem (código vo/mix.py)
- BGM de cada reel é FRESCO — nunca reutilize; licença segura (biblioteca Kevin MacLeod). Volume ~0,10, abaixo da VO.
- SFX no beat-map: whoosh (arremesso), impacto (batida/quedas), trovão (relâmpago/maldição), riser (antes da maldição).
- Loudnorm 2-pass (medir → aplicar linear) = −14,0 LUFS, TP ≤ −1,5. Single-pass frequentemente para em −15,8.
- Mux: cópia do stream de vídeo + AAC 192k.
PASSO 9 — QC Final + Entrega
- Ouça o arquivo entregue com Whisper — todas as linhas do roteiro estão na ordem/tempo corretos? Verificar apenas a tomada de origem não é suficiente.
- Verifique e informe duração, tamanho, LUFS — todos os três.
- Lição de entrega: não reutilize o nome do arquivo de vídeo — o app pode mostrar uma cópia antiga em cache. Cada nova entrega = novo nome (v2, _Final, data).
- Vídeos perfeitos (aprovados por Raj) são armazenados na pasta
Perfect_Videos/<data>/— apenas os perfeitos.
Guia de arquivos
script/Script_v1.md— roteiro de Bhangarh + tags verdade/história + verificação de ritmo (use como template)code/my_head.js— shaders, HUD, drawStoneWall / drawRealBoulder / drawPerfumeBottle / drawAsiBoard / drawHangingLampcode/my_builder.js— buildBhangarhActor (5 papéis, rig completo)code/my_scenes_a.js/my_scenes_b.js— 8 cenários + timeline + legendascode/props_snippet.js/api_snippet.js— árvores/grama + API de atuaçãocode/render_test.py/render_full.py— stills + render completo (com retomada)vo/fit_lines.py/vo/mix.py— ajuste de VO + mix finaldocs/— resumo do sistema visual + liçõesdemo/demo_10s.mp4— amostra de 10 segundos deste pipeline (o reel real não está público aqui)