Film promotionnel produit, rendu en code
Une page, un canvas, et seek(t) dessine l'image au temps t à partir de zéro. Headless Chrome capture N sous-images par image, ffmpeg les mélange et les encode. Le film est une fonction ; la vidéo en est un échantillonnage — c'est ce qui rend chaque image révisable, chaque modification peu coûteuse, et la boucle exacte.
Ces fichiers sont livrés avec ce skill. Copiez-les dans le dossier de travail du film ; ne réécrivez pas le moteur.
| Fichier | Ce que c'est |
|---|---|
template/promo.html | Le moteur plus une démo de 8 secondes : ressorts en forme fermée, pistes de somme de ressorts, une caméra, des assistants de texte (chiffres tabulaires, retournements), des titres, un curseur réel, une chaîne de morphose à un objet, et un compositeur WebGL pour la 3D réelle. S'ouvre et se rend tel quel. |
template/reel.html | Un long film sur une timeline : six scènes, six formats (typo cinétique, un navigateur, une grille bento avec un changement de mise au point, un terminal, un cover-flow 3D d'appareils, une carte de fin), cinq transitions, un look par scène, des chapitres. ~56 s, pas une boucle. Le catalogue du §2, en cours. |
template/film.js | Le moteur partagé par les pages : la scène (jitter subpixel par sous-image, pour que rien ne saute ou ne scintille dans les mouvements lents), FILM.draw pour les rasters, les ressorts et les caméras, la timeline (scènes, chapitres, points de contrôle, et vingt-quatre transitions : seize sur le canvas 2D, huit comme shaders de fragment sur un contexte WebGL2) et les effets (profondeur de champ, texte découpé, frappe). Documenté en haut. |
template/parts.js | Pièces vectorielles : une fenêtre macOS, un navigateur, un terminal, un iPhone, un iPad, un MacBook, un iMac, des touches de clavier, un interrupteur, une bague, un bouton, le pointeur. Chacune renvoie le rect où son contenu va. |
template/parts.html | Chaque pièce sur une feuille 16:10, une page comme les autres : PAGE=parts.html node render.mjs stills parts 0 crée le PNG à partir duquel docs/parts.jpg est converti (sips -s format jpeg -s formatOptions 92). |
template/fx.js | Le look, chargé par la page : un arrière-plan (plat, dégradé, champ ou image ; lumière douce de marque ; points, grille ou lignes en parallaxe ; un sol en perspective ; un spot), une finition (vignette, grain) et les effets qui s'appuient dessus (verre dépoli, ondulations de clic, titres à mise au point variable). Vingt-trois préréglages et photo, chaque champ remplaçable, documenté en haut du fichier. Partagé avec release-film. |
template/type.js | Titres et typo cinétique (§3) : TYPE.draw(ctx, t, spec) en treize styles — rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode — avec une marque d'accentuation, un rythme, et TYPE.load pour les graisses d'une famille. Une fonction pure de t, comme le reste. |
template/fonts/ | Vingt familles sous licence ouverte (latin + latin-ext woff2, chacune avec son OFL.txt) et fonts.json, leurs graisses. Un film ne copie que ce qu'il utilise dans src/fonts/ ; scripts/fonts.mjs add en récupère une autre. |
scripts/render.mjs | stills <dir> t…, sheet <dir> (les points de contrôle de la timeline), looks <dir> <t>, loopcheck, video <out> [workers]. Lit la taille, les fps, la durée et les chapitres depuis la page ; jitter chaque sous-image ; rend en morceaux reprenables ; FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER= ; l'extension choisit le format (.mp4, .mov ProRes, .webm, .gif ; HEVC=1 ; ALPHA=1 pour un .mov ou .webm transparent) ; vérifie la piste avant le rendu et le fichier après ; échoue sur une capture dont la page a perdu un contexte WebGL, et un second rendu d'une coupe pendant qu'un tourne. Documenté en haut. |
scripts/narrate.mjs | L'histoire d'un film (story.json : une phrase par étape, d'un tutoriel ou d'une promo qui parle) en une voix, une horloge et des sous-titres : voice/*.aiff, narration.wav (l'AUDIO du film), narration.js (le temps de chaque étape, pour la page) et captions.srt / .vtt. Le say du Mac, ou --from un dossier de vos propres enregistrements. "human": "natural" varie les pauses comme une personne ; les sons d'un modèle ([chuckle]) sont gardés hors des sous-titres. Documenté en haut. |
scripts/voice.mjs | La même histoire racontée par un modèle vocal qui tourne sur le Mac ("mlx" dans story.json : Chatterbox pour une leçon, Orpheus pour une promo, Kokoro pour un brouillon rapide ou un film en italien), plus proche d'une personne que say : il dit chaque étape (voice-mlx.py, via mlx-audio), la rythme et la nivele, puis appelle narrate.mjs. Une prise est une graine ; "tone" (calm, warm, bright) est la liberté avec laquelle le modèle lit, "human" varie le rythme de chaque ligne dans 3 % et laisse une ligne faire un son ([chuckle], [sigh] : l'orthographe de chaque modèle, ou omis). --audition compare les prises, --recordings s'arrête aux enregistrements, --setup fait le Python et récupère les modèles une fois sur chaque Mac (voice-constraints.txt épingle ce qu'il installe) et dit si ce Mac répète les prises enregistrées ici. Documenté en haut. |
scripts/mix.mjs | Une voix et une piste musicale en une bande son, pour AUDIO= : les deux mesurées (EBU R128), la musique --under LU sous la voix pendant qu'elle parle, --lift dB entre les lignes, descend avant chaque début de ligne ; imprime ce qui est sorti, mesuré sur le résultat. Documenté en haut. |
scripts/contact.mjs | Une planche contact sous-titrée d'un dossier de stills ou de looks (sous-titres depuis labels.json dedans) ; --size LxH la rend exactement à cette taille (--font, --gap, --pad ; les stills jamais recadrés ; un .jpg est écrit en JPEG) ; --dark pour une planche sombre. --compare A=<dir> B=<dir> [C=<dir>] <out.png> : deux ou trois dossiers côte à côte, une colonne étiquetée chacun et une ligne par still qu'ils partagent, pour un choix A/B sur une image. |
scripts/beats.mjs | Le beat d'une bande son, depuis ses échantillons : le tempo, s'il tient, chaque beat, les mesures, les sections, et le bpm et AUDIO_AT pour donner à la page ; --out beats.js pour une page qui suit une piste qui dérive (FILM.beats). render.mjs l'importe pour mesurer les beats de la page contre ceux de la piste. --selftest. |
scripts/clickcheck.mjs | Chaque clic est-il vu : pour chacun des CLICKS de la page, à quelle vitesse le point cliqué se déplace à l'écran et quelle distance le curseur parcourt avant la pression et pendant. Quitte avec 1 sur un clic que personne ne verra (release-film §3b), 2 sur une page sans curseur. |
scripts/layoutcheck.mjs | Chaque titre est-il dans le cadre, séparé et lisible : à chaque point de contrôle, chaque titre que TYPE.draw dessine, par rapport à la zone de sécurité, les autres titres et l'arrière-plan autour (les limites sont dans son en-tête). Quitte avec 1 sur un titre qui échoue, 2 sur une page qui n'en dessine aucun via TYPE.draw. |
scripts/deliver.mjs | La dernière étape (§8) : les vidéos finies et leurs couvertures quittent le dossier de travail pour un dossier qui leur est propre ; une fois le film sorti, trash jette le dossier de travail après avoir vérifié que sa source est en sécurité dans le kit. --selftest. |
scripts/fonts.mjs | Les polices du kit : add "<Famille>" [axes] depuis Google Fonts avec sa licence, check, list. |
À côté d'eux, studio/ (le Studio, ci-dessous), guide.md (le mode guidé, ci-dessous) et README.md (le catalogue en images, et des exemples de demandes pour chaque moment d'un film).
Configuration : un dossier de travail, ~/Downloads/<nom>-travail/ (~/Downloads est la racine de travail sauf si workRoot dans le fichier de paramètres, ci-dessous, dit autrement), avec la page et ces fichiers dans son src/,
et npm i playwright-core là-bas. Il pilote Chrome installé via channel: 'chrome', donc rien d'autre n'est téléchargé. <nom> est <produit>-<quoi> (acme-promo,
acme-2.4-quoi-de-neuf), et il nomme aussi le dossier de livraison et chaque fichier livré (§8).
Studio : le brief dans une fenêtre
La voie visuelle. Un assistant dans sa propre fenêtre : recettes, formats, looks, images
provenant du Mac, type et mouvement montrés en mouvement sur le vrai moteur, dans la couleur et le format du produit,
le son (les pistes de la bibliothèque musicale jouées, la voix d'un modèle vocal entendue disant une ligne avant d'être
choisie), et chaque choix écrit dans un brief.json. Rien n'est installé et rien n'est rendu.
/manovella:studio l'ouvre aussi.
- Quand : invoqué avec
studio, ou avec rien du tout alors que rien dans la conversation ne dit quel film faire. Un utilisateur qui a dit ce qu'il veut en mots va directement au §0. - Exécutez
node <dossier de ce skill>/studio/studio.mjsdepuis l'espace de travail, en arrière-plan (ses dépôts frères sont les produits proposés), et dites en une ligne que la fenêtre est ouverte. Il se ferme tout seul, imprimant une ligne, et la sortie vous réveille :BRIEF <chemin>, ouCANCELLED,CLOSED,TIMEOUT(dites-le et arrêtez). La fenêtre est la propre app du Studio là où ce Mac l'a construite (~/Applications/Manovella.app, son nom, sa version et son icône dans le Dock), sinon une fenêtre d'app Chrome ;MANOVELLA_WINDOW=chromegarde Chrome. Sans aucun des deux, il ouvre le navigateur par défaut ;--no-openimprime l'URL à la place, pour une session dont l'écran est ailleurs. - La bibliothèque musicale est facultative : un dossier avec la musique des films de l'utilisateur, conservé où
ils le souhaitent (un disque synchronisé, un dossier de projet). Elle est là où
MANOVELLA_MUSICpointe pour une exécution, sinonmusicLibrarydans~/Library/Application Support/manovella/settings.json(~/.config/manovella/settings.jsonhors macOS ; un~au début est développé) ;musicLibraryIgnoredans le même fichier liste les noms de dossiers à ignorer, etdeliverToLibrary(true ou false, par défaut false) dit si les films finis y vont aussi. Rien n'est auto-détecté. Un fichier plus ancien avecbrandLibraryetbrandLibraryIgnoreest lu commemusicLibraryetmusicLibraryIgnoreavecdeliverToLibraryactivé, ce qu'il faisait avant, et est réécrit avec les nouvelles clés au premier changement effectué dans les Paramètres du Studio. Le même fichier prendprojectFolders(où le Studio cherche les produits),pictureFolders(ses images d'arrière-plan ; non défini :~/Pictures) etworkRoot(où<nom>-travailet, à moins que le film ne soit livré dans la bibliothèque ou le projet n'ait une instruction,<nom>/vont ; non défini :~/Downloads) ; la fenêtre Paramètres du Studio (l'engrenage à côté du logo, ou ⌘, dansManovella.app) les écrit tous, etdeliver.mjslitworkRootaussi. Rien d'autre dans le code ne lit les clés de bibliothèque : pour un film fait sans le Studio, ce paragraphe est l'instruction pour moi.- Le Studio offre chaque fichier audio (mp3, m4a, aac, wav, aiff, flac, ogg) au niveau supérieur de la bibliothèque
et dans chaque dossier qu'elle contient, directement ou dans le dossier
audio/de ce dossier ; les dossiers-points et les noms dansmusicLibraryIgnoresont ignorés. Un dossier par marque est facultatif et groupe ses pistes ; le dossier nommé d'après le produit est listé en premier (« celui de ce produit »). Un fichier de notes facultatif à côté des pistes (…notes.txtou.md: un paragraphe par piste, commençant par le nom du fichier de la piste : ce que c'est, son ambiance, où ça s'insère) dit à quoi chaque piste sert, et le Studio l'affiche. - Films finis : avec
deliverToLibraryactivé et une bibliothèque définie,<bibliothèque>/<Marque>/video/<nom>/(§8) ; sinon là où les instructions du projet lui-même conservent les médias finis, sinon<nom>/dans la racine de travail (~/Downloads/<nom>/par défaut). - Une nouvelle piste qui a été créée (ci-dessous) est sauvegardée dans la bibliothèque, dans le dossier du produit lorsque
la bibliothèque en garde une par marque, avec son paragraphe dans le fichier de notes de ce dossier, quand une bibliothèque
existe ; sinon elle va juste dans le
src/audio/du film. Un dossier dans un fournisseur de fichiers (Google Drive, iCloud Drive, Dropbox) peut contenir ses fichiers « sans données » jusqu'à ce qu'ils soient ouverts, donc ouvrez ou copiez un fichier avant de le mesurer. Les fichiers qu'une bibliothèque conserve sont copiés, jamais déplacés hors d'elle.
- Le Studio offre chaque fichier audio (mp3, m4a, aac, wav, aiff, flac, ogg) au niveau supérieur de la bibliothèque
et dans chaque dossier qu'elle contient, directement ou dans le dossier
brief <chemin>, comme argument ou depuis une ligneBRIEF: lisez le brief ; il répond au §0.-
formats: []est mon choix de trois. Pour une promo ou un film en chapitres, un, deux ou trois nommés sont les formats des storyboards, dans cet ordre, et je choisis les autres, chacun différent ; celui d'une release et d'un tutoriel est leur seul format (whatsnew,tutorial), jamais rempli.look: nullest la feuille de looks (§4). -
frame: dans quoi le produit est montré, quel que soit le format ;nullest le format propre de chacun (un navigateur pour une visite guidée, un terminal pour une ligne de commande, une fenêtre Mac pour un tutoriel), mon choix.window: l'app dans sa fenêtre macOS (PARTS.window).macbook: un MacBook de face, la fenêtre de l'app ou le navigateur du site sur son écran (PARTS.laptop,PARTS.notchdessiné en dernier).imac: un iMac de face, sur son socle, la fenêtre de l'app ou le navigateur du site sur son bureau (PARTS.desktop: son rect est le corps, 547 : 375, et le socle est dessiné dessous ;colorest l'un des sept d'Apple, ou l'accent de la marque pour le plus proche). Pas d'encoche : la caméra est dans la lunette blanche.iphone,ipad: l'appareil (PARTS.phoneavecPARTS.islanddessiné en dernier ;PARTS.tablet, couché ou debout selon son rect, la caméra sur son bord long), la mise en page propre du produit sur l'appareil (§1), et chaque clic est un toucher : un disque doux qui appuie, avec l'ondulation du look, jamaisPARTS.ARROW; un tutoriel dit tap.browser: le produit comme page dansPARTS.browser, sa véritable adresse dans le champ.terminal:PARTS.terminal, tapé avecFILM.typed.bare(le Juste l'interface du Studio) : l'interface du produit seule, un panneau flottant avec des coins arrondis et une ombre, pas de chrome de fenêtre et pas d'appareil autour. Le produit est toujours à l'écran : un film sans rien est le format Typo cinétique, pas celui-ci.
Le cadre tient pour chaque scène qui montre le produit, dans chaque storyboard : un tutoriel d'une app iPhone est raconté sur un iPhone de sa première à sa dernière étape. Un format qui est lui-même une surface s'y plie : Visite guidée navigateur avec
iphoneest le site dans le téléphone à cette largeur ; Terminal avecmacbookouimacest la fenêtre du terminal sur le bureau du Mac. Appareils en 3D est le seul format qui en montre plusieurs : l'appareil choisi mène le cover-flow (la première carte à faire face à la caméra, et celle à laquelle elle revient), et les autres la suivent. Là où le cadre et un format
-
…
[Le contenu a été tronqué pour la traduction]