Produkt-Promo-Film, gerendert als Code
Eine Seite, eine Leinwand, und seek(t) zeichnet den Frame zum Zeitpunkt t von Grund auf neu. Headless Chrome erfasst N Subframes pro Frame, ffmpeg mischt und codiert sie. Der Film ist eine Funktion; das Video ist eine Abtastung davon – was jeden Frame überprüfbar, jede Änderung kostengünstig und die Schleife exakt macht.
Diese Dateien werden mit dieser Fähigkeit ausgeliefert. Kopiere sie in den Arbeitsordner des Films; schreibe die Engine nicht neu.
| Datei | Was es ist |
|---|---|
template/promo.html | Die Engine plus eine 8-Sekunden-Demo: geschlossene Formfedern, Summen-von-Federn-Tracks, eine Kamera, Texthilfsprogramme (tabellarische Ziffern, Flip), Schlagzeilen, einen echten Cursor, eine Ein-Objekt-Morph-Kette und einen WebGL-Compositor für echtes 3D. Öffnet und rendert sofort. |
template/reel.html | Ein langer Film auf einer Zeitleiste: sechs Szenen, sechs Formate (kinetischer Text, ein Browser, ein Bento-Raster mit Fokusverlagerung, ein Terminal, ein 3D-Coverflow von Geräten, eine Endkarte), fünf Übergänge, ein Look pro Szene, Kapitel. ~56 s, kein Loop. Der Katalog von §2, in Aktion. |
template/film.js | Die Engine, die die Seiten gemeinsam nutzen: die Bühne (Subpixel-Jitter pro Subframe, sodass bei langsamen Bewegungen nichts stufenweise oder flimmert), FILM.draw für Raster, Federn und Kameras, die Zeitleiste (Szenen, Kapitel, Checkpunkte und vierundzwanzig Übergänge: sechzehn auf der 2D-Leinwand, acht als Fragment-Shader in einem WebGL2-Kontext) und Effekte (Tiefenschärfe, Ausschnitt-Text, Schreibmaschineneffekt). Oben dokumentiert. |
template/parts.js | Vektorteile: ein macOS-Fenster, ein Browser, ein Terminal, ein iPhone, ein iPad, ein MacBook, ein iMac, Tastenkappen, ein Schalter, ein Ring, eine Schaltfläche, der Zeiger. Jedes gibt das Rechteck zurück, in das sein Inhalt passt. |
template/parts.html | Jedes Teil auf einem 16:10-Blatt, eine Seite wie die anderen: PAGE=parts.html node render.mjs stills parts 0 erstellt das PNG, aus dem docs/parts.jpg konvertiert wird (sips -s format jpeg -s formatOptions 92). |
template/fx.js | Der Look, geladen von der Seite: ein Hintergrund (einfarbig, Verlauf, Feld oder Bild; sanftes Markenlicht; Punkte, Raster oder Linien in Parallaxe; ein Boden in Perspektive; ein Scheinwerfer), ein Finish (Vignette, Körnung) und die darauf aufbauenden Effekte (Milchglas, Klickwellen, Fokus-Pull-Schlagzeilen). Dreiundzwanzig Voreinstellungen und photo, jedes Feld überschreibbar, oben in der Datei dokumentiert. Geteilt mit release-film. |
template/type.js | Schlagzeilen und kinetischer Text (§3): TYPE.draw(ctx, t, spec) in dreizehn Stilen – rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode – mit einem Betonungszeichen, einem Tempo und TYPE.load für die Schriften einer Familie. Eine reine Funktion von t, wie der Rest. |
template/fonts/ | Zwanzig frei lizenzierte Familien (latin + latin-ext woff2, jeweils mit OFL.txt) und fonts.json, ihre Schriften. Ein Film kopiert nur das, was er verwendet, nach src/fonts/; scripts/fonts.mjs add holt eine weitere. |
scripts/render.mjs | stills <dir> t…, sheet <dir> (die Checkpunkte der Zeitleiste), looks <dir> <t>, loopcheck, video <out> [workers]. Liest Größe, fps, Dauer und Kapitel aus der Seite; jittert jeden Subframe; rendert in fortsetzbaren Blöcken; FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER=; die Erweiterung wählt das Format (.mp4, .mov ProRes, .webm, .gif; HEVC=1; ALPHA=1 für ein transparentes .mov oder .webm); prüft den Track vor dem Rendern und die Datei danach; schlägt fehl bei einer Aufnahme, deren Seite einen WebGL-Kontext verloren hat, und bei einem zweiten Rendern eines Schnitts, während einer läuft. Oben dokumentiert. |
scripts/narrate.mjs | Die Geschichte eines Films (story.json: ein Satz pro Schritt, das Tutorial oder das Promo, das spricht) in eine Stimme, eine Uhr und Untertitel: voice/*.aiff, narration.wav (das AUDIO des Films), narration.js (die Zeit jedes Schrittes, für die Seite) und captions.srt / .vtt. Das say des Macs, oder --from einen Ordner mit eigenen Aufnahmen. "human": "natural" variiert die Pausen wie bei einem Menschen; die Laute eines Modells ([chuckle]) bleiben aus den Untertiteln. Oben dokumentiert. |
scripts/voice.mjs | Dieselbe Geschichte, erzählt von einem Sprachmodell, das auf dem Mac läuft ("mlx" in story.json: Chatterbox für eine Lektion, Orpheus für ein Promo, Kokoro für einen schnellen Entwurf oder einen Film auf Italienisch), näher an einem Menschen als say: es sagt jeden Schritt (voice-mlx.py, über mlx-audio), taktet und pegelt es, ruft dann narrate.mjs auf. Ein Take ist ein Seed; "tone" (calm, warm, bright) bestimmt, wie frei das Modell liest, "human" variiert das Tempo jeder Zeile innerhalb von 3 % und lässt eine Zeile einen Laut machen ([chuckle], [sigh]: die eigene Schreibweise jedes Modells, oder weggelassen). --audition vergleicht Takes, --recordings stoppt bei den Aufnahmen, --setup erstellt das Python und holt die Modelle einmal auf jedem Mac (voice-constraints.txt fixiert, was es installiert) und sagt, ob dieser Mac die hier aufgenommenen Takes wiederholt. Oben dokumentiert. |
scripts/mix.mjs | Eine Stimme und eine Musikspur zu einem Soundtrack, für AUDIO=: beide gemessen (EBU R128), die Musik --under LU unter der Stimme, während sie spricht, --lift dB zwischen den Zeilen an, herunter vor jeder Zeile; gibt aus, was dabei herauskam, gemessen am Ergebnis. Oben dokumentiert. |
scripts/contact.mjs | Ein beschriftetes Kontaktblatt eines Stills- oder Looks-Ordners (Beschriftungen aus labels.json darin); --size BxH macht es genau diese Größe (--font, --gap, --pad; Stills werden nie beschnitten; eine .jpg wird als JPEG geschrieben); --dark für ein dunkles Blatt. --compare A=<verz> B=<verz> [C=<verz>] <aus.png>: zwei oder drei Ordner nebeneinander, eine beschriftete Spalte pro Ordner und eine Zeile pro Still, das sie gemeinsam haben, für eine A/B-Auswahl an einem Bild. |
scripts/beats.mjs | Der Beat eines Soundtracks, aus seinen Samples: Tempo, ob er durchhält, jeder Beat, die Takte, die Abschnitte und die bpm und AUDIO_AT für die Seite; --out beats.js für eine Seite, die einem drifternden Track folgt (FILM.beats). render.mjs importiert es, um die Beats der Seite gegen die des Tracks zu messen. --selftest. |
scripts/clickcheck.mjs | Wird jeder Klick gesehen: für jeden der CLICKS der Seite, wie schnell sich der angeklickte Punkt auf dem Bildschirm bewegt und wie weit der Cursor vor dem Drücken und währenddessen reist. Beende mit 1 bei einem Klick, den niemand sehen wird (release-film §3b), mit 2 bei einer Seite ohne Cursor. |
scripts/layoutcheck.mjs | Ist jede Schlagzeile im Rahmen, getrennt und lesbar: an jedem Checkpunkt, jede Schlagzeile, die TYPE.draw zeichnet, gegen den Safe-Bereich, die anderen Schlagzeilen und den Hintergrund darum (die Grenzen sind im Header). Beende mit 1 bei einer Schlagzeile, die nicht besteht, mit 2 bei einer Seite, die keine durch TYPE.draw zeichnet. |
scripts/deliver.mjs | Der letzte Schritt (§8): Die fertigen Videos und ihre Cover verlassen den Arbeitsordner für einen eigenen Ordner; sobald der Film draußen ist, wirft trash den Arbeitsordner weg, nachdem überprüft wurde, dass seine Quelle sicher im Kit ist. --selftest. |
scripts/fonts.mjs | Die Schriftarten des Kits: add "<Familie>" [Achsen] von Google Fonts mit seiner Lizenz, check, list. |
Daneben befinden sich studio/ (das Studio, unten), guide.md (der geführte Modus, unten) und README.md (der Katalog in Bildern und Beispielanfragen für jeden Moment eines Films).
Einrichtung: ein Arbeitsordner, ~/Downloads/<name>-work/ (~/Downloads ist das Arbeitsstammverzeichnis, sofern nicht workRoot in der Einstellungsdatei (unten) etwas anderes angibt), mit der Seite und diesen Dateien in seinem src/ und npm i playwright-core dort. Es steuert das installierte Chrome über channel: 'chrome', sodass nichts anderes heruntergeladen wird. <name> ist <produkt>-<was> (acme-promo, acme-2.4-whats-new) und benennt auch den Auslieferungsordner und jede ausgelieferte Datei (§8).
Studio: das Briefing in einem Fenster
Der visuelle Einstieg. Ein Assistent in einem eigenen Fenster: Rezepte, Formate, Looks, Bilder vom Mac, Schrift und Bewegung, die auf der echten Engine in Bewegung gezeigt werden, in der Farbe und dem Seitenverhältnis des Produkts, der Ton (die Titel der Musikbibliothek werden abgespielt, die Stimme eines Sprachmodells wird gehört, die eine Zeile sagt, bevor sie ausgewählt wird), und jede Wahl wird in eine einzige brief.json geschrieben. Nichts wird installiert und nichts gerendert. /manovella:studio öffnet es ebenfalls.
- Wann: aufgerufen mit
studio, oder mit nichts, während nichts im Gespräch sagt, welcher Film gemacht werden soll. Ein Benutzer, der in Worten gesagt hat, was er will, geht direkt zu §0. - Ausführen
node <verzeichnis dieser fähigkeit>/studio/studio.mjsvom Arbeitsbereich aus, im Hintergrund (die Geschwister seiner Repositories sind die angebotenen Produkte), und sagen Sie in einer Zeile, dass das Fenster offen ist. Es beendet sich von selbst, gibt eine Zeile aus, und der Exit weckt Sie:BRIEF <pfad>, oderCANCELLED,CLOSED,TIMEOUT(sagen Sie es und stoppen Sie). Das Fenster ist die eigene App des Studios, wo sie auf diesem Mac erstellt wurde (~/Applications/Manovella.app, ihr Name, Version und Symbol im Dock), sonst ein Chrome-App-Fenster;MANOVELLA_WINDOW=chromebehält Chrome bei. Ohne beides öffnet es den Standardbrowser;--no-opengibt stattdessen die URL aus, für eine Sitzung, deren Bildschirm woanders ist. - Die Musikbibliothek ist optional: ein Ordner mit der Musik der Filme des Benutzers, aufbewahrt wo immer sie wollen (ein synchronisiertes Laufwerk, ein Projektordner). Sie ist dort, wo
MANOVELLA_MUSICfür einen Lauf zeigt, sonstmusicLibraryin~/Library/Application Support/manovella/settings.json(~/.config/manovella/settings.jsonaußerhalb von macOS; ein führendes~wird expandiert);musicLibraryIgnorein derselben Datei listet Ordnernamen darin auf, die übersprungen werden sollen, unddeliverToLibrary(true oder false, Standard false) sagt, ob fertige Filme auch darin abgelegt werden sollen. Nichts wird automatisch erkannt. Eine ältere Datei mitbrandLibraryundbrandLibraryIgnorewird alsmusicLibraryundmusicLibraryIgnoremitdeliverToLibraryan gelesen, was sie zuvor tat, und wird bei der ersten Änderung in den Studio-Einstellungen mit den neuen Schlüsseln neu geschrieben. Dieselbe Datei akzeptiertprojectFolders(wo das Studio nach Produkten sucht),pictureFolders(seine Hintergrundbilder; nicht gesetzt:~/Pictures) undworkRoot(wo<name>-workund, sofern der Film nicht in die Bibliothek oder das Projekt keine Anweisung hat,<name>/hingehen; nicht gesetzt:~/Downloads); das Einstellungsfenster des Studios (das Zahnrad neben dem Logo, oder ⌘, inManovella.app) schreibt sie alle, unddeliver.mjsliest auchworkRoot. Nichts sonst im Code liest die Bibliotheksschlüssel: für einen ohne Studio gemachten Film ist dieser Absatz die Anweisung für mich.- Das Studio bietet jede Audiodatei (mp3, m4a, aac, wav, aiff, flac, ogg) auf der obersten Ebene der Bibliothek und in jedem Ordner darin, direkt oder in dessen
audio/-Ordner; Punkt-Ordner und die Namen inmusicLibraryIgnorewerden übersprungen. Ein Ordner pro Marke ist optional und gruppiert seine Titel; der nach dem Produkt benannte Ordner wird zuerst aufgelistet („dieses Produkts“). Eine optionale Notizdatei neben den Titeln (…notes.txtoder.md: ein Absatz pro Titel, beginnend mit dem Dateinamen des Titels: was es ist, seine Stimmung, wo es passt) sagt, wofür jeder ist, und das Studio zeigt sie an. - Fertige Filme: mit
deliverToLibraryan und einer gesetzten Bibliothek,<Bibliothek>/<Marke>/video/<name>/(§8); sonst dort, wo die eigenen Anweisungen des Projekts fertige Medien aufbewahren, sonst<name>/im Arbeitsstammverzeichnis (standardmäßig~/Downloads/<name>/). - Ein neuer Titel, der erstellt wurde (unten), wird in der Bibliothek gespeichert, im Ordner des Produkts, wenn die Bibliothek einen pro Marke führt, mit seinem Absatz in der Notizdatei dieses Ordners, wenn eine Bibliothek existiert; sonst geht er einfach in das
src/audio/des Films. Ein Ordner in einem Dateianbieter (Google Drive, iCloud Drive, Dropbox) kann seine Dateien „dataless“ halten, bis sie geöffnet werden, also öffnen oder kopieren Sie eine Datei, bevor Sie sie messen. Dateien, die eine Bibliothek aufbewahrt, werden kopiert, niemals daraus verschoben.
- Das Studio bietet jede Audiodatei (mp3, m4a, aac, wav, aiff, flac, ogg) auf der obersten Ebene der Bibliothek und in jedem Ordner darin, direkt oder in dessen
brief <pfad>, als Argument oder von einerBRIEF-Zeile: das Briefing lesen; es beantwortet §0.-
formats: []ist meine Auswahl von drei. Für ein Promo oder einen Film in Kapiteln sind ein, zwei oder drei benannte die Storyboard-Formate, in dieser Reihenfolge, und ich wähle den Rest aus, jedes ein anderes; das Format eines Releases und eines Tutorials ist ihres (whatsnew,tutorial), niemals ausgefüllt.look: nullist das Looks-Blatt (§4). -
frame: worin das Produkt gezeigt wird, unabhängig vom Format;nullist das eigene jedes Formats (ein Browser für einen Walkthrough, ein Terminal für eine Befehlszeile, ein Mac-Fenster für ein Tutorial), meine Wahl.window: die App in ihrem macOS-Fenster (PARTS.window).macbook: ein MacBook von vorne, das App-Fenster oder der Browser der Website auf seinem Bildschirm (PARTS.laptop,PARTS.notchzuletzt gezeichnet).imac: ein iMac von vorne, auf seinem Ständer, das App-Fenster oder der Browser der Website auf seinem Desktop (PARTS.desktop: sein Rechteck ist der Körper, 547 : 375, und der Ständer wird darunter gezeichnet;colorist eine von Apples sieben Farben oder der Akzent der Marke für die nächste davon). Keine Kerbe: Die Kamera ist im weißen Rahmen.iphone,ipad: das Gerät (PARTS.phonemitPARTS.islandzuletzt gezeichnet;PARTS.tablet, liegend oder aufrecht durch sein Rechteck, die Kamera an seiner langen Kante), das eigene Layout des Produkts darauf (§1), und jeder Klick eine Berührung: eine weiche Scheibe, die drückt, mit der Welle des Looks, niemalsPARTS.ARROW; ein Tutorial sagt tippen.browser: das Produkt als Seite inPARTS.browser, seine echte Adresse im Feld.terminal:PARTS.terminal, getippt mitFILM.typed.bare(das Studio Nur die Benutzeroberfläche): die Benutzeroberfläche des Produkts für sich allein, ein schwebendes Panel mit abgerundeten Ecken und einem Schatten, kein Fenster-Chrom und kein Gerät darum. Das Produkt ist immer noch auf dem Bildschirm: ein Film ohne ist das Format Kinetischer Text, nicht dies.
Der Rahmen gilt für jede Szene, die das Produkt zeigt, in jedem Storyboard: ein Tutorial einer iPhone-App wird auf einem iPhone von seinem ersten Schritt bis zu seinem letzten erzählt. Ein Format, das selbst eine Oberfläche ist, beugt sich ihm: Browser-Walkthrough mit
iphoneist die Website im Telefon bei dieser Breite; Terminal mitmacbookoderimacist das Terminalfenster auf dem Mac-Desktop. Geräte in 3D ist das eine Format, das mehrere zeigt: das gewählte Gerät führt den Coverflow an (die erste Karte, die der Kamera zugewandt ist, und die, zu der es zurückkommt), und die anderen folgen ihm. Wo der Rahmen und ein fo…
-
… [für die Übersetzung gekürzt]