Was macht toy-loops?
Kleine Papier-Bastelwelten (eine Insel, ein Campingplatz, ein Filmset), Claude als Schauspieler, sanftes warmes Licht und eine geringe Schärfentiefe wie bei einer Miniatur. Jedes Objekt wird aus Code gebaut und jeder Frame aus seiner Nummer berechnet, sodass eine Schleife exakt schließt. Der Look wurde aus Pimbos Referenzen in anymation/3d_ref/style2 mit dem Skill reference-video-analysis studiert (erster Durchlauf: 3d_ref/style2/analysis/FIRST_PASS.md). Diese Referenzen sind privates Studienmaterial: Kopiere die Bauweise, niemals ihre Szenen.
Status: v1, 2026-11-18. Damit erstellte und geprüfte Stücke:
claude_isla: von Pimbo genehmigt ("esta épica").claude_fogata: die zweite Schleife.director_hero: ein 2400x1200 Web-Heldenbild, in zwei Farbgebungen.claude_pose: der Ausschnitt mit Live-Web-Augen.claude.glb: das 3D-Modell.
Wo alles lebt
Der Code befindet sich in einem Ordner auf Pimbos PC: C:\Users\Pimbo\work\anymation\toy3d\skill. Alle folgenden Pfade sind relativ zum kit/-Unterordner, sofern nicht anders angegeben.
| Pfad | Was es ist |
|---|---|
lib/toy.py | Der Look: Papiermaterialien mit weißen Facettenkanten, Formen, Licht, Kamera, Render-Einstellungen |
lib/anim.py | Die Werkzeuge des Animators: Easing-Funktionen, Track (Pose zu Pose), Federn, squash, arc, looped |
lib/chars.py | Claude: das Rig und seine sechs Augensets; .pose(...) einmal pro Frame |
lib/runner.py | Rendert eine Szene Frame für Frame; jede Szene endet mit runner.run(...) |
loops/<name>/scene.py | Eine sich wiederholende Animation |
stills/<name>/scene.py | Ein Standbild (T = 1) |
tools/make_loop.py | Rendern, GIF 1080/720 und MP4 x1/x3 codieren, Qualitätssicherung, Kontaktbogen, mit einem Befehl |
tools/qa_loop.py | Schleifennaht, Framanzahl, Stillstände, Bewegung im Vergleich zu den Referenzen |
tools/duotone.py | Blaue Monochrom-Version eines Bildes (Web-Heldenstil) |
tools/web_eyes.py | Eine Webseite, auf der Claudes Augen dem Cursor folgen, basierend auf einem Render ohne Augen |
tools/claude_glb.py | Das Claude-Modell als .glb (flache Farben, weiße Kanten erhalten), ausgeführt in Blender |
out/<name>/ | Ausgabe: frames/, die Dateien, sheet.jpg, qa.json |
Fertige Stücke werden nach anymation/toy3d/videos/<name>/ kopiert; Web-Stücke befinden sich in anymation/toy3d/web/.
Erfordert:
- Blender 5.2: Pimbos portable Kopie ist unter
anymation/tools/blender; an anderer Stelle setze$BLENDERoder fügeblenderzum PATH hinzu. - ffmpeg im PATH.
- Python mit numpy und Pillow, für die Werkzeuge.
Pimbo führt keine Skripte aus: Du führst sie aus und zeigst ihm Bilder.
Unveränderliche Regeln
- Zeigen vor dem Bauen. Vor einer neuen Welt oder Figur rendere 2-3 Standbilder (
--frames ... --scale 0.5) und lass Pimbo wählen. Sieh dir jedes Bild selbst an, bevor du es zeigst. pose(f)ist eine reine Funktion des Frames. Kein Zustand zwischen Frames, keine Zufallszahlen ohne festen Samen, jede periodische Bewegung eine ganze Anzahl von Zyklen pro Schleife. Effekte, die das Schleifenende überqueren, verwendenlooped().- Animiere wie ein Animator (
references/ANIMATION.md). Schreibe zuerst ein Dope Sheet, dann verwende Key-Posen mit Easing. Verwende Antizipation vor jeder Aktion, Quetschen beim Aufprall und Strecken bei Geschwindigkeit, Überlappung bei Armen und einen Frame lange Augenwechsel. Bewege niemals einen Körper linear. - Eine Schleife ist erst fertig, wenn die Qualitätssicherung bestanden ist (
make_loop.pygibt PASS/FAIL aus) und du einen Frame-für-Frame-Streifen jeder Aktion angesehen hast (siehe "Streifen" unten). - Gib an, was gemessen [M], gesehen [V] und angenommen [S] wurde.
Pipeline
| Schritt | Was | Befehl (von kit/ aus) |
|---|---|---|
| 1 | Idee: Ort, eine kleine Geschichte mit Anfang und Rückkehr zur Schleife; 6-9 s | mit Pimbo sprechen |
| 2 | Kopiere die ähnlichste Szene: loops/claude_isla (Tag, draußen) oder loops/claude_fogata (Nacht, Requisiten, Effekte) | |
| 3 | Baue das Set, platziere Claude, Licht und Kamera; betrachte Standbilder | python tools/make_loop.py <name> --frames 0 --scale 0.5 |
| 4 | Dope-Sheet-Kommentar, dann die Tracks; rendere die Key-Posen | python tools/make_loop.py <name> --frames 44,62,66,71,77,81 |
| 5 | Schneller Blick auf die gesamte Schleife | python tools/make_loop.py <name> --preview (jeder 8. Frame) |
| 6 | Vollständiges Rendern + GIF + MP4 + Qualitätssicherung | python tools/make_loop.py <name> |
| 7 | Streifen jeder Aktion, korrigieren, neu rendern | siehe "Streifen" unten |
| 8 | Kopiere die fertigen Dateien nach anymation/toy3d/videos/<name>/ und sende sie an Pimbo |
Zeiten auf Pimbos PC (RX 6800 XT) [M]:
- EEVEE: ca. 0,7 s pro 1080x1080 Frame, daher dauert eine 200-Frame-Schleife etwa 2,5 Minuten.
- Cycles: ca. 10 s pro Frame und sieht fast gleich aus. Verwende es nur für Standbilder:
--engine cycles --samples 256dauert etwa 20 s bei 2400x1200.
Streifen. Um eine Aktion Frame für Frame zu betrachten:
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
Look, kurzgefasst (Details und Zahlen: references/LOOK.md)
- Spielzeugmaßstab. 1 Einheit = 1 m und Claude ist etwa 9 cm breit. Die echte Kameratiefenschärfe (70 mm, f/4,5-7) erzeugt dann automatisch die Miniaturunschärfe.
- Papier. Jeder Festkörper bekommt
paper(...): matte Farbe, Faserstruktur, weiche Flecken. Facettenkanten erhalten automatisch das Weißkanten-Material (box,prism,disc). - Farbe. View-Transformation AgX mit dem Punchy-Look. Belichtung -1 für Tag und etwa -0,35 für Nacht.
- Beleuchtete Flächen: Claudes beleuchtete Flächen messen nahe an den Referenzen (unsere #DA8D6C, Referenzen #EC815B).
- Helligkeit: Tag-Frames haben eine mittlere Helligkeit von 120-140 (Referenzen 91-181).
- Licht. Ein warmes Key-Licht, hoch und von vorne, sodass die Oberseite heller ist als die Vorderseite. Füge ein schwaches kühles Fülllicht und einen warmen Randlicht hinzu. Leuchtende Dinge (Flammen, Sterne, Wölkchen) verwenden
flame_matundno_shadow. - Kamera. Steht still in Schleifen (die Referenzen bewegen die Kamera nur für einen Schnitt oder eine Kamerafahrt).
- Quadratisch 1080 für GIFs.
- Heldenbilder sind breit, mit
shift_x, das das Motiv in das erste Drittel schiebt.
Claude, kurzgefasst (references/CHARACTERS.md)
claude = Claude('claude', loc), dann einmal pro Frame:
claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
- Augen:
sq,happy(^ ^),line(- -),squeeze(> <),dot(. .),sad. - Requisiten: Eine gehaltene Requisite ist an
claude.hand(side)Eltern-gebunden. - Winken: Der winkende Arm muss der sein, der der Kamera zugewandt ist.
Web-Stücke: Live-Augen und das 3D-Modell
- Live-Augen.
- Rendere mit
--eyes-off(und--transparentfür einen Ausschnitt):python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. Der Runner versteckt die Augen und schreibteyes.json: den Pixelmittelpunkt jedes Auges und die Gesichtsachsen in Pixeln pro mm. - Führe aus:
python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render mit augen>. Es schreibtindex.htmlplus eine Einzeldatei<dir>_un_archivo.html. - Was die Seite tut:
- Die Augen sind SVG-Formen, die auf die Gesichtsebene gezeichnet werden, sodass die Perspektive auch bei geneigtem Gesicht stimmt.
- Sie folgen dem Zeiger mit einer unterdämpften Feder und blinzeln alle 2,5-5,5 s.
^ ^wenn der Zeiger nahe ist,> <während des Drückens.- Ein Quetsch-und-Streck-Sprung beim Klick (nicht mit
--hero, das ein vollständiges Bild still hält).
- Getestet in Chrome via Playwright (Zeiger links, rechts, oben, unten, nah, drücken, loslassen): keine Konsolenfehler.
- Rendere mit
- 3D-Modell. Führe aus:
blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Es schreibt ein 27 KB GLB, etwa 9 cm breit, erneut importiert und überprüft. - Szenen und
--eyes-off. Eine Szene, die Claude zur Bauzeit posiert, muss sie erneut innerhalb vonpose(f)posieren;--eyes-offwirkt nur dort (siehestills/director_hero).
Qualitätsprüfungen (tools/qa_loop.py)
FEHLER:
- Falsche Frame-Anzahl.
- Eine Naht: Der Schritt vom letzten Frame zum ersten ist größer als das 90. Perzentil der normalen Schritte.
WARNUNG:
- Identische aufeinanderfolgende Frames (ein Stillstand).
- Bewegung unter 0,8 % der mittleren Helligkeit. Gemessen [M]: Referenzen r2/r3/r4 1,65/1,97/1,07 %,
claude_isla0,89 %,claude_fogata1,66 %.
Die Qualitätssicherung kann Geschmack, schauspielerische Leistung oder Bildausschnitt nicht beurteilen. Diese werden durch Augenschein an Standbildern und Streifen geprüft.
Bekannte Fehler (references/KNOWN_ERRORS.md)
Die Fehler, die ein erneutes Rendern erfordern:
- Ein Arm, der über etwa 70° angehoben wird, versteckt sich neben dem Körper.
- Helle Emissionen bleichen unter AgX zu Weiß aus: verwende
flame_mat. - Ein seitliches Key-Licht lässt die Vorderseite dunkel.
- Eine Nachtszene, gemessen mit absoluten Graustufen, wirkt "zu ruhig".