Beat-gesteuerte prozedurale Bewegungsgrafiken
Produzieren Sie Studio-Kinotypografie und prozedurale Bewegungsgrafiken mit einer vierstufigen Code-Pipeline:
index.html (HTML5 Canvas Beat-gesteuerter Renderer)
↓ Frame-für-Frame-Erfassung (10× Verschluss-Bewegungsunschärfe)
scripts/render.py (Headless Chrome CDP → ffmpeg H.264)
↓
make_audio.py (Prozedurale Wellenform & EDM-Synthese auf dem gleichen Beat-Raster)
↓
ffmpeg mux → final.mp4 (1920×1080, 60 fps, AAC Stereo)
Alles – Bilder, Übergänge, Kamera-Wackeln, Glitch-Effekte, Drums, Akkorde und Risers – wird durch Beat-Nummern auf einem einzigen gemeinsamen Tempo-Raster gesteuert (Standard 128 BPM). Keine manuelle Timeline-Ausrichtung, keine externen Stock-Footage, keine Drittanbieter-Python-Pakete.
Arbeitsablauf
Schritt 1 — Umgebungsprüfung
Überprüfen Sie vor dem Erstellen von Dateien die lokalen Voraussetzungen:
ffmpeg/ffprobe(mitlibx264undaacEncodern).- Headless Chrome / Chromium-Binärdatei (
Google Chromeunter macOS,chromium/google-chromeunter Linux). - Verfügbare Systemschriftarten, die zum Zieltext passen (z.B. fette geometrische Sans für Latein, PingFang / Hiragino / Noto Sans für CJK, Monospace für HUD/Code).
Schritt 2 — Beat-basiertes Storyboard
Konvertieren Sie das Thema des Benutzers in ein Beat-Blatt, bevor Sie Rendering-Code schreiben.
- Wählen Sie die Dauer: 15 s = 32 Beats oder 30 s = 64 Beats bei
128 BPM(SPB = 60 / 128 = 0,46875 s/Beat). - Folgen Sie dem narrativen Bogen in storyboard-prompt-template.md: Hook → Spannung / Kontrast → Konzeptbilder (Graph / Tunnel / Morph / 3D) → Schneller Aufbau + Countdown → 0,1 s Stille Blackout → Partikel-End-Höhepunkt.
- Halten Sie den Text auf dem Bildschirm extrem prägnant: 1–3 englische Heldenwörter (200–400 px) gepaart mit maximal einer kurzen Untertitelzeile (36–70 px). Schreiben Sie niemals Absätze.
Schritt 3 — Erstellen von index.html (Visual Engine)
Erstellen Sie einen eigenständigen Single-File HTML5 Canvas Renderer (1920×1080), der Folgendes bereitstellt:
window.READY === truenachdem Schriftarten, Offscreen-Sprites, Morph-Formen und Partikelziele die Initialisierung abgeschlossen haben.window.TOTAL(ganzzahlige Gesamt-Frame-Anzahl, z.B.900oder1800).window.MB(konfigurierbare Anzahl von Bewegungsunschärfe-Sub-Samples, Standard10für End-Render,1für schnelle Vorschau).window.frameData(frameIndex, quality)gibt eine JPEG Data URL für diesen genauen Frame zurück.
Befolgen Sie die visuellen Primitive und die Post-Processing-Pipeline in visual-style-guide.md.
Schritt 4 — Visuelle Standbild-Inspektion (Obligatorische Hürde)
Führen Sie niemals blind einen vollständigen Render mit 900–1800 Frames durch. Erfassen Sie immer zuerst 12–16 repräsentative Keyframes und inspizieren Sie diese als Kontaktabzug:
python3 scripts/render.py --html ./index.html --stills 60,200,330,420,560,780,920,1110,1280,1450,1560,1650,1760
ffmpeg -y -loglevel error -pattern_type glob -i 'preview/f*.jpg' -vf "scale=640:360,tile=4x4" -frames:v 1 preview/sheet.jpg
Inspizieren Sie preview/sheet.jpg und überprüfen Sie:
- Kein Text kollidiert mit dem Corner-HUD (halten Sie den Hauptinhalt innerhalb
y ∈ [100, 980],x ∈ [100, 1820]). - Alle Schriftarten wurden korrekt geladen (kein Tofu / Fallback-Serifen-Fehler).
- Der Kontrast ist bei hellen und dunklen Szenen lesbar; der
difference-Blend des HUD bleibt lesbar. - Bewegungsunschärfe, Glühen und Partikel-Konvergenz sehen sauber und zentriert aus. Beheben Sie Layout-Probleme und überprüfen Sie erneut, bevor Sie den vollständigen Render starten.
Schritt 5 — Erzeugen eines prozeduralen Soundtracks (make_audio.py)
Passen Sie make_audio_template.py an die genauen BPM, BEATS, SCENE_TRANSITIONS und DROP_BEAT an, die in index.html verwendet werden. Siehe audio-synthesis-guide.md für die Syntheseregeln.
Überprüfen Sie die generierte music.wav vor dem Multiplexen:
- Die Dauer entspricht exakt
BEATS * 60 / BPM. - Rendern Sie ein Spektrogramm (
showspectrumpic) oder eine RMS-Prüfung pro Sekunde, um saubere Dynamik, klare Beat-Struktur und die ~0,1 s Stille-Lücke vor dem Drop zu bestätigen.
Schritt 6 — Vollständiger Render & Mux
- Rendern Sie alle Frames mit 60 fps und
MB=10Bewegungsunschärfe:python3 scripts/render.py --html ./index.html --out video.mp4 --mb 10 - Multiplexen Sie Video und Audio mit Stream-Kopie für das Video:
ffmpeg -y -loglevel error -i video.mp4 -i music.wav \ -c:v copy -c:a aac -b:a 256k -shortest final.mp4 - Führen Sie eine abschließende
ffprobe- + 6-Frame-Kontaktabzug-Prüfung vonfinal.mp4durch, um1920x1080,60 fps,h264 + aac, genaue Dauer und saubere Ausgabe zu bestätigen.
Harte Einschränkungen & Engineering-Regeln
- Einheitlicher Beat-Takt: Sowohl
index.htmlals auchmake_audio.pymüssen die Zeit streng ausbeat = t / (60 / BPM)ableiten. Verwenden Sie niemals hartcodierte magische Millisekunden-Offsets, die von der Musik abweichen können. - Deterministisches Rendering: Verwenden Sie einen gesetzten PRNG (z.B.
mulberry32), der auf Frame/Element-Index basiert – niemalsMath.random()innerhalb der Render-Schleife – damit 10× Bewegungsunschärfe-Sub-Samples kohärent bleiben ohne chaotisches Flackern. - 10× Verschluss-Bewegungsunschärfe: Mitteln Sie
10Sub-Frames über ein0,75-Frame-Verschlussfenster (alpha = 1 / (k + 1)Akkumulation). Weniger als 8 Samples erzeugen stufenweise Geisterbilder bei schneller Kinotypografie. - Zero-Dependency Python:
render.pyundmake_audio.pydürfen nur die Python-Standardbibliothek verwenden (os,json,subprocess,base64,math,random,wave,array), damit sie überall ohnepip installodernumpylaufen. - Vorberechnen von teuren Glüheffekten: Vermeiden Sie es,
ctx.shadowBlurpro Frame über 10 Bewegungsunschärfe-Pässe bei komplexem Text/Karten aufzurufen. Rendern Sie glühende Helden-Sprites vorab auf Offscreen-Canvas währendinit()oder verwenden Sie gestapelte Niedrig-Alpha-Striche (glowStroke). - Stille vor dem Drop: Fügen Sie ca.
0,10 svollständige visuelle Schwarzblende und vollständige Audio-Stille unmittelbar vor dem Höhepunkt-Drop-Beat ein, um die wahrgenommene Wirkung zu maximieren. - Faktentreue: Wenn das Video reale Produkt-/Technologiebehauptungen präsentiert, überprüfen Sie zuerst die Fakten und lassen Sie unbestätigte Zahlen weg (wie widersprüchliche Preise oder nicht verifizierte Benchmark-Prozentsätze).