motion-graphics
Ein Video ist eine HTML-Seite, deren jedes Pixel eine reine Funktion der Zeit t ist, die Frame für Frame in Headless-Chromium gerendert und mit ffmpeg codiert wird. Das Ziel ist das Showreel eines erfahrenen Motion-Designers, niemals eine Diashow.
1. Wähle das Format
| Anfrage | Lese |
|---|---|
| Launch, Promotion, Werbung, Feature-Reel, App-Trailer für ein echtes Produkt | formats/launch-video.md |
| Shorts, Reels, TikTok, vertikaler Erklärfilm oder Story | formats/shorts.md |
Folge der Formatdatei für das Briefing, die Inhaltsschritte und die Beat-Struktur. Diese Datei verweist für den Bau wieder hierher zurück. Lies auch references/pitfalls.md, bevor du die Komposition schreibst.
Jedes Mal ein neues Konzept. Jedes Video erhält seine eigene Idee, sein eigenes Skript und Aussehen. Wenn der Benutzer sagt, dass frühere Arbeiten nicht angesehen werden sollen, lasse frühere Videos und Kompositionen im Arbeitsbereich ungeöffnet.
2. Arbeitsordner
Erstelle <slug>-<YYYYMMDD>/ dort, wo der Benutzer es wünscht (Standard: das aktuelle Verzeichnis):
brief.md Parameter aus der Briefing-Tabelle des Formats
beats.md Der Beat-Sheet (Zeit, Text, Asset, Bewegung, Übergang, Akzent-Hit)
assets/ Aufnahmen, Bilder, Schriftarten, Audio
assets/manifest.md Eine Zeile pro Asset-Datei: Quelle, Lizenz oder "aufgenommen von <Oberfläche>", was es zeigt
motion.html Die Komposition
motion.json {"size": [W, H], "fps": 60, "duration": 30, "stills": [Beat-Zeiten], "captions": []}
engine/ Kopiert aus dem engine/-Ordner dieser Fähigkeit
out/ Standbilder, Renderings, Kontaktbogen
Richte die Engine einmal pro Ordner ein:
cp -R <diese-faehigkeit>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. Komponieren
motion.html lädt engine/runtime.css und engine/runtime.js, erstellt sein DOM, registriert Szenen und ruft dann MG.ready() auf.
| Hilfsfunktion | Verwendung |
|---|---|
MG.scene(start, end, fn, el) | fn(local, t, dur) wird ausgeführt, während start <= t < end; el ist außerhalb versteckt. Setze jede animierte Eigenschaft bei jedem Aufruf. |
MG.always(fn) | Wird bei jedem Frame ausgeführt: Hintergründe, Körnung, Fortschrittsbalken. |
MG.prog(t, a, b, ease) | Eased 0..1 Fortschritt. Eases: MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) oder jede Funktion. |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | Keyframes; Werte können Arrays sein. |
MG.spring(t, {stiffness, damping}) | Physikalischer 0 → 1 mit Überschwingen. |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | Ein Aufruf pro Element pro Frame. |
MG.clip(videoEl, start, rate) | Spielt eine Bildschirmaufnahme framegenau ab start ab. |
MG.rng(seed), MG.noise(x, seed) | Deterministische Zufälligkeit und Wackeln. |
MG.fmt(n, {decimals}) | Formatierung von Zahlen für Zähler (lokalisiert). |
MG.captions() | Zeichnet motion.json-Untertitel oberhalb des unteren UI-Blocks. |
Determinismus: Kein Date, performance.now(), requestAnimationFrame oder Math.random in der Renderlogik. CSS @keyframes sind erlaubt; die Laufzeit pausiert sie bei t, also zeitlich mit animation-delay. Verwende nur Schriftarten und Bilder, die im Manifest aufgeführt sind.
Vorschau eines Frames: open "motion.html?w=1920&h=1080&t=3.2&guides=1" (Guides zeigen sichere Zonen). Echtzeit: ?play=1. Untertitel werden nur in Renderings angezeigt.
4. Handwerksniveau
- Frame 0 ist bereits in Bewegung. Kein Einblenden aus Schwarz, kein Logo-Intro.
- Alle 0,8–2 s ändert sich etwas Sinnvolles: Layout, Skalierung, Farbe, Zahl oder Kamera.
- Eintritte verwenden Federn oder ease-out-expo mit leichtem Überschwingen; 30–60 ms Staffelungen; linear nur für Ticker.
- Bewegungsunschärfe nur bei schnellen Bewegungen; ein langsamer Zoom (Skalierung 1 → 1,04) bei gehaltenen Aufnahmen; Parallaxe über 2–3 Tiefenebenen.
- Eine Hintergrundfamilie, eine Textfarbe, ein Akzent. Füge Körnung oder Gradient-Rauschen hinzu, damit einfache Flächen nach dem Hochladen nicht streifen.
- Text bleibt lange genug auf dem Bildschirm, um zweimal gelesen zu werden; Schlüsseltext bleibt innerhalb der sicheren Zonen.
- Beats landen auf Ton: ein Whoosh, Hit oder Musikbeat bei jeder Änderung.
5. Rendern
node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4
Lege zuerst das Layout mit Standbildern fest: eines pro Beat, eines innerhalb jedes Tweens, eines an jedem Überschwing-Peak einer Feder. Führe jeweils ein vollständiges Rendering durch (etwa 10 Minuten für 25 s bei 1080p60 mit 4 Workern).
6. Audio
Verwende nur Musik und Soundeffekte, die im Manifest mit einer für die Nutzung geeigneten Lizenz aufgeführt sind, oder Dateien, die der Benutzer bereitstellt. Ohne diese liefere stumm aus und sag es. Mische Cues, dann multiplexe:
ffmpeg -i music.wav -i whoosh.wav -filter_complex \
"[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
-af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"
Ziel ist etwa −14 LUFS integriert und True Peak bei oder unter −1 dBFS. Soundeffekte liegen etwa bei −6 bis −14 dB, Musik bei −14 bis −18 dB. Musik unter Texteinblendungen ist instrumental.
7. Qualitätssicherung
ffprobe-Dauer, -Größe und -Bildrate entsprechen dem Brief.- Kontaktbogen:
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. Betrachte ihn und ein Vollbild-Frame bei jedem Beat-Wechsel (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png). - Jeder Frame: nichts an den Rändern abgeschnitten, keine leeren oder halb ausgeblendeten Frames, keine überflüssigen Hilfslinien, keine Tippfehler oder Platzhaltertexte, nichts länger als 2 s statisch.
- Die eigenen Prüfungen der Formatdatei.
Behebe und rendere erneut, bis alle Prüfungen bestanden sind. Füge jede neue Erkenntnis als datum · video · lektion in references/pitfalls.md in der Fähigkeit hinzu.
Lieferung
Melde den endgültigen MP4-Pfad, Länge, Größe und Bildrate, was es zeigt, Audio-Status mit erforderlichen Credits und die Neurender-Befehle. Behalte den Arbeitsordner. Lade hoch oder veröffentliche nur, wenn der Benutzer danach fragt.