O que toy-loops faz?
Pequenos mundos de artesanato em papel (uma ilha, um acampamento, um set de filmagem), Claude como ator, luz suave e quente e uma profundidade de campo rasa como uma miniatura. Cada objeto é construído a partir de código e cada quadro é calculado a partir do seu número, para que um loop feche exatamente. O visual foi estudado a partir das referências do Pimbo em anymation/3d_ref/style2 com a skill reference-video-analysis (primeira passagem: 3d_ref/style2/analysis/FIRST_PASS.md). Essas referências são material de estudo privado: copie a técnica, nunca as suas cenas.
Status: v1, 2026-11-18. Peças feitas com ele e verificadas:
claude_isla: aprovada por Pimbo ("esta épica").claude_fogata: o segundo loop.director_hero: uma imagem heroica para web de 2400x1200, feita em duas colorações.claude_pose: o recorte com olhos ao vivo para web.claude.glb: o modelo 3D.
Onde tudo vive
O código é uma pasta no PC do Pimbo: C:\Users\Pimbo\work\anymation\toy3d\skill. Todo caminho abaixo é relativo à sua pasta kit/, a menos que indicado o contrário.
| Caminho | O que é |
|---|---|
lib/toy.py | O visual: materiais de papel com bordas brancas biseladas, formas, luz, câmera, configurações de renderização |
lib/anim.py | As ferramentas do animador: curvas de suavização, Track (pose a pose), molas, squash, arc, looped |
lib/chars.py | Claude: o rig e seus seis conjuntos de olhos; .pose(...) uma vez por quadro |
lib/runner.py | Renderiza uma cena quadro a quadro; toda cena termina com runner.run(...) |
loops/<nome>/scene.py | Uma animação em loop |
stills/<nome>/scene.py | Uma imagem (T = 1) |
tools/make_loop.py | Renderizar, codificar GIF 1080/720 e MP4 x1/x3, QA, tabela de contato, em um comando |
tools/qa_loop.py | Costura do loop, contagem de quadros, pausas mortas, movimento comparado com as referências |
tools/duotone.py | Versão monocromática azul de uma imagem (estilo heroico para web) |
tools/web_eyes.py | Uma página web onde os olhos de Claude seguem o cursor, a partir de uma renderização sem olhos |
tools/claude_glb.py | O modelo Claude como um .glb (cores planas, bordas brancas mantidas), executado dentro do Blender |
out/<nome>/ | Saída: frames/, os arquivos, sheet.jpg, qa.json |
Peças finalizadas são copiadas para anymation/toy3d/videos/<nome>/; peças web ficam em anymation/toy3d/web/.
Necessita:
- Blender 5.2: a cópia portátil do Pimbo está em
anymation/tools/blender; em outros lugares defina$BLENDERou coloqueblenderno PATH. - ffmpeg no PATH.
- Python com numpy e Pillow, para as ferramentas.
Pimbo não executa scripts: você os executa e mostra a ele as imagens.
Regras que não se dobram
- Mostre antes de construir. Antes de um novo mundo ou personagem, renderize 2-3 imagens estáticas (
--frames ... --scale 0.5) e deixe Pimbo escolher. Olhe para cada imagem você mesmo antes de mostrá-la. pose(f)é uma função pura do quadro. Nenhum estado carregado entre quadros, nenhum número aleatório sem uma semente fixa, cada movimento periódico com um número inteiro de ciclos por loop. Efeitos que cruzam o final do loop usamlooped().- Anime como um animador (
references/ANIMATION.md). Escreva uma dope sheet primeiro, depois use poses-chave com curvas de suavização. Use antecipação antes de cada ação, compressão no impacto e estiramento na velocidade, sobreposição nos braços e trocas de olhos de um quadro. Nunca mova um corpo linearmente. - Um loop só está pronto quando o QA passa (
make_loop.pyimprime PASS/FAIL) e você olhou para uma tira quadro a quadro de cada ação (veja "Tiras" abaixo). - Diga o que foi medido [M], visto [V] e assumido [S].
Pipeline
| Etapa | O quê | Comando (a partir de kit/) |
|---|---|---|
| 1 | Ideia: lugar, uma pequena história com início e retorno ao loop; 6-9 s | falar com Pimbo |
| 2 | Copiar a cena mais próxima: loops/claude_isla (dia, externo) ou loops/claude_fogata (noite, adereços, efeitos) | |
| 3 | Construir o cenário, posicionar Claude, luz e câmera; olhar as imagens estáticas | python tools/make_loop.py <nome> --frames 0 --scale 0.5 |
| 4 | Comentário da dope sheet, depois os Tracks; renderizar as poses-chave | python tools/make_loop.py <nome> --frames 44,62,66,71,77,81 |
| 5 | Olhada rápida no loop inteiro | python tools/make_loop.py <nome> --preview (a cada 8 quadros) |
| 6 | Renderização completa + GIF + MP4 + QA | python tools/make_loop.py <nome> |
| 7 | Tiras de cada ação, corrigir, re-renderizar | veja "Tiras" abaixo |
| 8 | Copiar os arquivos finalizados para anymation/toy3d/videos/<nome>/ e enviá-los para Pimbo |
Tempos no PC do Pimbo (RX 6800 XT) [M]:
- EEVEE: cerca de 0.7 s por quadro 1080x1080, então um loop de 200 quadros leva cerca de 2.5 minutos.
- Cycles: cerca de 10 s por quadro e parece quase igual. Use apenas para imagens estáticas:
--engine cycles --samples 256leva cerca de 20 s em 2400x1200.
Tiras. Para olhar uma ação quadro a quadro:
ffmpeg -framerate 25 -start_number 56 -i out/<n>/frames/%04d.png -frames:v 30 -vf "crop=...,scale=260:-1,tile=6x5" -frames:v 1 strip.jpg
Visual, resumidamente (detalhes e números: references/LOOK.md)
- Escala de brinquedo. 1 unidade = 1 m e Claude tem cerca de 9 cm de largura. A profundidade de campo real da câmera (70 mm, f/4.5-7) então fornece o desfoque de miniatura por si só.
- Papel. Cada sólido recebe
paper(...): cor mate, relevo de fibra, manchas suaves. Bordas biseladas recebem o material de borda branca automaticamente (box,prism,disc). - Cor. Transformação de visualização AgX com o visual Punchy. Exposição -1 para dia e cerca de -0.35 para noite.
- Faces iluminadas: as faces iluminadas de Claude medem próximas às referências (nossa #DA8D6C, referências #EC815B).
- Brilho: quadros diurnos têm um brilho médio de 120-140 (referências 91-181).
- Luz. Uma chave quente, alta e na frente, para que a face superior seja mais brilhante que a frontal. Adicione um preenchimento frio fraco e um contorno quente. Coisas brilhantes (chamas, estrelas, sopros) usam
flame_mateno_shadow. - Câmera. Fica parada em loops (as referências movem a câmera apenas para um corte ou um zoom).
- Quadrada 1080 para GIFs.
- Heroicas são largas, com
shift_xempurrando o sujeito para um terço.
Claude, resumidamente (references/CHARACTERS.md)
claude = Claude('claude', loc), então uma vez por quadro:
claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
- Olhos:
sq,happy(^ ^),line(- -),squeeze(> <),dot(. .),sad. - Adereços: um adereço segurado é parente de
claude.hand(side). - Acenando: o braço que acena deve ser o que está virado para a câmera.
Peças web: olhos ao vivo e o modelo 3D
- Olhos ao vivo.
- Renderize com
--eyes-off(e--transparentpara um recorte):python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. O runner esconde os olhos e escreveeyes.json: o centro de cada olho em pixels e os eixos faciais em pixels por mm. - Execute
python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render com olhos>. Ele escreveindex.htmlmais um arquivo único<dir>_un_archivo.html. - O que a página faz:
- Os olhos são formas SVG desenhadas no plano facial, então a perspectiva está correta mesmo em um rosto inclinado.
- Eles seguem o ponteiro com uma mola subamortecida e piscam a cada 2.5-5.5 s.
^ ^quando o ponteiro está perto,> <enquanto pressionado.- Um salto de compressão e estiramento ao clicar (não com
--hero, que mantém uma imagem completa parada).
- Testado no Chrome através do playwright (ponteiro esquerda, direita, cima, baixo, perto, pressionar, soltar): sem erros no console.
- Renderize com
- Modelo 3D. Execute
blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Ele escreve um GLB de 27 KB, com cerca de 9 cm de largura, reimportado e verificado. - Cenas e
--eyes-off. Uma cena que posiciona Claude em tempo de construção deve posicioná-lo novamente dentro depose(f);--eyes-offsó tem efeito lá (vejastills/director_hero).
Portões de qualidade (tools/qa_loop.py)
FALHA:
- Contagem de quadros errada.
- Uma costura: o passo do último quadro para o primeiro é maior que o percentil 90 dos passos normais.
AVISO:
- Quadros consecutivos idênticos (uma pausa morta).
- Movimento abaixo de 0.8 % do brilho médio. Medido [M]: referências r2/r3/r4 1.65/1.97/1.07 %,
claude_isla0.89 %,claude_fogata1.66 %.
O QA não pode julgar gosto, atuação ou enquadramento. Estes são verificados visualmente nas imagens estáticas e tiras.
Erros conhecidos (references/KNOWN_ERRORS.md)
Os que custam uma re-renderização:
- Um braço levantado acima de cerca de 70° se esconde ao lado do corpo.
- Emissão brilhante desbota para branco sob AgX: use
flame_mat. - Uma chave lateral deixa a face frontal escura.
- Uma cena noturna medida com níveis de cinza absolutos parece "muito quieta".
- Um arco de fundo curvo que é muito estreito mostra sua borda.