Animador Stickman
Você escreve scenes.js - um film.scene(id, sc => { … }) por clipe em film.json, mesmos ids, mesma ordem. Tudo é JavaScript puro no navegador contra o motor global SM. Leia references/api.md (cola completa) e references/cookbook.md (receitas copiáveis) antes de escrever.
Modelo mental
- Tempo local. Dentro de uma cena, cada tempo é em segundos a partir do início do clipe.
sc.dur= duração do clipe. - Encadeável. Cada ação retorna o tempo em que termina:
const t = bob.walkTo(900, 0.2); bob.wave(t); - Sincronizado com a voz.
sc.cue("palavra")= tempo local estimado em que o narrador diz aquela palavra (sc.cue(["palavra", 1])= 2ª ocorrência,sc.cue(0.5)= metade do VO). Coloque o visual na ou logo antes da palavra (sc.cue("ideia") - 0.15). - Camadas.
world(ambiente) →back(adereços) → figuras →front(adereços sobre figuras) →ui(espaço da tela, ignora câmera) →top(transições). Passe{ layer: "front" }/"ui"para adereços. - Coordenadas. A tela tem
sc.W × sc.H(1920×1080, 1080×1920 ou 1080×1080).sc.groundYé o chão (80% para baixo na paisagem, 74% no retrato). Figuras ficam em pé comy= seus pés. - Coisas. Adereços, texto, gráficos, formas são
Things:.pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show. - Oculto até a entrada. Crie com
{ hidden: true }depois.pop(t); o texto fica oculto até.in(t, fx).
Esqueleto de cena
const film = SM.film(); // tema/formato vêm do film.json
film.scene("hook", sc => {
sc.enter("fade"); // opcional, combinar com saída anterior
sc.ground(); // linha do chão (estilo: "grass" | "none")
const bob = sc.figure({ x: -150, face: "dots" }); // ou sc.character("zeke", {...})
const t1 = bob.walkTo(sc.W * 0.35, 0.2);
bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("isto"));
const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
chart.grow(sc.cue("cresceu"));
sc.text("Receita [duplicou]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("duplicou") - 0.1, "words");
sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3); // aproximação lenta
sc.exit("wipe-left");
});
Intros & Outros
Clipes que declaram "intro" / "outro" em film.json se constroem sozinhos. Você não precisa de uma cena para eles. Para adicionar extras (adereços explodindo ao redor do título, uma figura acenando para o CTA), escreva a cena e chame o preset você mesmo; a versão automática é então ignorada:
film.scene("intro", sc => {
const t = sc.intro("countdown", sc.clip.intro); // retorna quando o título pousou
sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
sc.exit("wipe-left");
});
film.scene("outro", sc => {
sc.enter("fade", { color: "bg" });
sc.outro("kino", sc.clip.outro);
sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});
Regras de direção (o que faz parecer bom)
- Algo muda a cada 2-3 s. Planeje 3 batidas por clipe; preencha lacunas com um zoom de câmera, uma piscada/concordada, um balanço de adereço, um destaque.
- Cenário antes de animar. Decida onde a figura, o adereço principal e o texto vão viver (terços em 16:9; empilhados em 9:16). Mantenha o texto longe da cabeça da figura e de outros textos.
- Figuras agem, não ficam paradas. Use gestos que significam algo:
pointpara o que está sendo discutido,thinkantes de uma ideia,surpriseem uma revelação,shrugem um mito,celebrateem uma vitória,push/climb/runTopara esforço. - Uma entrada focal de cada vez; espaçe por 0.1-0.2 s quando várias coisas aparecerem.
- Combine saídas e entradas entre clipes (mesmo tipo de transição) ou corte combinado (mesma pose/posição de objeto).
- Acentos carregam significado:
"a1"problema,"a2"solução,"a3"recompensa. Passe nomes de cores:"a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper"ou hexadecimal. - Verdade do chão: figuras ficam em pé sobre
sc.groundY(ou uma superfície que você computou); adereços que descansam no chão usamy = sc.groundY - size*0.4. - Retrato: figura
size: 420-460, adereços 200-300, texto 70-120, mantenha a faixa do meio ocupada e legendas baixas.
Verificar (loop obrigatório)
stickman check <dir>→ deve dizer Check passed.page_error= seu JS lançou um erro; corrija.stickman snapshot <dir>(ou--attempos em batidas chave) → abrasnapshots/contact-sheet*.jpge os PNGs e olhe. Corrija: clipes, sobreposições, figuras flutuando, momentos vazios, texto ilegível, braços atravessando cabeças (ajuste overrides de pose), cores de acento erradas.- Execute novamente até estar limpo, depois renderize.
Pegadinhas
- Agende cada figura cronologicamente.
celebrate()agenda um retorno astandem +1.0 s; passe{ hold: true }se for posar novamente logo depois. bob.hold(prop)prende à mão direita e permanece na vertical; crie antes de usar e.pop(t).- Marcação de texto:
"[palavras acentuadas]"colore uma frase com a opçãoaccent(padrãoa2). - Gráficos contam números com passos discretos; dê
prefix/suffix/decimalsnas opções do gráfico. - Não use
Math.random/Date/setTimeout. UseSM.rng(seed). - GSAP puro é permitido:
sc.tl.to(el, vars, sc.T(localTime))- mantenha como uma função pura do tempo.