Was macht Bewegte Malerei?
Eine Methode zur Erstellung kurzer Zeichentrickfilme vollständig in Code, destilliert aus JohnHeibel/PDoomVideo (ein 156 s Musikvideo, gemalt von Claude Opus) und seinem verallgemeinerten Kit ClaudeAnimationBase (MIT), das hier als template/ mitgeliefert wird.
So funktioniert es: Jedes Bild ist eine reine Funktion der Zeit t. studio.html lädt p5.js + p5.brush und Ihre Szenendateien; jede Einstellung malt den gesamten 1920×1080 Rahmen mit Aquarellfüllungen und kochenden Tuschelinien. render.mjs treibt Headless Chrome an, um Kontaktbögen zur Überprüfung oder jedes Bild parallel zu rendern, und ffmpeg codiert das MP4 (mit Audio, falls vorhanden).
Arbeitsablauf
0. Grundgerüst
bash ~/.claude/skills/painted-animation/scripts/new_project.sh <projekt-verzeichnis> # --keep-demo behält die Beispielszene bei
Dies kopiert die Vorlage, entfernt die Demoszene, führt npm install aus und prüft node / ffmpeg / Chrome. Dann lesen Sie <projekt-verzeichnis>/ANIMATION_GUIDE.md vollständig, bevor Sie etwas entwerfen: Es enthält die Regeln, die Animationsprinzipien und die vollständige Engine / Clawd-API. Betrachten Sie docs/emotions.jpg und docs/views.jpg (die Modellblätter) mit dem Read-Werkzeug.
Lesen Sie für ein Musikvideo oder etwas länger als ~20 s auch references/music-video.md. Für ein Lyrikvideo fragen Sie zuerst nach der Songdatei und einem LRC und messen Sie das Tempo mit scripts/beat_grid.py: Zeilen sind normalerweise schneller, als Sie vermuten.
1. Storyboard vor dem Code
Schreiben Sie STORYBOARD.md im Projekt (Format im Leitfaden: Logline, Welt + Palettenbogen, Motiv, der Gefühlsbogen der Figur, dann Einstellungen mit reads – die zeitlich begrenzte Liste dessen, was der Betrachter verstehen muss). Mit Beispiel: examples/xiaozhen/ (ein 31 s Lyrikvideo: Storyboard und vollständiger Szenencode).
Zeigen Sie das Storyboard dem Benutzer und lassen Sie ihn reagieren, bevor Sie bauen, es sei denn, er hat gesagt, machen Sie einfach weiter.
2. Bauen Sie Einstellung für Einstellung
- Setzen Sie
duration,bpm,offset(undaudio) insrc/config.js. - Eine IIFE-umwickelte Datei pro Szene/Kapitel in
src/scenes/, endend mitshots([[t0, fn], ...]); fügen Sie ihr<script>zustudio.htmlhinzu. - Blockieren Sie zuerst die wichtigsten Posen, überprüfen Sie sie als Standbilder, dann fügen Sie die Bewegung dazwischen hinzu.
3. Rendern und überprüfen – jede Einstellung, mehrmals
Sie können Bewegung nicht durch Lesen von Code sehen. Vom Projektverzeichnis aus:
node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg # Schlüsselbilder
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg # jedes Bild eines Moments
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg # Detail in voller Auflösung
Öffnen Sie jedes Bild mit Read und prüfen Sie es gegen die Checkliste des Leitfadens: Ereignis klar? Figur groß genug? Reads so getimt, dass ein Erstzuschauer sie versteht? Antizipation / Durchziehen, kein Ruckeln? Füße und gehaltene Requisiten berühren? Übergänge an jeder Naht? Kein Text, kein 3D, kein reines Schwarz/Weiß, keine matschigen Glüheffekte? Korrigieren und erneut prüfen. Budget: ≥ 1 Kontaktbogen pro Einstellung, ein Streifen pro Schlüsselbewegung und Übergang, ein Ausschnitt pro geschichtstragendem Gesicht.
4. Video rendern
node render.mjs --clip --out=out/video.mp4 # kurze Videos, ein Worker
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3] # lange, parallel + fortsetzbar
Melden Sie den Ausgabepfad, die Länge und ms/Bild. Bieten Sie open out/video.mp4 an.
Die wichtigsten Regeln
Dies sind die Regeln des Leitfadens zusammengefasst; der Leitfaden ist maßgeblich.
- Handgemachtes Medium. Nur
paint()/inkLine()(p5.brush) – niemals einfaches p5rect/ellipse/fill. Nur flache 2D: Drehungen erfolgen über gezeichnete Schlüsselansichten (turn(),spinView()), niemals 3D-Projektion. Licht überglow()(additiv), weil Pigmentmischung Gelb-über-Blau grün macht. - Kein Text. Keine Untertitel, Beschriftungen, Schilder oder Sprechblasen; zeigen Sie es stattdessen. Reaktionen sind gemalte Emoticons (
!, Schweißtropfen, Herzen…). Die einzige Ausnahme ist Karaoke in einem Lyrikvideo und höchstens ein paar große SFX. - In jeder Einstellung passiert etwas – ein Ereignis, Ursache → Reaktion, Aufbauten, die sich auszahlen.
- Zeit für den Betrachter. Listen Sie die Reads jeder Einstellung auf; ein Read nach dem anderen; schnelle Aktionen, gehaltene Bedeutungen; führen Sie das Auge; die Reads bestimmen die Einstellungslänge. Hier scheitert generierte Animation am meisten.
- Lebendig. Nichts ist still (Idles von
feel(), driftende Kameras, Kochen); Gesichter ändern sich durchemotions(), niemals durch Austausch; die Figur ist groß (Halbtotal u≈20–28, Nahaufnahme 40–70); alles reitet auf dem Beat. - Übergänge an jeder Naht, gewählt passend zur Geschichte (Pinselwisch, Iris / geformte Iris, Peitschenschwenk, Match Cut, Schnitt auf Aktion, Kameradurchzug).
- Ein Stück. Eine Welt, ein Farbbogen, ein emotionaler Faden, verbundene Szenen, ein Ende, das sich mit dem Anfang reimt.
Engine-Fallstricke
- Reine Funktionen von
t. Bilder werden parallel und außer der Reihe gerendert: kein Zustand über Bilder hinweg, keinMath.random(), keine Bild-für-Bild-Physik.hash(i)für stabile Zufälligkeit,jit()für Kochen. boilSeed(key)vor jedem separaten Hintergrundelement/Requisit, sonst kocht ein sich bewegendes Ding alles, was danach gezeichnet wird, jedes Bild neu (Zittern).- Benennen Sie keine globalen Variablen nach denen von p5. p5 definiert
line,OVERLAY,text,color,scale, … als globale Variablen; einefunction line()auf oberster Ebene schlägt fehl mitCannot redefine propertyund die Seite wird nie bereit (der Renderer läuft aus). Halten Sie Helfer innerhalb der Szenen-IIFE oder geben Sie ihnen eindeutige Namen. - Schichtung bei Türen, Fenstern und Bildschirmen: Zeichnen Sie, was innen ist, dann malen Sie die umgebende Wand/den Rahmen wieder darüber, sodass nichts Breiteres als die Öffnung außerhalb erscheint (der Zug
inDoor+ Türzargen, die TV-Blendenstücke). - Ein
NaNin einer Punktliste wirftFailed to construct 'OffscreenCanvas'– schützen Sie entartete Geometrie. - Bei Kamera-Zoom ≳ 2 verlieren große Formen ihre Konturen; die Konturlinienstärke skaliert mit Zoom, also reduzieren Sie
swin Nahaufnahmen. - Kosten = Anzahl der Füllungen und Striche. Zielen Sie auf ≤ ~1,5–2,5 s/Bild (das Protokoll druckt ms/Bild). Bevorzugen Sie weniger, größere Formen. Auf Maschinen ohne echte GPU sind Aquarellfüllungen langsam – erwägen Sie weniger
fill-Formen oder--soft-glals letzten Ausweg. - macOS: Der Renderer verwendet
--use-angle=metalund findet/Applications/Google Chrome.appautomatisch; geben Sie andernfalls--chrome=<pfad>an.
Anpassen
- Clawd ist der Standardstar, kein Muss. Neue Figuren, Requisiten und Emotionen werden mit denselben Werkzeugen (
paint,ribbon,through,glow) gezeichnet und über Einstellungen hinweg konsistent gehalten; neue Emotionen kommen inEMOinsrc/clawd.js. src/karaoke.js(Vorlage) fügt Wort-für-Wort-Karaoke für Lyrikvideos über denwindow.overlayHook-Hook incore.jshinzu.LOOPS.name = t => {...}; LOOPS.name.len = 4;+node render.mjs --loop=name --pngerstellt eine nahtlose Schleife für GIFs (ffmpeg -i out/loop_name/f%04d.png …).- Höherer Reasoning-Aufwand führt tendenziell zu extravaganteren, detaillierteren Szenen.