Animation peinte
Une méthode pour créer de courts dessins animés entièrement en code, distillée de JohnHeibel/PDoomVideo (un clip musical de 156 s peint par Claude Opus) et de son kit généralisé ClaudeAnimationBase (MIT), qui est inclus ici dans template/.
Comment ça marche : chaque image est une fonction pure du temps t. studio.html charge p5.js + p5.brush et vos fichiers de scène ; chaque plan peint l'image entière en 1920×1080 avec des remplissages aquarelle et des lignes d'encre bouillonnantes. render.mjs pilote Chrome sans tête pour rendre des planches contacts pour la révision, ou chaque image en parallèle, et ffmpeg encode le MP4 (avec audio si fourni).
Flux de travail
0. Structure de base
bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir> # ajoutez --keep-demo pour conserver la scène d'exemple connectée
Ceci copie le modèle, déconnecte la scène d'exemple, exécute npm install et vérifie node / ffmpeg / Chrome. Ensuite, lisez <project-dir>/ANIMATION_GUIDE.md en entier avant de concevoir quoi que ce soit : il contient les règles, les principes d'animation et l'API complète du moteur / Clawd. Consultez docs/emotions.jpg et docs/views.jpg (les fiches modèles) avec l'outil Read.
Pour un clip musical ou toute chose plus longue qu'environ 20 s, lisez aussi references/music-video.md. Pour un vidéoclip de paroles, demandez d'abord le fichier de la chanson et un LRC, et mesurez le tempo avec scripts/beat_grid.py : les lignes sont généralement plus rapides que vous ne le pensez.
1. Storyboard avant le code
Écrivez STORYBOARD.md dans le projet (format dans le guide : logline, arc monde + palette, motif, arc émotionnel du personnage, puis plans avec lectures — la liste chronologique de ce que le spectateur doit comprendre). Exemple concret : examples/xiaozhen/ (un vidéoclip de paroles de 31 s : storyboard et code complet de la scène).
Montrez le storyboard à l'utilisateur et laissez-le réagir avant de construire, à moins qu'il n'ait dit d'aller de l'avant.
2. Construire plan par plan
- Définissez
duration,bpm,offset(etaudio) danssrc/config.js. - Un fichier par scène/chapitre encapsulé dans une IIFE dans
src/scenes/, se terminant parshots([[t0, fn], ...]); ajoutez son<script>àstudio.html. - Blaquez d'abord les poses clés, vérifiez-les en tant qu'images fixes, puis ajoutez le mouvement entre elles.
3. Rendre et regarder — chaque plan, plusieurs fois
On ne peut pas voir le mouvement en lisant du code. Depuis le répertoire du projet :
node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg # images clés
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg # chaque image d'un moment
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg # détail en pleine résolution
Ouvrez chaque image avec Read et vérifiez-la réellement par rapport à la liste de révision du guide : l'événement est clair ? le personnage est assez grand ? les lectures sont chronométrées pour qu'un spectateur novice les comprenne ? anticipation / suivi, pas de à-coups ? les pieds et les accessoires tenus touchent-ils le sol ? des transitions à chaque jointure ? pas de texte, pas de 3D, pas de noir/blanc pur, pas de lueurs brouillonnes ? Corrigez et regardez à nouveau. Budget : ≥ 1 planche par plan, une bande par mouvement clé et transition, un recadrage par visage porteur de l'histoire.
4. Rendre la vidéo
node render.mjs --clip --out=out/video.mp4 # vidéos courtes, un travailleur
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3] # longues, parallèle + reprisable
Signalez le chemin de sortie, la durée et le ms/image. Proposez open out/video.mp4.
Les règles les plus importantes
Ce sont les règles du guide condensées ; le guide fait foi.
- Médium artisanal. Uniquement
paint()/inkLine()(p5.brush) — jamais derect/ellipse/fillp5 bruts. Plat 2D uniquement : les rotations passent par des vues clés dessinées (turn(),spinView()), jamais de projection 3D. Lumière viaglow()(additif), car le mélange de pigments fait que le jaune sur le bleu devient vert. - Pas de texte. Pas de légendes, d'étiquettes, de panneaux ou de bulles de dialogue ; montrez-le à la place. Les réactions sont des émoticônes peintes (
!, sueur, cœurs…). La seule exception est le karaoké dans un vidéoclip de paroles, et au maximum quelques gros effets sonores. - Quelque chose se passe dans chaque plan — un événement, cause → réaction, des mises en place qui paient.
- Du temps pour le spectateur. Listez les lectures de chaque plan ; une lecture à la fois ; actions rapides, significations tenues ; guidez l'œil ; les lectures déterminent la durée du plan. C'est là que l'animation générée échoue le plus.
- Vivant. Rien n'est statique (idles de
feel(), caméras flottantes, ébullition) ; les visages changent avecemotions()jamais par échange ; le personnage est grand (plan moyen u≈20–28, gros plan 40–70) ; tout suit le rythme. - Transitions à chaque jointure, choisies pour s'adapter à l'histoire (essuyage de pinceau, iris / iris en forme, panoramique fouetté, cut on action, raccord dans le mouvement, passage de caméra).
- Un tout. Un seul monde, un arc de couleurs, un fil émotionnel, des scènes liées, une fin qui rime avec le début.
Pièges du moteur
- Fonctions pures de
t. Les images sont rendues en parallèle et dans le désordre : pas d'état entre les images, pas deMath.random(), pas de physique image par image. Utilisezhash(i)pour l'aléatoire stable,jit()pour l'ébullition. boilSeed(key)avant chaque élément de fond/prop séparé, sinon un objet en mouvement fait que tout ce qui est dessiné après lui rebouillonne à chaque image (gigue).- Ne nommez pas les globales comme celles de p5. p5 définit
line,OVERLAY,text,color,scale, … comme globales ; unefunction line()au niveau supérieur échoue avecCannot redefine propertyet la page ne devient jamais prête (le rendeur expire). Gardez les aides à l'intérieur de l'IIFE de la scène ou donnez-leur des noms distincts. - Superposition dans les portes, fenêtres et écrans : dessinez ce qui est à l'intérieur, puis repeignez le mur/cadre environnant par-dessus, de sorte que rien de plus large que l'ouverture ne se voie à l'extérieur (l'
inDoordu train + les jambages de porte, les pièces du cadre TV). - Un
NaNdans une liste de points provoqueFailed to construct 'OffscreenCanvas'— protégez la géométrie dégénérée. - Sous un zoom de caméra ≳ 2, les grandes formes perdent leurs contours ; l'épaisseur des contours s'adapte au zoom, donc réduisez
swdans les gros plans. - Coût = nombre de remplissages et de traits. Visez ≤ ~1.5–2.5 s/image (le journal imprime ms/image). Préférez moins de formes, plus grandes. Sur les machines sans GPU réel, les remplissages aquarelle sont lents — envisagez moins de formes
fill, ou--soft-glen dernier recours. - macOS : le rendeur utilise
--use-angle=metalet trouve/Applications/Google Chrome.appautomatiquement ; sinon passez--chrome=<path>.
Adaptation
- Clawd est la star par défaut, pas une obligation. Les nouveaux personnages, accessoires et émotions sont dessinés avec les mêmes outils (
paint,ribbon,through,glow) et restent cohérents entre les plans ; les nouvelles émotions vont dansEMOdanssrc/clawd.js. src/karaoke.js(modèle) ajoute un karaoké mot par mot pour les vidéoclips de paroles via le crochetwindow.overlayHookdanscore.js.LOOPS.name = t => {...}; LOOPS.name.len = 4;+node render.mjs --loop=name --pngcrée une boucle sans couture pour les GIF (ffmpeg -i out/loop_name/f%04d.png …).- Un effort de raisonnement plus élevé tend à donner des scènes plus extravagantes et détaillées.