Animateur Stickman
Vous écrivez scenes.js - une film.scene(id, sc => { … }) par clip dans film.json, mêmes ids, même ordre. Tout est du JavaScript navigateur standard utilisant le moteur global SM. Lisez references/api.md (antisèche complète) et references/cookbook.md (recettes copier-coller) avant d'écrire.
Modèle mental
- Temps local. Dans une scène, chaque temps est en secondes depuis le début du clip.
sc.dur= la durée du clip. - Chaînable. Chaque action retourne le moment où elle se termine :
const t = bob.walkTo(900, 0.2); bob.wave(t); - Synchronisé à la voix.
sc.cue("mot")= estimation du temps local où le narrateur dit ce mot (sc.cue(["mot", 1])= 2ème occurrence,sc.cue(0.5)= à mi-parcours de la VO). Placez le visuel sur ou juste avant le mot (sc.cue("idée") - 0.15). - Calques.
world(environnement) →back(accessoires) → figures →front(accessoires devant les figures) →ui(espace écran, ignore la caméra) →top(transitions). Passez{ layer: "front" }/"ui"aux accessoires. - Coordonnées. Le canvas est
sc.W × sc.H(1920×1080, 1080×1920 ou 1080×1080).sc.groundYest le sol (80 % en bas en paysage, 74 % en portrait). Les figures se tiennent sury= leurs pieds. - Objets. Les accessoires, textes, graphiques, formes sont des
Thing:.pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show. - Caché-jusqu'à-l'entrée. Créez avec
{ hidden: true }puis.pop(t); le texte est caché jusqu'à.in(t, fx).
Squelette de scène
const film = SM.film(); // le thème/format viennent de film.json
film.scene("accroche", sc => {
sc.enter("fondu"); // optionnel, correspond à la sortie précédente
sc.ground(); // ligne de sol (style : "grass" | "none")
const bob = sc.figure({ x: -150, visage: "points" }); // ou sc.character("zeke", {...})
const t1 = bob.walkTo(sc.W * 0.35, 0.2);
bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("ceci"));
const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", valeur: 4 }, { label: "2025", valeur: 9 }] });
chart.grow(sc.cue("a augmenté"));
sc.text("Revenu [doublé]", { x: sc.W * 0.68, y: 150, taille: 80 }).in(sc.cue("doublé") - 0.1, "mots");
sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3); // lent zoom avant
sc.exit("essuyer-gauche");
});
Intros & Outros
Les clips qui déclarent "intro" / "outro" dans film.json se construisent eux-mêmes. Vous n'avez pas besoin d'une scène pour eux. Pour ajouter des suppléments (accessoires jaillissant autour du titre, une figure qui salue le CTA), écrivez la scène et appelez le preset vous-même ; la version automatique est alors ignorée :
film.scene("intro", sc => {
const t = sc.intro("countdown", sc.clip.intro); // retourne quand le titre s'est posé
sc.prop("fusée", { x: 1500, y: 300, taille: 120, calque: "ui", cache: true }).pop(t - 0.8);
sc.exit("essuyer-gauche");
});
film.scene("outro", sc => {
sc.enter("fondu", { couleur: "bg" });
sc.outro("kino", sc.clip.outro);
sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});
Règles de mise en scène (ce qui rend le rendu beau)
- Quelque chose change toutes les 2-3 s. Planifiez 3 temps forts par clip ; comblez les trous avec une poussée de caméra, un clignement/hochement de tête, un balancement d'accessoire, une mise en évidence.
- Mettez en scène avant d'animer. Décidez où vivent la figure, l'accessoire principal et le texte (tiers en 16:9 ; empilés en 9:16). Gardez le texte loin de la tête de la figure et des autres textes.
- Les figures agissent, ne restent pas immobiles. Utilisez des gestes qui ont du sens :
pointvers ce qui est discuté,thinkavant une idée,surpriselors d'une révélation,shrugpour un mythe,celebratepour une victoire,push/climb/runTopour un effort. - Une entrée focale à la fois ; espacez de 0.1-0.2 s lorsque plusieurs choses apparaissent.
- Faites correspondre les sorties et les entrées entre les clips (même type de transition) ou cut dans le mouvement (même pose/position d'objet).
- Les accents portent du sens :
"a1"problème,"a2"solution,"a3"récompense. Passez des noms de couleurs :"a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper"ou hexadécimal. - Vérité du sol : les figures se tiennent sur
sc.groundY(ou une surface que vous avez calculée) ; les accessoires qui reposent sur le sol utilisenty = sc.groundY - taille*0.4. - Portrait : figure
taille: 420-460, accessoires 200-300, texte 70-120, gardez la bande centrale occupée et les légendes basses.
Vérifier (boucle obligatoire)
stickman check <répertoire>→ doit afficher Check passed.page_error= votre JS a levé une erreur ; corrigez-la.stickman snapshot <répertoire>(ou--ataux moments clés) → ouvrezsnapshots/contact-sheet*.jpget les PNG et regardez. Corrigez : coupures, chevauchements, figures flottantes, moments vides, textes illisibles, bras traversant les têtes (ajustez les surcharges de pose), mauvaises couleurs d'accent.- Réexécutez jusqu'à ce que ce soit propre, puis rendez.
Pièges
- Planifiez chaque figure chronologiquement.
celebrate()planifie un retour àstandà +1.0 s ; passez{ hold: true }si vous le poserez à nouveau peu après. bob.hold(accessoire)attache à la main droite et reste droit ; créez avant utilisation et.pop(t).- Balisage de texte :
"[mots accentués]"colore une phrase avec l'optionaccent(par défauta2). - Les graphiques comptent les nombres avec des pas discrets ; donnez
prefix/suffix/decimalsdans les options du graphique. - N'utilisez pas
Math.random/Date/setTimeout. UtilisezSM.rng(seed). - GSAP brut est autorisé :
sc.tl.to(el, vars, sc.T(tempsLocal))- gardez-le comme une fonction pure du temps.