Construction de film
Démarrage
sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film> # refuse un dossier non vide
cd marketing/videos/<film> && npm i && npx playwright install chromium # si cela indique NEXT
Le kit vous fournit :
| Fichier | Description |
|---|---|
film/core.js | le moteur : scene({name, from, to, build, run, after}) (temps en beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start() |
film/film.js | un starter avec tous les helpers ci-dessous et quatre exemples de plans (line, prompt, split, fiche personnage). Le commentaire de chaque helper indique de quel rejet il provient. Remplacez les plans, conservez les helpers. |
film/mock.js | window.MOCK : HTML pour des éléments d'interface réelle (tableaux de bord, fenêtres, écrans de téléphone), en pixels écran |
film/index.html | charge les polices depuis assets/fonts/{display,ui}.woff2 (avec des polices de secours locales sans empattement) |
scripts/render.mjs | --sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all |
scripts/sync.mjs | copie timeline.json dans la page |
scripts/review.py | kit de critique à partir du MP4 rendu : planche contact, bandes d'action la plus rapide, vue téléphone, zones de sécurité 9:16, métriques |
tools/probe.mjs | cuts (chaque coupe et le point médian de chaque plan, en secondes vidéo) ou toute expression, par ex. "window.UNWARP(12.4)" |
tools/sheet.py | organise les images fixes en une seule planche étiquetée |
tools/pack_grid.py | découpe une planche de personnage 4×3 (transparent ou sur fond blanc) en une bande de 12 cellules pour sprite() ; imprime la taille des cellules |
tools/cut_cast.py | découpe un alignement d'une rangée en personnages fixes individuels |
assets/characters/ | quatre exemples de personnages (fondateur, développeur, vendeur, étudiant), bandes de 12 images avec cellules de 360 px |
tools/same.sh | save / check régression PSNR entre les images fixes avant et après |
Helpers dans le starter (utilisez-les, ne réinventez pas)
io(quintique entrée-sortie) pour les mouvements de caméra et les morphing ;oq(quintique sortie) pour les entrées ;backpour un petit dépassement.cam(e, s, fx, fy)place le point de focalisation (fx, fy) d'un plan 1920×1080 au centre du cadre à l'échelle s.camDfait la même chose mais ne montre jamais au-delà des bords du plan (échelle de couverture ; essentiel en 9:16).posIn(e, root)lit la position d'un élément à l'intérieur du plan en mouvement (pour les cibles du curseur, le suivi du caret).typed()pour les mots apparaissant lettre par lettre dans une ligne ;keyed()pour un vrai clavier : temporisation irrégulière par caractère, pauses plus longues sur les espaces, caret clignotant après.wordsHTML()dispose chaque mot à sa largeur finale dès la première image, transparent jusqu'à son heure, afin que la ligne ne se reflue jamais ("la transition de texte n'est pas du tout fluide").cursor()/putCursor()/bump(): un vrai curseur flèche qui glisse, arrive en avance, plonge de 15 % lors d'un clic.pop()pour les petits éléments qui atterrissent.sprite(parent, src, cellW, cellH, h)/putSprite(e, t, a, z, loops)pour un personnage dessiné : parcourt ses 12 images de a à z, avec une petite respiration pour qu'il ne reste jamais immobile. C'est un<img>, donc le moteur l'attend.shot(name, t0, t1, build, run)encapsulesceneen secondes.- Warp de rythme en bas :
SLOW(étirement global),EVarrêts (figer un instant pour la lecture) et insertions ;window.CUTSetwindow.UNWARPdonnent les temps vidéo pour le placement du son et de la voix. PT/pk(a16, a9)choisir des valeurs par format dans un seul fichier.
Règles du moteur (déterminisme)
Le film est une fonction pure de t. Chaque image doit s'afficher de la même manière qu'elle soit rendue en premier ou après toute autre image.
- Transformations 2D uniquement : pas de
translate3d, pas dewill-change, pas de transitions CSS, pas deMath.random(utilisez un hash d'un index). - Éléments cachés au démarrage :
reg(el, {o: 0}), jamaisopacity:0en ligne. - Mesurez la mise en page dans
after()ou une fois dansbuild, jamais dansrun(cela lit l'image précédente). - Vues 3D : réinsérez chaque image avec
insertBefore(v, firstChild)afin qu'aucun raster mis en cache ne persiste. - Animations CSS intégrées (par ex. le propre widget d'un produit) : mettez-les en pause et définissez
animation-delay: calc(-1s * var(--t)). - Attendez les images et les polices (
decode(),document.fonts.ready) avant la première image. - Limitez le CSS du produit sous une classe racine unique ; utilisez des noms de classe uniques dans le film (
.wa déjà fuité une fois). classList.add, jamaisclassName =.node scripts/render.mjs --verifydoit afficher 12/12 avant tout rendu que vous envoyez.
Réalisme : lisez references/realism.md avant de construire un écran
Version courte : vraies applications à densité réelle, vrais logos provenant des sites des marques, chrome OS avec des applications qui existent sur ce système d'exploitation, vrais fonds d'écran, téléphones sur la grille du lanceur réel aux tailles dp réelles dessinées par le moteur de rendu du produit lui-même, UI produit plus riche que vous ne le pensez, une ligne d'utilisation nominative chaque fois qu'une marque apparaît.
Boucle de construction (pilotée par la révision)
- Liste des plans à partir du storyboard approuvé dans
film.js, unshot()chacun, se chevauchant pour les transitions. - D'abord les images fixes.
node tools/probe.mjs cuts→ effectuez le rendu d'une image fixe au point médian de chaque plan et à chaque transition :node scripts/render.mjs --at …puispython3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. Lisez la planche vous-même. Corrigez. Répétez. (Environ 1 à 2 minutes par cycle, contre 25+ pour un rendu complet.) - Passage assurance qualité AVANT tout envoi pour révision : parcourez le film à ≤ 1,5 s et à chaque transition (planche contact à 10–15 ips sur chaque transition). Vérifiez
references/qa.mdligne par ligne : chevauchements, rognage, images vides, temps de lecture, fluidité du texte, saisie, avis de logo, réalisme du système d'exploitation, tailles de téléphone. - Envoyez les images fixes (la planche) au propriétaire pour le premier coup d'œil. Attendez.
- Brouillon :
node scripts/render.mjs --draft(30 ips, ~4 min),python3 scripts/review.py 1 --draft, lisez les bandes. Envoyez le MP4 du brouillon. Dites clairement qu'il s'agit d'un brouillon à 30 ips sans flou (ça donne un aspect plus saccadé que la version finale). - Pour le rendu final :
node scripts/render.mjsen arrière-plan (60 ips, flou de mouvement ; ~25–35 min pour 60 s). Ne modifiez jamaisfilm.jspendant le rendu : copiez d'abord le projet si vous devez continuer à travailler. - Validez le code du film et la chronologie après chaque cycle approuvé.
Rythme
Les premiers montages sont presque toujours trop rapides. Le texte à l'écran nécessite environ 0,3 s par mot + 1 s à pleine opacité (jamais moins de 1,5 s). Privilégiez le warp (SLOW 1,1–1,25, arrêts EV sur les lignes) plutôt que de retemporiser chaque plan. Après tout changement de rythme, relancez probe.mjs cuts car les positions du son et de la voix bougent.
9:16 : lisez references/formats.md
Recadrez le même film dans un seul fichier avec pk() ; prouvez que le 16:9 n'est pas modifié avec tools/same.sh (chaque image fixe PSNR = inf) ;
--verify --fmt 9x16 ; planche d'images fixes pour le propriétaire ; puis --fmt 9x16 final en arrière-plan, puis --mux --fmt 9x16.