Animación pintada
Un método para crear cortometrajes animados enteramente en código, destilado de JohnHeibel/PDoomVideo (un video musical de 156 s pintado por Claude Opus) y su kit generalizado ClaudeAnimationBase (MIT), que se incluye aquí como template/.
Cómo funciona: cada cuadro es una función pura del tiempo t. studio.html carga p5.js + p5.brush y tus archivos de escena; cada toma pinta el cuadro completo de 1920×1080 con rellenos de acuarela y líneas de tinta hirviente. render.mjs impulsa Chrome sin interfaz gráfica para renderizar hojas de contacto para revisión, o cada cuadro en paralelo, y ffmpeg codifica el MP4 (con audio si se proporciona).
Flujo de trabajo
0. Andamio
bash ~/.claude/skills/painted-animation/scripts/new_project.sh <directorio-proyecto> # añadir --keep-demo para mantener la escena de ejemplo conectada
Esto copia la plantilla, desconecta la escena de demostración, ejecuta npm install y verifica node / ffmpeg / Chrome. Luego lee <directorio-proyecto>/ANIMATION_GUIDE.md completamente antes de diseñar cualquier cosa: contiene las reglas, los principios de animación y la API completa del motor / Clawd. Mira docs/emotions.jpg y docs/views.jpg (las hojas de modelo) con la herramienta Read.
Para un video musical o cualquier cosa más larga de ~20 s, lee también references/music-video.md. Para un video de letras, primero pide el archivo de canción y un LRC, y mide el tempo con scripts/beat_grid.py: las líneas suelen ser más rápidas de lo que crees.
1. Storyboard antes del código
Escribe STORYBOARD.md en el proyecto (formato en la guía: logline, arco de mundo + paleta, motivo, arco emocional del personaje, luego tomas con lecturas — la lista temporizada de lo que el espectador debe entender). Ejemplo práctico: examples/xiaozhen/ (un video de letras de 31 s: storyboard y código completo de escena).
Muestra el storyboard al usuario y deja que reaccione antes de construir, a menos que haya dicho que sigas adelante.
2. Construir toma por toma
- Establece
duration,bpm,offset(yaudio) ensrc/config.js. - Un archivo por escena/capítulo envuelto en IIFE en
src/scenes/, terminando conshots([[t0, fn], ...]); añade su<script>astudio.html. - Bloquea primero las poses clave, verifícalas como imágenes fijas, luego añade el movimiento entre ellas.
3. Renderizar y revisar — cada toma, varias veces
No puedes ver el movimiento leyendo código. Desde el directorio del proyecto:
node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg # fotogramas clave
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg # cada cuadro de un momento
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg # detalle a resolución completa
Abre cada imagen con Read y compárala con la lista de revisión de la guía: ¿evento claro? ¿personaje suficientemente grande? ¿lecturas temporizadas para que un espectador novato las entienda? ¿anticipación / seguimiento, sin cortes? ¿pies y accesorios sostenidos tocando? ¿transiciones en cada costura? ¿sin texto, sin 3D, sin blanco/negro puro, sin brillos embarrados? Corrige y revisa de nuevo. Presupuesto: ≥ 1 hoja por toma, una tira por movimiento clave y transición, un recorte por rostro que lleve la historia.
4. Renderizar el video
node render.mjs --clip --out=out/video.mp4 # videos cortos, un trabajador
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3] # largos, paralelo + reanudable
Reporta la ruta de salida, duración y ms/cuadro. Ofrece open out/video.mp4.
Las reglas más importantes
Estas son las reglas de la guía condensadas; la guía es la autoridad.
- Medio artesanal. Solo
paint()/inkLine()(p5.brush) — nuncarect/ellipse/fillsimples de p5. Solo 2D plano: los giros pasan por vistas clave dibujadas (turn(),spinView()), nunca proyección 3D. Luz medianteglow()(aditiva), porque mezclar pigmentos hace que amarillo sobre azul se vuelva verde. - Sin texto. Sin subtítulos, etiquetas, letreros ni bocadillos; muéstralo en su lugar. Las reacciones son emotes pintados (
!, sudor, corazones…). La única excepción es el karaoke en un video de letras, y como máximo unos pocos efectos de sonido grandes. - Algo sucede en cada toma — un evento, causa → reacción, preparaciones que se resuelven.
- Tiempo para el espectador. Enumera las lecturas de cada toma; una lectura a la vez; acciones rápidas, significados sostenidos; guía el ojo; las lecturas establecen la duración de la toma. Aquí es donde falla la animación generada.
- Vivo. Nada está quieto (ocios de
feel(), cámara a la deriva, hervido); los rostros cambian medianteemotions()nunca intercambiando; el personaje es grande (plano medio u≈20–28, primer plano 40–70); todo sigue el ritmo. - Transiciones en cada costura, elegidas para ajustarse a la historia (barrido de pincel, iris / iris con forma, paneo rápido, corte por correspondencia, corte en acción, arrastre de cámara).
- Una sola pieza. Un mundo, un arco de color, un hilo emocional, escenas vinculadas, un final que rima con el comienzo.
Peculiaridades del motor
- Funciones puras de
t. Los cuadros se renderizan en paralelo y fuera de orden: sin estado entre cuadros, sinMath.random(), sin física cuadro por cuadro. Usahash(i)para aleatoriedad estable,jit()para hervido. boilSeed(key)antes de cada elemento/fondo/prop separado, o una cosa en movimiento hará que todo lo dibujado después de ella vuelva a hervir cada cuadro (temblor).- No nombres globales como los de p5. p5 define
line,OVERLAY,text,color,scale, … como globales; unafunction line()de nivel superior falla conCannot redefine propertyy la página nunca se vuelve lista (el renderizador se agota). Mantén las ayudas dentro de la IIFE de la escena o dales nombres distintos. - Capas en puertas, ventanas y pantallas: dibuja lo que está dentro, luego pinta la pared/marco circundante sobre ello, de modo que nada más ancho que la abertura se muestre fuera (el
inDoordel tren + jambas de puerta, las piezas del bisel del televisor). - Un
NaNen una lista de puntos lanzaFailed to construct 'OffscreenCanvas'— protege la geometría degenerada. - Bajo zoom de cámara ≳ 2, las formas grandes pierden contornos; el grosor del contorno escala con el zoom, así que reduce
swen primeros planos. - Costo = número de rellenos y trazos. Apunta a ≤ ~1.5–2.5 s/cuadro (el registro imprime ms/cuadro). Prefiere formas menos y más grandes. En máquinas sin GPU real, los rellenos de acuarela son lentos — considera menos formas de
fill, o--soft-glcomo último recurso. - macOS: el renderizador usa
--use-angle=metaly encuentra/Applications/Google Chrome.appautomáticamente; de lo contrario, pasa--chrome=<ruta>.
Adaptación
- Clawd es la estrella predeterminada, no un requisito. Los nuevos personajes, accesorios y emociones se dibujan con las mismas herramientas (
paint,ribbon,through,glow) y se mantienen fieles al modelo en todas las tomas; las nuevas emociones van enEMOensrc/clawd.js. src/karaoke.js(plantilla) añade karaoke palabra por palabra para videos de letras mediante el ganchowindow.overlayHookencore.js.LOOPS.name = t => {...}; LOOPS.name.len = 4;+node render.mjs --loop=name --pngcrea un bucle sin costuras para GIFs (ffmpeg -i out/loop_name/f%04d.png …).- Un mayor esfuerzo de razonamiento tiende a dar escenas más extravagantes y detalladas.