Que fait toy-loops ?
Petits mondes en papier-craft (une île, un camping, un plateau de cinéma), Claude en acteur, une lumière chaude et douce et une faible
profondeur de champ comme un miniature. Chaque objet est construit à partir de code et chaque image est calculée à partir de son numéro, donc une
boucle se ferme exactement. Le look a été étudié à partir des références de Pimbo dans anymation/3d_ref/style2 avec la
compétence reference-video-analysis (premier passage : 3d_ref/style2/analysis/FIRST_PASS.md). Ces références sont des supports d'étude
privés : copiez le savoir-faire, jamais leurs scènes.
Statut : v1, 2026-11-18. Pièces réalisées avec et vérifiées :
claude_isla: approuvée par Pimbo ("esta épica").claude_fogata: la deuxième boucle.director_hero: une image hero web 2400x1200, réalisée en deux colorations.claude_pose: le découpage avec des yeux web en direct.claude.glb: le modèle 3D.
Où tout se trouve
Le code est un dossier sur le PC de Pimbo : C:\Users\Pimbo\work\anymation\toy3d\skill. Chaque chemin ci-dessous est relatif à
son dossier kit/ sauf indication contraire.
| Chemin | Ce que c'est |
|---|---|
lib/toy.py | Le look : matériaux papier avec bords biseautés blancs, formes, lumière, caméra, paramètres de rendu |
lib/anim.py | Les outils de l'animateur : easings, Track (pose à pose), ressorts, squash, arc, looped |
lib/chars.py | Claude : le rig et ses six jeux d'yeux ; .pose(...) une fois par image |
lib/runner.py | Rendu d'une scène image par image ; chaque scène se termine par runner.run(...) |
loops/<nom>/scene.py | Une animation en boucle |
stills/<nom>/scene.py | Une image fixe (T = 1) |
tools/make_loop.py | Rendu, encodage GIF 1080/720 et MP4 x1/x3, QA, planche contact, en une commande |
tools/qa_loop.py | Couture de boucle, nombre d'images, arrêts morts, mouvement comparé aux références |
tools/duotone.py | Version monochrome bleue d'une image (style hero web) |
tools/web_eyes.py | Une page web où les yeux de Claude suivent le curseur, à partir d'un rendu sans yeux |
tools/claude_glb.py | Le modèle Claude en .glb (couleurs plates, bords blancs conservés), à exécuter dans Blender |
out/<nom>/ | Sortie : frames/, les fichiers, sheet.jpg, qa.json |
Les pièces terminées sont copiées dans anymation/toy3d/videos/<nom>/ ; les pièces web vivent dans anymation/toy3d/web/.
Nécessite :
- Blender 5.2 : la copie portable de Pimbo se trouve dans
anymation/tools/blender; ailleurs définissez$BLENDERou mettezblenderdans le PATH. - ffmpeg dans le PATH.
- Python avec numpy et Pillow, pour les outils.
Pimbo n'exécute pas de scripts : vous les exécutez et lui montrez les images.
Règles qui ne plient pas
- Montrer avant de construire. Avant un nouveau monde ou personnage, effectuez le rendu de 2-3 images fixes (
--frames ... --scale 0.5) et laissez Pimbo choisir. Regardez chaque image vous-même avant de la montrer. pose(f)est une fonction pure de l'image. Pas d'état transporté entre les images, pas de nombres aléatoires sans un germe fixe, chaque mouvement périodique doit avoir un nombre entier de cycles par boucle. Les effets qui traversent la fin de la boucle utilisentlooped().- Animez comme un animateur (
references/ANIMATION.md). Écrivez d'abord une feuille de dopage, puis utilisez des poses clés avec des easings. Utilisez l'anticipation avant chaque action, l'écrasement à l'impact et l'étirement à la vitesse, le chevauchement sur les bras, et les échanges d'yeux sur une image. Ne déplacez jamais un corps linéairement. - Une boucle n'est terminée que lorsque le QA passe (
make_loop.pyaffiche PASS/FAIL) et que vous avez regardé une bande image par image de chaque action (voir "Bandes" ci-dessous). - Dites ce qui a été mesuré [M], vu [V] et supposé [S].
Pipeline
| Étape | Quoi | Commande (depuis kit/) |
|---|---|---|
| 1 | Idée : lieu, une petite histoire avec un début et un retour en boucle ; 6-9 s | parler à Pimbo |
| 2 | Copier la scène la plus proche : loops/claude_isla (jour, extérieur) ou loops/claude_fogata (nuit, accessoires, effets) | |
| 3 | Construire le décor, placer Claude, éclairage et caméra ; regarder les images fixes | python tools/make_loop.py <nom> --frames 0 --scale 0.5 |
| 4 | Commentaire de feuille de dopage, puis les Tracks ; rendu des poses clés | python tools/make_loop.py <nom> --frames 44,62,66,71,77,81 |
| 5 | Aperçu rapide de la boucle entière | python tools/make_loop.py <nom> --preview (toutes les 8 images) |
| 6 | Rendu complet + GIF + MP4 + QA | python tools/make_loop.py <nom> |
| 7 | Bandes de chaque action, correction, re-rendu | voir "Bandes" ci-dessous |
| 8 | Copier les fichiers terminés dans anymation/toy3d/videos/<nom>/ et les envoyer à Pimbo |
Temporisations sur le PC de Pimbo (RX 6800 XT) [M] :
- EEVEE : environ 0,7 s par image 1080x1080, donc une boucle de 200 images prend environ 2,5 minutes.
- Cycles : environ 10 s par image et donne un résultat presque identique. Utilisez-le uniquement pour les images fixes :
--engine cycles --samples 256prend environ 20 s en 2400x1200.
Bandes. Pour regarder une action image par image :
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
Le look, en bref (détails et chiffres : references/LOOK.md)
- Échelle jouet. 1 unité = 1 m et Claude mesure environ 9 cm de large. La profondeur de champ réelle de la caméra (70 mm, f/4,5-7) donne alors le flou miniature par elle-même.
- Papier. Chaque solide reçoit
paper(...): couleur mate, bosse de fibre, taches douces. Les bords biseautés reçoivent le matériau à bord blanc automatiquement (box,prism,disc). - Couleur. Transformation de vue AgX avec le look Punchy. Exposition -1 pour le jour et environ -0,35 pour la nuit.
- Faces éclairées : les faces éclairées de Claude mesurent près des références (nôtre #DA8D6C, références #EC815B).
- Luminosité : les images de jour ont une luminosité moyenne de 120-140 (références 91-181).
- Lumière. Une clé chaude, haute et devant, de sorte que la face supérieure soit plus brillante que l'avant. Ajoutez une faible lumière de remplissage froide et une
lumière de bord chaude. Les choses lumineuses (flammes, étoiles, bouffées) utilisent
flame_matetno_shadow. - Caméra. Reste immobile dans les boucles (les références ne déplacent la caméra que pour un cut ou un push-in).
- Carré 1080 pour les GIF.
- Les hero sont larges, avec
shift_xpoussant le sujet au tiers.
Claude, en bref (references/CHARACTERS.md)
claude = Claude('claude', loc), puis une fois par image :
claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
- Yeux :
sq,happy(^ ^),line(- -),squeeze(> <),dot(. .),sad. - Accessoires : un accessoire tenu est parenté à
claude.hand(side). - Agitation : le bras qui agite doit être celui faisant face à la caméra.
Pièces web : yeux en direct et modèle 3D
- Yeux en direct.
- Effectuez le rendu avec
--eyes-off(et--transparentpour un découpage) :python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. Le runner cache les yeux et écriteyes.json: le centre pixel de chaque œil et les axes du visage en pixels par mm. - Exécutez
python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render with eyes>. Il écritindex.htmlplus un fichier unique<dir>_un_archivo.html. - Ce que fait la page :
- Les yeux sont des formes SVG dessinées sur le plan du visage, donc la perspective est correcte même sur un visage incliné.
- Ils suivent le pointeur avec un ressort sous-amorti et clignent toutes les 2,5 à 5,5 s.
^ ^lorsque le pointeur est proche,> <lorsqu'on appuie.- Un rebond écrasement-étirement au clic (pas avec
--hero, qui laisse une image complète immobile).
- Testé dans Chrome via playwright (pointeur gauche, droite, haut, bas, proche, appui, relâchement) : aucune erreur dans la console.
- Effectuez le rendu avec
- Modèle 3D. Exécutez
blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Il écrit un GLB de 27 Ko, environ 9 cm de large, réimporté et vérifié. - Scènes et
--eyes-off. Une scène qui pose Claude au moment de la construction doit le reposer à l'intérieur depose(f);--eyes-offne prend effet que là (voirstills/director_hero).
Contrôles qualité (tools/qa_loop.py)
FAIL :
- Nombre d'images incorrect.
- Une couture : le pas de la dernière image à la première est plus grand que le 90ème percentile des pas normaux.
WARN :
- Images consécutives identiques (un arrêt mort).
- Mouvement inférieur à 0,8 % de la luminosité moyenne. Mesuré [M] : références r2/r3/r4 1,65/1,97/1,07 %,
claude_isla0,89 %,claude_fogata1,66 %.
Le QA ne peut pas juger le goût, le jeu d'acteur ou le cadrage. Ceux-ci sont vérifiés à l'œil sur les images fixes et les bandes.
Erreurs connues (references/KNOWN_ERRORS.md)
Celles qui coûtent un re-rendu :
- Un bras levé au-dessus d'environ 70° se cache à côté du corps.
- Une émission brillante blanchit sous AgX : utilisez
flame_mat. - Une clé latérale laisse la face avant sombre.
- Une scène de nuit mesurée avec des niveaux de gris absolus semble "trop calme".
- Un arc de fond incurvé trop étroit montre son bord.