motion-graphics
Une vidéo est une page HTML dont chaque pixel est une fonction pure du temps t, rendue image par image dans Chromium sans tête et encodée avec ffmpeg. Le niveau d'exigence est celui du showreel d'un senior motion designer, jamais un diaporama.
1. Choisir le format
| Demande | Lire |
|---|---|
| Lancement, promo, pub, démo produit, bande-annonce d'application réelle | formats/launch-video.md |
| Shorts, Reels, TikTok, vidéo explicative verticale ou story | formats/shorts.md |
Suivez le fichier de format pour le brief, les étapes de contenu et la structure des séquences. Il renvoie ici pour la construction. Lisez aussi references/pitfalls.md avant d'écrire la composition.
Nouveau concept à chaque exécution. Chaque vidéo a sa propre idée, son script et son apparence. Lorsque l'utilisateur demande de ne pas regarder les travaux précédents, laissez les vidéos et compositions antérieures dans l'espace de travail non ouvertes.
2. Dossier de travail
Créez <slug>-<AAAAMMJJ>/ là où l'utilisateur le souhaite (par défaut : le répertoire courant) :
brief.md paramètres issus du tableau de brief du format
beats.md la feuille de séquences (temps, texte, asset, mouvement, transition, accent rythmique)
assets/ captures, images, polices, audio
assets/manifest.md une ligne par fichier asset : source, licence ou "capturé depuis <surface>", ce qu'il montre
motion.html la composition
motion.json {"size": [L, H], "fps": 60, "duration": 30, "stills": [temps des séquences], "captions": []}
engine/ copié depuis le dossier engine de cette compétence
out/ images fixes, rendus, planche contact
Configurez le moteur une fois par dossier :
cp -R <cette-compétence>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. Composer
motion.html charge engine/runtime.css et engine/runtime.js, construit son DOM, enregistre les scènes, puis appelle MG.ready().
| Aide | Utilisation |
|---|---|
MG.scene(début, fin, fn, el) | fn(local, t, dur) s'exécute tant que start <= t < end ; el est masqué ailleurs. Définissez chaque propriété animée à chaque appel. |
MG.always(fn) | S'exécute à chaque image : arrière-plans, grain, barres de progression. |
MG.prog(t, a, b, ease) | Progression 0..1 avec easing. Eases : MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) ou toute fonction. |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | Keyframes ; les valeurs peuvent être des tableaux. |
MG.spring(t, {stiffness, damping}) | Progression physique 0 → 1 avec dépassement. |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | Un seul appel par élément par image. |
MG.clip(videoEl, start, rate) | Joue un enregistrement d'écran avec précision image par image à partir de start. |
MG.rng(seed), MG.noise(x, seed) | Aléatoire déterministe et tremblement. |
MG.fmt(n, {decimals}) | Formatage de nombres pour les compteurs (localisé). |
MG.captions() | Dessine les sous-titres de motion.json au-dessus du bloc UI du bas. |
Déterminisme : pas de Date, performance.now(), requestAnimationFrame ou Math.random dans la logique de rendu. Les @keyframes CSS sont autorisés ; le moteur les met en pause à t, donc synchronisez-les avec animation-delay. Utilisez uniquement les polices et images listées dans le manifeste.
Prévisualiser une image : open "motion.html?w=1920&h=1080&t=3.2&guides=1" (les guides montrent les zones de sécurité). Temps réel : ?play=1. Les sous-titres n'apparaissent que dans les rendus.
4. Niveau d'exigence
- L'image 0 est déjà en mouvement. Pas de fondu depuis le noir, pas d'intro logo.
- Quelque chose de significatif change toutes les 0,8 à 2 s : mise en page, échelle, couleur, nombre ou caméra.
- Les entrées utilisent des ressorts ou des ease-out-expo avec un léger dépassement ; décalages de 30 à 60 ms ; linear uniquement pour les tickers.
- Flou de mouvement uniquement pendant les déplacements rapides ; léger zoom avant (échelle 1 → 1,04) sur les plans fixes ; parallaxe sur 2 à 3 couches de profondeur.
- Une famille d'arrière-plan, une couleur de texte, un accent. Ajoutez du grain ou du bruit de gradient pour éviter les bandes après compression.
- Le texte reste à l'écran assez longtemps pour être lu deux fois ; le texte clé reste dans les zones de sécurité.
- Les séquences tombent sur le son : un whoosh, un impact ou un temps musical à chaque changement.
5. Rendu
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
Validez d'abord la mise en page avec les images fixes : une par séquence, une à l'intérieur de chaque tween, une à chaque pic de dépassement du ressort. Lancez un rendu complet à la fois (environ 10 minutes pour 25 s à 1080p60 avec 4 workers).
6. Audio
Utilisez uniquement la musique et les SFX listés dans le manifeste avec une licence autorisant l'utilisation, ou les fichiers fournis par l'utilisateur. Sans eux, livrez sans son et mentionnez-le. Mélangez les pistes, puis muxez :
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):"
Visez environ −14 LUFS intégré et un pic vrai à ou en dessous de −1 dBFS. Les SFX se situent entre −6 et −14 dB, la musique entre −14 et −18 dB. La musique sous le texte à l'écran est instrumentale.
7. QA
- La durée, la taille et le fps de
ffprobecorrespondent au brief. - Planche contact :
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. Consultez-la et une image en pleine taille à chaque changement de séquence (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png). - Chaque image : rien de coupé sur les bords, pas d'image vide ou à moitié fondue, pas de guides oubliés, pas de fautes ou de texte factice, rien de statique plus de 2 secondes.
- Les vérifications propres au fichier de format.
Corrigez et refaites le rendu jusqu'à ce que toutes les vérifications passent. Ajoutez toute nouvelle leçon à references/pitfalls.md dans la compétence sous la forme date · vidéo · leçon.
Livraison
Rapportez le chemin du MP4 final, sa durée, sa taille et son fps, ce qu'il montre, le statut audio avec les crédits nécessaires, et les commandes de re-rendu. Conservez le dossier de travail. Téléchargez ou publiez uniquement sur demande de l'utilisateur.