Code-Animation-Werkstatt (Code Animation)
Erstelle einen 1–2-minütigen Animationskurzfilm zu einem abstrakten Konzept. Kein generatives Video – jeder Frame ist ein im Browser berechnetes Vektorbild, das Frame für Frame reproduziert und lokal bearbeitet werden kann.
Das Ergebnis ist eine MP4-Datei sowie eine wiederverwendbare storyboard.json.
Drei-Schritte-Workflow
# 1. Storyboard validieren
python scripts/lint.py storyboard.json
# 2. Bauen + rendern (ca. 0,5 s/Frame)
python scripts/build.py storyboard.json out.html
python scripts/render.py --html out.html --duration 117 --fps 30 --out film.mp4
# 3. Qualitätsprüfung – bei Nichtbestehen wird Exit-Code != 0 zurückgegeben
python scripts/measure.py film.mp4 --thresholds reference/thresholds.json
Wenn die Qualitätsprüfung nicht bestanden wird, nachbessern – nicht mit „sieht gut aus" abnehmen.
Musikuntermalung (optional, aber dringend empfohlen)
Das Audio wird ebenfalls berechnet, nicht aus einer Bibliothek gesampelt – genau wie das Bild.
# 1. Musik synthetisieren (numpy, ca. 40 s)
python scripts/make_audio.py score.wav --storyboard storyboard.json
# 2. In Video muxen, gleichzeitig in H.264 konvertieren und Größe reduzieren
python scripts/mux.py --video film.mp4 --audio score.wav --out final.mp4 --crf 23
Standardmusik ist für Weltraum-/Physikthemen ausgelegt: D-Moll-Grundton, tiefe lange Töne, pro Szene wechselnder Akkord-Pad, 8-Sekunden-Herzschlagimpuls, spärlich gezupfte Saiten. An Übergängen gibt es Noise-Sweeps, an Kapitelmarken tiefe Bässe.
Bei Themenwechsel die Musikparameter anpassen, nicht einfach übernehmen:
| Thema | Änderung der Musik |
|---|---|
| Physik / Astronomie | Standard beibehalten: Moll, lange Töne, spärlich |
| Mathematik / Algorithmen | Zu Dur oder lydischem Modus wechseln, regelmäßige Arpeggios hinzufügen |
| Geschichte / Geisteswissenschaften | Impuls entfernen, Pad verlangsamen, einige Dissonanzen hinzufügen |
| Produkt / Technik | Pad-Langtöne entfernen, durch 90–110 BPM Synthesizer-Rhythmus ersetzen |
Parameter befinden sich in make_audio.py oben als Konstanten SCALE / ROOT / bpm sowie im build()-Array chords.
storyboard.json
{
"title": "Schwerkraft",
"fps": 30,
"palette": { "bg": "#08090F", "ink": "#E6DCCB", "dim": "#8A8177", "accent": "#E0813C" },
"scenes": [
{
"id": "open",
"kind": "title",
"dur": 6.0,
"cn": "引力",
"en": "GRAVITY"
},
{
"id": "newton",
"kind": "orbit",
"dur": 16.0,
"chapter": ["I", "苹果与月亮", "THE APPLE AND THE MOON"],
"subs": [
[0.6, "1687 年,牛顿用一个公式,把苹果和月亮绑在了一起。"],
[7.4, "引力与质量成正比,与距离的平方成反比。"]
]
}
]
}
| Feld | Beschreibung |
|---|---|
kind | Name der Shot-Vorlage, siehe Tabelle unten |
dur | Dauer des Shots (Sekunden), empfohlen 12–20 |
chapter | [Nummer, Titel Deutsch, TITLE ENGLISH], oben links dauerhaft sichtbar |
subs | [Startsekunde, Text]-Array; jede Anzeige sollte 5–6 Sekunden lang bleiben |
cn / en | Für Titel-Shots verwendet |
Shot-Vorlagen (8 Stück)
| kind | Darstellung | Verwendung |
|---|---|---|
title | Großer Titel + kleiner englischer Untertitel | Eröffnung |
outro | Zwei Schlussfolgerungen | Abschluss |
orbit | Elliptische Umlaufbahn + Polarkoordinatenraster | Periodische Bewegungen, Schwerkraft |
precess | Präzessionsblütenblätter + Winkelscheibe | Kleine Abweichungen, Präzession |
elevator | Kasten mit innerer Skala | Bezugssysteme, Äquivalenzprinzip |
warp | Perspektivisches Raumzeitgitter + Führungslinien | Krümmung, Felder |
evidence | Linsenartige konzentrische Ringe + Chirp-Wellenform | Evidenz, Signale |
blackhole | Akkretionsscheibe + Photonenring + ringförmige Skala | Extreme Himmelskörper |
Vorlagenparameter befinden sich in templates/shots/*.json.
Sechs-Schichten-Architektur (Warum diese Anordnung)
L5 Postprocessing Bloom → Vignette → Körnung
L4 Text Kapitelmarken / großer Text / Formeln / Untertitel
L3 Annotationen Führungslinien + kleine Labels + Messanzeigen
L2 Hauptinhalt Kernzeichnung des Shots
L1 Struktur Gitter / Skalen / Koordinatenachsen
L0 Hintergrund Nebel / Punktmuster / Staub / entfernte Sterne
L1 und L3 sind die Quelle des „professionellen Looks", nicht L2. Ein Bild nur mit dem Hauptinhalt wirkt schlicht; sobald Struktur- und Annotationsebene hinzugefügt werden, wird dasselbe Bild zu einer „Instrumentenanzeige".
base.html implementiert bereits alle sechs Schichten; neue Shots müssen nur die Zeichenfunktion für L2 schreiben.
Akzeptanzschwellen
reference/thresholds.json:
{
"frame_diff_min": 1.5,
"moving_ratio_min": 0.70,
"coverage_min": 0.20,
"luma_range": [16, 30]
}
| Metrik | Bedeutung | Warum |
|---|---|---|
frame_diff | Durchschnittliche Differenz zwischen benachbarten Frames | Unter 1,5 ergibt eine „Diashow", keine Animation |
moving_ratio | Anteil der Frames mit Bewegung | Unter 70 % wirkt es „stockend" |
coverage | Anteil der Pixel mit lokaler Struktur | Unter 20 % wirkt das Bild leer |
luma | Durchschnittliche Helligkeit | Unter 16 versinken alle Strukturen im Schwarz; über 30 geht der düstere Grundton verloren |
Diese Schwellen wurden mit echten Referenzclips kalibriert – nicht einfach anpassen. Details siehe reference/findings.md.
Bekannte Fallstricke (aus schmerzhafter Erfahrung)
1. Niemals ctx.shadowBlur verwenden.
Dutzende von Schatten pro Frame im Software-Rendering erhöhen die Rechenzeit von 20 ms auf 5 Sekunden pro Frame. Stattdessen bloom() aus base.html verwenden – die Leinwand auf 1/6 verkleinern, dann überlagern und vergrößern, zwei drawImage-Aufrufe, nahezu kostenlos.
2. Parameter müssen aus derselben Quelle stammen.
Es gab einen Bug, bei dem „Punkte außerhalb der Linie" liefen: Die Linie wurde mit p² berechnet, der Punkt mit p. Pfad und Kopf desselben Objekts müssen von derselben Variable gesteuert werden.
3. Körnung bestimmt die Dateigröße. Frame-für-Frame-Zufallsrauschen hat eine extrem hohe Entropie, die Videocodierer nicht komprimieren können. Bei α=0,03 Körnung sind es etwa 50 KB/Frame bei 1080p30 – das sind ca. 300 MB für ein zwei Minuten langes Video. Für kleinere Dateien α reduzieren (etwa 0,015) oder die Bildrate senken – nicht auf den Codierer hoffen.
4. Frame-Format JPEG verwenden, nicht PNG. Die Codierung von PNG mit Körnung dauert mehr als viermal so lang wie JPEG (gemessen 2,0 s/Frame vs. 0,5 s/Frame).
5. Helligkeit ist kein Filter.
Nicht CSS brightness() zum Aufhellen verwenden – das bleicht auch den Text aus. Stattdessen die Alpha-Werte der Inhaltsebenen erhöhen (Gitter, Nebel, Staub), gemäß der Verteilung in reference/palette.json.
Neue Shots erweitern
- In
drawScene()inbase.htmleinen neuencasehinzufügen - Nur L2 (Hauptinhalt) zeichnen; L1 mit
polarGrid/ringTicks/axisTicks/drawInstrumentund L3 mitdrawLeaderverwenden - Anpassbare Parameter als Objekt auslagern und in
templates/shots/<name>.jsonspeichern measure.pyausführen – erst wenn alle drei Metriken bestehen, ist der Shot fertig
Beispiel
examples/gravity.storyboard.json – Vollständiges Storyboard für den Zwei-Minuten-Film „Schwerkraft" mit acht Shots, alle verwendbar. Kann als Ausgangspunkt direkt mit eigenem Text bearbeitet werden.