¿Qué hace toy-loops?
Pequeños mundos de papel recortado (una isla, un campamento, un set de cine), Claude como actor, luz cálida suave y una profundidad de campo reducida como de miniatura. Cada objeto se construye con código y cada fotograma se computa a partir de su número, por lo que un bucle cierra exactamente. El aspecto se estudió a partir de las referencias de Pimbo en anymation/3d_ref/style2 con la habilidad reference-video-analysis (primer pase: 3d_ref/style2/analysis/FIRST_PASS.md). Esas referencias son material de estudio privado: copia la artesanía, nunca sus escenas.
Estado: v1, 2026-11-18. Piezas realizadas con él y verificadas:
claude_isla: aprobado por Pimbo ("esta épica").claude_fogata: el segundo bucle.director_hero: una imagen hero web de 2400x1200, realizada en dos combinaciones de color.claude_pose: el recorte con ojos web en vivo.claude.glb: el modelo 3D.
Dónde vive todo
El código es una carpeta en el PC de Pimbo: C:\Users\Pimbo\work\anymation\toy3d\skill. Cada ruta a continuación es relativa a su carpeta kit/ a menos que se indique lo contrario.
| Ruta | Qué es |
|---|---|
lib/toy.py | El aspecto: materiales de papel con bordes biselados blancos, formas, luz, cámara, ajustes de renderizado |
lib/anim.py | Las herramientas del animador: easing, Track (pose a pose), resortes, squash, arc, looped |
lib/chars.py | Claude: el rig y sus seis juegos de ojos; .pose(...) una vez por fotograma |
lib/runner.py | Renderiza una escena fotograma a fotograma; cada escena termina con runner.run(...) |
loops/<nombre>/scene.py | Una animación en bucle |
stills/<nombre>/scene.py | Una imagen (T = 1) |
tools/make_loop.py | Renderizar, codificar GIF 1080/720 y MP4 x1/x3, QA, hoja de contactos, en un solo comando |
tools/qa_loop.py | Costura del bucle, conteo de fotogramas, pausas muertas, movimiento comparado con las referencias |
tools/duotone.py | Versión monocromática azul de una imagen (estilo hero web) |
tools/web_eyes.py | Una página web donde los ojos de Claude siguen el cursor, a partir de un render sin ojos |
tools/claude_glb.py | El modelo de Claude como .glb (colores planos, bordes blancos conservados), ejecutar dentro de Blender |
out/<nombre>/ | Salida: frames/, los archivos, sheet.jpg, qa.json |
Las piezas terminadas se copian a anymation/toy3d/videos/<nombre>/; las piezas web viven en anymation/toy3d/web/.
Necesita:
- Blender 5.2: la copia portátil de Pimbo está en
anymation/tools/blender; en otro lugar configura$BLENDERo ponblenderen el PATH. - ffmpeg en el PATH.
- Python con numpy y Pillow, para las herramientas.
Pimbo no ejecuta scripts: tú los ejecutas y le muestras las imágenes.
Reglas que no se doblan
- Mostrar antes de construir. Antes de un nuevo mundo o personaje, renderiza 2-3 imágenes fijas (
--frames ... --scale 0.5) y deja que Pimbo elija. Mira tú mismo cada imagen antes de mostrarla. pose(f)es una función pura del fotograma. Sin estado entre fotogramas, sin números aleatorios sin una semilla fija, cada movimiento periódico con un número entero de ciclos por bucle. Los efectos que cruzan el final del bucle usanlooped().- Anima como un animador (
references/ANIMATION.md). Escribe primero una hoja de dope, luego usa poses clave con easing. Usa anticipación antes de cada acción, squash en el impacto y stretch en la velocidad, superposición en los brazos, e intercambios de ojos de un fotograma. Nunca muevas un cuerpo linealmente. - Un bucle está terminado solo cuando el QA pasa (
make_loop.pyimprime PASS/FAIL) y has visto una tira fotograma a fotograma de cada acción (ver "Tiras" más abajo). - Di qué fue medido [M], visto [V] y asumido [S].
Pipeline
| Paso | Qué | Comando (desde kit/) |
|---|---|---|
| 1 | Idea: lugar, una pequeña historia con principio y vuelta al bucle; 6-9 s | hablar con Pimbo |
| 2 | Copiar la escena más cercana: loops/claude_isla (día, exterior) o loops/claude_fogata (noche, atrezo, efectos) | |
| 3 | Construir el set, colocar a Claude, luz y cámara; mirar imágenes fijas | python tools/make_loop.py <nombre> --frames 0 --scale 0.5 |
| 4 | Comentario de la hoja de dope, luego los Tracks; renderizar las poses clave | python tools/make_loop.py <nombre> --frames 44,62,66,71,77,81 |
| 5 | Vista rápida de todo el bucle | python tools/make_loop.py <nombre> --preview (cada 8.º fotograma) |
| 6 | Render completo + GIF + MP4 + QA | python tools/make_loop.py <nombre> |
| 7 | Tiras de cada acción, corregir, volver a renderizar | ver "Tiras" más abajo |
| 8 | Copiar los archivos terminados a anymation/toy3d/videos/<nombre>/ y enviarlos a Pimbo |
Tiempos en el PC de Pimbo (RX 6800 XT) [M]:
- EEVEE: aproximadamente 0.7 s por fotograma 1080x1080, por lo que un bucle de 200 fotogramas tarda unos 2.5 minutos.
- Cycles: aproximadamente 10 s por fotograma y se ve casi igual. Úsalo solo para imágenes fijas:
--engine cycles --samples 256tarda unos 20 s a 2400x1200.
Tiras. Para ver una acción fotograma a fotograma:
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
Aspecto, en resumen (detalles y números: references/LOOK.md)
- Escala de juguete. 1 unidad = 1 m y Claude mide unos 9 cm de ancho. La profundidad de campo real de la cámara (70 mm, f/4.5-7) da entonces el desenfoque de miniatura por sí misma.
- Papel. Cada sólido recibe
paper(...): color mate, relieve de fibra, manchas suaves. Los bordes biselados reciben automáticamente el material de borde blanco (box,prism,disc). - Color. Transformación de vista AgX con el aspecto Punchy. Exposición -1 para día y aproximadamente -0.35 para noche.
- Caras iluminadas: las caras iluminadas de Claude miden cerca de las referencias (nuestras #DA8D6C, referencias #EC815B).
- Brillo: los fotogramas de día tienen un brillo medio de 120-140 (referencias 91-181).
- Luz. Una clave cálida, alta y al frente, para que la cara superior sea más brillante que la frontal. Añade un relleno frío suave y un reborde cálido. Las cosas que brillan (llamas, estrellas, bocanadas) usan
flame_matyno_shadow. - Cámara. Se mantiene quieta en los bucles (las referencias mueven la cámara solo para un corte o un acercamiento).
- Cuadrada 1080 para GIFs.
- Las imágenes hero son anchas, con
shift_xempujando al sujeto a un tercio.
Claude, en resumen (references/CHARACTERS.md)
claude = Claude('claude', loc), luego una vez por fotograma:
claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
- Ojos:
sq,happy(^ ^),line(- -),squeeze(> <),dot(. .),sad. - Atrezo: un objeto sostenido se emparenta a
claude.hand(lado). - Saludo: el brazo que saluda debe ser el que mira hacia la cámara.
Piezas web: ojos en vivo y el modelo 3D
- Ojos en vivo.
- Renderiza con
--eyes-off(y--transparentpara un recorte):python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. El runner oculta los ojos y escribeeyes.json: el centro de píxel de cada ojo y los ejes de la cara en píxeles por mm. - Ejecuta
python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render con ojos>. Escribeindex.htmlmás un archivo único<dir>_un_archivo.html. - Qué hace la página:
- Los ojos son formas SVG dibujadas en el plano de la cara, por lo que la perspectiva es correcta incluso en una cara inclinada.
- Siguen el puntero con un resorte subamortiguado y parpadean cada 2.5-5.5 s.
^ ^cuando el puntero está cerca,> <mientras se presiona.- Un rebote de squash-and-stretch al hacer clic (no con
--hero, que mantiene una imagen completa quieta).
- Probado en Chrome mediante playwright (puntero izquierda, derecha, arriba, abajo, cerca, presionar, soltar): sin errores en consola.
- Renderiza con
- Modelo 3D. Ejecuta
blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Escribe un GLB de 27 KB, de unos 9 cm de ancho, reimportado y verificado. - Escenas y
--eyes-off. Una escena que pose a Claude en tiempo de construcción debe volver a posarlo dentro depose(f);--eyes-offsolo surte efecto allí (verstills/director_hero).
Puertas de calidad (tools/qa_loop.py)
FAIL:
- Número incorrecto de fotogramas.
- Una costura: el paso del último fotograma al primero es mayor que el percentil 90 de los pasos normales.
WARN:
- Fotogramas consecutivos idénticos (una pausa muerta).
- Movimiento por debajo del 0.8 % del brillo medio. Medido [M]: referencias r2/r3/r4 1.65/1.97/1.07 %,
claude_isla0.89 %,claude_fogata1.66 %.
El QA no puede juzgar el gusto, la actuación ni el encuadre. Esos se verifican a ojo en imágenes fijas y tiras.
Errores conocidos (references/KNOWN_ERRORS.md)
Los que cuestan un rerenderizado:
- Un brazo levantado más de unos 70° se esconde al lado del cuerpo.
- La emisión brillante se lava a blanco bajo AgX: usa
flame_mat. - Una clave lateral deja la cara frontal oscura.
- Una escena nocturna medida con niveles de gris absolutos se ve "demasiado tranquila".
- Un arco de fondo curvo que es demasiado estrecho muestra su borde.