Was macht Film-Build?
Start
sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film> # lehnt einen nicht leeren Ordner ab
cd marketing/videos/<film> && npm i && npx playwright install chromium # falls NEXT angezeigt wird
Das Kit enthält:
| Datei | Beschreibung |
|---|---|
film/core.js | Die Engine: scene({name, from, to, build, run, after}) (Zeiten in Beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start() |
film/film.js | Ein Starter mit allen untenstehenden Hilfsfunktionen und vier Beispiel-Shots (Linie, Eingabeaufforderung, Split, Persona-Karte). Jeder Hilfsfunktions-Kommentar gibt an, von welcher Ablehnung sie stammt. Ersetze die Shots, behalte die Hilfsfunktionen. |
film/mock.js | window.MOCK: HTML für echte UI-Teile (Dashboards, Fenster, Telefonbildschirme), in Bildschirm-Px |
film/index.html | Lädt Schriftarten aus assets/fonts/{display,ui}.woff2 (mit lokalen Sans-Fallbacks) |
scripts/render.mjs | --sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all |
scripts/sync.mjs | Kopiert timeline.json in die Seite |
scripts/review.py | Kritik-Kit aus dem gerenderten MP4: Kontaktabzug, Streifen der höchsten Aktivität, Telefonansicht, 9:16-Sicherheitszonen, Metriken |
tools/probe.mjs | cuts (jeder Schnitt und Mittelpunkt jedes Shots, in Videosekunden) oder jeder Ausdruck, z. B. "window.UNWARP(12.4)" |
tools/sheet.py | Ordne Standbilder zu einem beschrifteten Blatt an |
tools/pack_grid.py | Schneide ein 4×3-Charakterblatt (transparent oder auf weiß) in einen 12-Zellen-Streifen für sprite(); gibt die Zellengröße aus |
tools/cut_cast.py | Zerlege eine einreihige Aufstellung in einzelne Standbild-Charaktere |
assets/characters/ | Vier Beispielcharaktere (Gründer, Entwickler, Verkäufer, Student), 12-Frame-Streifen mit 360-Px-Zellen |
tools/same.sh | save / check PSNR-Regression zwischen Vorher- und Nachher-Standbildern |
Hilfsfunktionen im Starter (verwende sie, erfinde sie nicht neu)
io(quintisch rein-raus) für Kamerafahrten und Morphs;oq(quintisch raus) für Eingänge;backfür einen kleinen Überschwinger.cam(e, s, fx, fy)setzt den Fokuspunkt (fx, fy) einer 1920×1080-Ebene bei Skalierung s in die Bildmitte.camDmacht dasselbe, zeigt aber nie über die Ebenenkanten hinaus (Cover-Skalierung; bei 9:16 unerlässlich).posIn(e, root)liest die Position eines Elements innerhalb der bewegten Ebene (für Cursor-Ziele, Caret-Verfolgung).typed()für Buchstaben, die nacheinander in einer Zeile erscheinen;keyed()für eine echte Tastatur: unregelmäßiges Timing pro Zeichen, längere Pausen bei Leerzeichen, ein blinkendes Caret danach.wordsHTML()legt jedes Wort ab dem ersten Frame in seiner endgültigen Breite an, transparent bis zu seinem Zeitpunkt, sodass die Zeile nie umfließt („Textübergang ist überhaupt nicht flüssig“).cursor()/putCursor()/bump(): Ein echter Pfeilcursor, der gleitet, früh ankommt, bei einem Klick um 15% eintaucht.pop()für kleine Objekte, die landen.sprite(parent, src, cellW, cellH, h)/putSprite(e, t, a, z, loops)für einen gezeichneten Charakter: Durchläuft seine 12 Frames von a bis z, mit einem kleinen Atemzug, damit er nie stillsteht. Es ist ein<img>, also wartet die Engine darauf.shot(name, t0, t1, build, run)kapseltscenein Sekunden.- Tempowechsel unten:
SLOW(globale Dehnung),EVhält (friert einen Moment zum Lesen ein) und Einfügungen;window.CUTSundwindow.UNWARPgeben Videosekunden für Ton- und Sprachplatzierung. PT/pk(a16, a9)wähle formatabhängige Werte in einer Datei.
Regeln der Engine (Determinismus)
Der Film ist eine reine Funktion von t. Jeder Frame muss identisch aussehen, egal ob er zuerst oder nach jedem anderen Frame gerendert wird.
- Nur 2D-Transformationen: kein
translate3d, keinwill-change, keine CSS-Transitions, keinMath.random(verwende einen Hash eines Index). - Zu Beginn versteckte Elemente:
reg(el, {o: 0}), niemalsopacity:0inline. - Layout in
after()oder einmal inbuildmessen, niemals innerhalb vonrun(es liest den vorherigen Frame). - 3D-Ansichten: Jeden Frame mit
insertBefore(v, firstChild)neu einfügen, damit kein gecachtes Raster überlebt. - Eingebettete CSS-Animationen (z. B. ein Produkt-Widget-Eigen): Sie pausieren und setzen
animation-delay: calc(-1s * var(--t)). - Warte auf Bilder und Schriftarten (
decode(),document.fonts.ready) vor dem ersten Frame. - Produkt-CSS unter einer eindeutigen Root-Klasse zusammenfassen; verwende eindeutige Klassennamen im Film (
.wist einmal durchgesickert). classList.add, niemalsclassName =.node scripts/render.mjs --verifymuss vor jedem versendeten Render 12/12 ausgeben.
Realismus: Lies references/realism.md vor dem Erstellen eines Bildschirms
Kurzfassung: Echte Apps in echter Dichte, echte Logos von den Websites der Marken, OS-Chrome mit Apps, die auf diesem Betriebssystem existieren, echte Hintergrundbilder, Telefone auf dem echten Launcher-Raster in echten dp-Größen, gezeichnet vom eigenen Renderer des Produkts, Produkt-UI reichhaltiger als du denkst, eine nominative Nutzungszeile, wann immer ein Markenzeichen gezeigt wird.
Build-Schleife (überprüfungsgesteuert)
- Shot-Liste vom genehmigten Storyboard in
film.js, jeder alsshot(), überlappend für Übergaben. - Zuerst Standbilder.
node tools/probe.mjs cuts→ Rendere ein Standbild an jedem Shot-Mittelpunkt und jeder Übergabe:node scripts/render.mjs --at …dannpython3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. Lies das Blatt selbst. Korrigiere. Wiederhole. (Ca. 1–2 Minuten pro Runde, gegenüber 25+ für einen vollständigen Render.) - QA-Durchlauf VOR jedem versendeten Review: Gehe den Film bei ≤ 1,5 s und an jeder Übergabe durch (10–15 fps Kontaktabzug über jeden Übergang). Überprüfe
references/qa.mdZeile für Zeile: Überlappungen, Clipping, leere Frames, Lesezeit, Textglätte, Tippen, Logohinweis, OS-Realismus, Telefongrößen. - Sende Standbilder (das Blatt) an den Eigentümer für den ersten Blick. Warte.
- Entwurf:
node scripts/render.mjs --draft(30 fps, ~4 Min.),python3 scripts/review.py 1 --draft, lies die Streifen. Sende das Entwurfs-MP4. Sage klar, dass es ein 30-fps-Entwurf ohne Unschärfe ist (sieht ruckeliger aus als das Endergebnis). - Bei „Render final“:
node scripts/render.mjsim Hintergrund (60 fps, Bewegungsunschärfe; ~25–35 Min. für 60 s). Bearbeitefilm.jsniemals während des Renderings: Kopiere zuerst das Projekt, wenn du weiterarbeiten musst. - Comitte Film-Code und Zeitachse nach jeder genehmigten Runde.
Tempo
Erste Schnitte sind fast immer zu schnell. Bildschirmtext benötigt etwa 0,3 s pro Wort + 1 s bei voller Deckkraft (niemals unter 1,5 s). Bevorzuge die Verzerrung (SLOW 1,1–1,25, EV hält bei Zeilen) gegenüber der Neujustierung jedes Shots. Nach jeder Tempowechsel führe probe.mjs cuts erneut aus, da sich Ton und Sprachpositionen verschieben.
9:16: Lies references/formats.md
Bilde denselben Film in einer Datei mit pk() neu ein; beweise mit tools/same.sh, dass 16:9 unverändert bleibt (jedes Standbild PSNR = inf); --verify --fmt 9x16; Standbildblatt für den Eigentümer; dann --fmt 9x16 final im Hintergrund, dann --mux --fmt 9x16.