Atelier d'Animation par Code (Code Animation)
Transformez un concept abstrait en un court métrage d'animation de 1 à 2 minutes. Ce n'est pas une vidéo générative – chaque image est une image vectorielle calculée dans le navigateur, reproductible image par image et modifiable localement.
Le résultat est un fichier MP4, accompagné d'un storyboard.json réutilisable.
Processus en trois étapes
# 1. Valider le storyboard
python scripts/lint.py storyboard.json
# 2. Construire + Rendre (environ 0,5 seconde/image)
python scripts/build.py storyboard.json out.html
python scripts/render.py --html out.html --duration 117 --fps 30 --out film.mp4
# 3. Contrôle qualité, échoue avec un code d'erreur si les seuils ne sont pas atteints
python scripts/measure.py film.mp4 --thresholds reference/thresholds.json
Si le contrôle qualité échoue, corrigez. Ne validez pas « parce que ça a l'air bien ».
Ajouter de la musique (optionnel, mais fortement recommandé)
La musique est également calculée, sans échantillon de bibliothèque – le même principe que pour l'image.
# 1. Synthétiser la musique (numpy, environ 40 secondes)
python scripts/make_audio.py score.wav --storyboard storyboard.json
# 2. Intégrer dans la vidéo, compresser au passage en H.264
python scripts/mux.py --video film.mp4 --audio score.wav --out final.mp4 --crf 23
La musique par défaut est une base spatiale/physique : nappes longues en ré mineur + accords changeant à chaque plan + impulsion cardiaque toutes les 8 secondes + quelques pincements épars, avec un balayage de bruit aux transitions et des impacts graves aux sections.
Pour un thème différent, adaptez les paramètres de la musique, ne réutilisez pas tels quels :
| Thème | Modification de la musique |
|---|---|
| Physique / Astronomie | Conserver les valeurs par défaut : mineur, notes longues, épars |
| Mathématiques / Algorithmes | Passer en majeur ou mode lydien, ajouter quelques arpèges réguliers |
| Histoire / Sciences humaines | Supprimer les impulsions, ralentir les nappes, ajouter quelques intervalles dissonants |
| Produit / Technique | Supprimer les nappes longues, remplacer par une pulsation synthé à 90–110 BPM |
Les paramètres se trouvent dans les trois constantes SCALE / ROOT / bpm en haut de make_audio.py, et dans le tableau chords de build().
storyboard.json
{
"title": "Gravité",
"fps": 30,
"palette": { "bg": "#08090F", "ink": "#E6DCCB", "dim": "#8A8177", "accent": "#E0813C" },
"scenes": [
{
"id": "open",
"kind": "title",
"dur": 6.0,
"cn": "引力",
"en": "GRAVITY"
},
{
"id": "newton",
"kind": "orbit",
"dur": 16.0,
"chapter": ["I", "苹果与月亮", "THE APPLE AND THE MOON"],
"subs": [
[0.6, "1687 年,牛顿用一个公式,把苹果和月亮绑在了一起。"],
[7.4, "引力与质量成正比,与距离的平方成反比。"]
]
}
]
}
| Champ | Description |
|---|---|
kind | Nom du modèle de plan, voir tableau ci-dessous |
dur | Durée du plan (secondes), recommandé 12–20 |
chapter | [numéro, chinois, ENGLISH], affiché en haut à gauche |
subs | Tableau [seconde de début, texte] ; prévoir 5–6 secondes par écran |
cn / en | Utilisé pour les plans de titre |
Modèles de plans (8)
| kind | Image | Utilisation |
|---|---|---|
title | Grand titre + sous-titre en anglais | Ouverture |
outro | Deux lignes de conclusion | Générique de fin |
orbit | Orbite elliptique + grille polaire | Mouvement périodique, gravité |
precess | Fleur de précession + rapporteur d'angle | Déviation mineure, précession |
elevator | Boîte + échelle interne | Référentiel, principe d'équivalence |
warp | Grille d'espace-temps en perspective + lignes de champ | Courbure, champ |
evidence | Anneaux concentriques de lentille + onde chirp | Preuve, signal |
blackhole | Disque d'accrétion + anneau de photons + échelle annulaire | Objet céleste extrême |
Les paramètres des modèles se trouvent dans templates/shots/*.json.
Architecture à six couches (pourquoi cet ordre)
L5 Post-traitement bloom → vignettage → grain
L4 Texte Titre de section / grand titre / formule / sous-titres
L3 Annotations Lignes de champ + petites étiquettes + boîtes de lecture
L2 Sujet Graphique principal du plan
L1 Structure Grille / échelle / axes de coordonnées
L0 Arrière-plan Nébuleuse / points / poussière / étoiles lointaines
Ce sont les couches L1 et L3 qui donnent l'impression de « professionnalisme », pas L2. Une image avec seulement le sujet semble sommaire ; en ajoutant la structure et les annotations, la même image devient immédiatement une « interface d'instrument ».
base.html implémente déjà les six couches ; pour un nouveau plan, il suffit d'écrire la fonction de dessin de L2.
Seuils de validation
reference/thresholds.json :
{
"frame_diff_min": 1.5,
"moving_ratio_min": 0.70,
"coverage_min": 0.20,
"luma_range": [16, 30]
}
| Indicateur | Signification | Pourquoi |
|---|---|---|
frame_diff | Différence moyenne entre images consécutives | En dessous de 1,5, c'est un « diaporama », pas une animation |
moving_ratio | Proportion d'images avec mouvement | En dessous de 70 %, sensation de « blocage » |
coverage | Proportion de pixels avec structure locale | En dessous de 20 %, l'image semble vide |
luma | Luminance moyenne | En dessous de 16, toute la structure se noie dans le noir ; au-dessus de 30, on perd le fond sombre |
Ces seuils ont été calibrés sur des séquences de référence réelles. Ne les modifiez pas à la légère. Voir reference/findings.md.
Pièges connus (tirés de l'expérience)
1. N'utilisez jamais ctx.shadowBlur.
Avec des dizaines d'ombres calculées image par image en rendu logiciel, le temps par image passe de 20 ms à 5 secondes. Utilisez bloom() dans base.html – réduisez le canvas à 1/6, puis agrandissez et superposez, deux drawImage, presque gratuit.
2. Les paramètres doivent provenir de la même source.
Il y a déjà eu un bug où « la particule sortait de la ligne » : la ligne était calculée avec p², la particule avec p. Le chemin d'un même élément et sa tête doivent être pilotés par la même variable.
3. Le grain détermine la taille du fichier.
Le bruit aléatoire image par image a une entropie très élevée, que le codec vidéo ne peut pas compresser. Avec un α=0,03 pour le grain, une image 1080p30 fait environ 50 Ko – un film de deux minutes fait environ 300 Mo. Pour réduire, diminuez α (environ 0,015) ou la fréquence d'images, n'attendez pas miraculeusement du codec.
4. Utilisez le format JPEG pour les images, pas PNG.
L'encodage PNG avec grain est plus de 4 fois plus lent que JPEG (mesuré : 2,0 s/image contre 0,5 s/image).
5. La luminosité n'est pas un filtre.
N'utilisez pas CSS brightness() pour éclaircir – cela blanchirait aussi le texte. Pour éclaircir, augmentez l'alpha des couches de contenu (grille, nébuleuse, poussière), en respectant les proportions de reference/palette.json.
Étendre avec un nouveau plan
- Ajoutez un
casedansdrawScene()debase.html - Écrivez uniquement L2 (le sujet) ; utilisez
polarGrid/ringTicks/axisTicks/drawInstrumentpour L1, etdrawLeaderpour L3 - Extrayez les paramètres ajustables dans un objet, et stockez-le dans
templates/shots/<name>.json - Lancez
measure.py– le plan n'est considéré comme terminé que si les trois indicateurs sont atteints
Exemple
examples/gravity.storyboard.json – Le storyboard complet pour un film de deux minutes intitulé « Gravité », avec les huit plans utilisables. Il peut servir de point de départ en modifiant simplement le texte.