Animação pintada
Um método para fazer curtas-metragens animados inteiramente em código, destilado de JohnHeibel/PDoomVideo (um videoclipe de 156 s pintado por Claude Opus) e seu kit generalizado ClaudeAnimationBase (MIT), que está incluído aqui como template/.
Como funciona: cada quadro é uma função pura do tempo t. O studio.html carrega p5.js + p5.brush e seus arquivos de cena; cada cena pinta o quadro inteiro 1920×1080 com preenchimentos aquarelados e linhas de nanquim em ebulição. O render.mjs comanda o Chrome headless para renderizar folhas de contato para revisão, ou cada quadro em paralelo, e o ffmpeg codifica o MP4 (com áudio, se fornecido).
Fluxo de trabalho
0. Estruturação inicial
bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir> # use --keep-demo para manter a cena de exemplo conectada
Isso copia o template, desconecta a cena de exemplo, executa npm install e verifica node / ffmpeg / Chrome. Em seguida, leia <project-dir>/ANIMATION_GUIDE.md na íntegra antes de projetar qualquer coisa: ele contém as regras, os princípios de animação e a API completa do motor / Clawd. Veja docs/emotions.jpg e docs/views.jpg (as folhas de modelo) com a ferramenta Read.
Para um videoclipe ou qualquer coisa com mais de ~20 s, leia também references/music-video.md. Para um vídeo com letra, peça o arquivo da música e um LRC primeiro, e meça o andamento com scripts/beat_grid.py: as linhas geralmente são mais rápidas do que você imagina.
1. Storyboard antes do código
Escreva STORYBOARD.md no projeto (formato no guia: logline, arco do mundo + paleta, motivo, arco emocional do personagem, depois cenas com leituras — a lista temporal do que o espectador deve entender). Exemplo prático: examples/xiaozhen/ (um videoclipe com letra de 31 s: storyboard e código completo da cena).
Mostre o storyboard ao usuário e deixe-o reagir antes de construir, a menos que ele tenha dito para ir em frente.
2. Construa cena por cena
- Defina
duration,bpm,offset(eaudio) emsrc/config.js. - Um arquivo por cena/capítulo em
src/scenes/, envolto em IIFE, terminando comshots([[t0, fn], ...]); adicione seu<script>aostudio.html. - Bloqueie as principais poses primeiro, verifique-as como imagens estáticas, depois adicione o movimento entre elas.
3. Renderize e veja — cada cena, várias vezes
Você não pode ver o movimento lendo código. A partir do diretório do projeto:
node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg # quadros-chave
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg # cada quadro de um momento
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg # detalhe em resolução total
Abra cada imagem com Read e verifique-a contra a lista de revisão do guia: evento claro? personagem grande o suficiente? leituras temporizadas para que um espectador de primeira viagem as entenda? antecipação / acompanhamento, sem cortes secos? pés e objetos segurados tocando o chão? transições em cada emenda? sem texto, sem 3D, sem preto/branco puro, sem brilhos sujos? Corrija e veja novamente. Orçamento: ≥ 1 folha por cena, uma tira por movimento chave e transição, um recorte por rosto que carrega a história.
4. Renderize o vídeo
node render.mjs --clip --out=out/video.mp4 # vídeos curtos, um worker
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3] # longos, paralelo + retomável
Informe o caminho de saída, duração e ms/quadro. Ofereça open out/video.mp4.
As regras que mais importam
Estas são as regras do guia condensadas; o guia é a autoridade final.
- Meio artesanal. Apenas
paint()/inkLine()(p5.brush) — nuncarect/ellipse/fillsimples do p5. Apenas 2D plano: giros passam por vistas chave desenhadas (turn(),spinView()), nunca projeção 3D. Iluminação viaglow()(aditiva), porque misturar pigmentos faz amarelo sobre azul virar verde. - Sem texto. Sem legendas, rótulos, placas ou balões de fala; mostre em vez disso. Reações são emotes pintados (
!, suor, corações…). A única exceção é o karaokê em um vídeo com letra, e no máximo alguns grandes SFX. - Algo acontece em cada cena — um evento, causa → reação, preparações que se pagam.
- Tempo para o espectador. Liste as leituras de cada cena; uma leitura de cada vez; ações rápidas, significados mantidos; guie o olhar; as leituras definem a duração da cena. É aqui que a animação gerada mais falha.
- Vivo. Nada está parado (sons de parado de
feel(), câmeras à deriva, ebulição); rostos mudam através deemotions()nunca por troca; o personagem é grande (plano médio u≈20–28, close-up 40–70); tudo segue o ritmo. - Transições em cada emenda, escolhidas para se adequar à história (escovada, íris / íris modelada, panning com chicote, corte combinado, corte em ação, câmera contínua).
- Uma peça só. Um mundo, um arco de cores, um fio emocional, cenas ligadas, um final que rima com a abertura.
Peculiaridades do motor
- Funções puras de
t. Os quadros são renderizados em paralelo e fora de ordem: sem estado entre quadros, semMath.random(), sem física quadro a quadro. Usehash(i)para aleatoriedade estável,jit()para ebulição. boilSeed(key)antes de cada elemento/prop de fundo separado, ou uma coisa em movimento faz com que tudo desenhado depois dela fervilhe novamente a cada quadro (tremulação).- Não nomeie globais com o nome de funções do p5. p5 define
line,OVERLAY,text,color,scale, … como globais; umafunction line()no nível superior falha comCannot redefine propertye a página nunca fica pronta (o renderizador expira). Mantenha auxiliares dentro da IIFE da cena ou dê a eles nomes distintos. - Camadas em portas, janelas e telas: desenhe o que está dentro, depois pinte a parede/quadro ao redor novamente sobre ele, para que nada mais largo que a abertura apareça do lado de fora (os batentes da porta do trem, as peças da moldura da TV).
- Um
NaNem uma lista de pontos lançaFailed to construct 'OffscreenCanvas'— proteja geometria degenerada. - Sob zoom de câmera ≳ 2, formas enormes perdem contornos; o peso do contorno escala com o zoom, então reduza
swem close-ups. - Custo = número de preenchimentos e traços. Almeje ≤ ~1.5–2.5 s/quadro (o log imprime ms/quadro). Prefira menos formas, maiores. Em máquinas sem uma GPU real, os preenchimentos aquarelados são lentos — considere menos formas
fill, ou--soft-glcomo último recurso. - macOS: o renderizador usa
--use-angle=metale encontra/Applications/Google Chrome.appautomaticamente; caso contrário, passe--chrome=<path>.
Adaptação
- Clawd é a estrela padrão, não um requisito. Novos personagens, props e emoções são desenhados com as mesmas ferramentas (
paint,ribbon,through,glow) e mantidos no modelo entre cenas; novas emoções vão emEMOemsrc/clawd.js. src/karaoke.js(template) adiciona karaokê palavra por palavra para vídeos com letra via o ganchowindow.overlayHookemcore.js.LOOPS.name = t => {...}; LOOPS.name.len = 4;+node render.mjs --loop=name --pngcria um loop sem emendas para GIFs (ffmpeg -i out/loop_name/f%04d.png …).- Um esforço de raciocínio mais alto tende a dar cenas mais extravagantes e detalhadas.