Stickman-Animator
Sie schreiben scenes.js – einen film.scene(id, sc => { … }) pro Clip in film.json, gleiche IDs, gleiche Reihenfolge. Alles ist einfaches Browser-JS gegen die globale SM-Engine. Lesen Sie references/api.md (vollständige Übersicht) und references/cookbook.md (Copy-Paste-Rezepte), bevor Sie schreiben.
Gedankenmodell
- Lokale Zeit. Innerhalb einer Szene ist jede Zeit in Sekunden ab dem Start des Clips.
sc.dur= Cliplänge. - Verkettbar. Jede Aktion gibt die Zeit zurück, zu der sie endet:
const t = bob.walkTo(900, 0.2); bob.wave(t); - Sprachsynchron.
sc.cue("Wort")= geschätzte lokale Zeit, zu der der Sprecher das Wort sagt (sc.cue(["Wort", 1])= zweites Vorkommen,sc.cue(0.5)= Mitte der Sprachaufnahme). Setzen Sie die Visualisierung auf oder kurz vor das Wort (sc.cue("Idee") - 0.15). - Ebenen.
world(Umgebung) →back(Requisiten) → Figuren →front(Requisiten über Figuren) →ui(Bildschirmbereich, ignoriert Kamera) →top(Übergänge). Übergeben Sie{ layer: "front" }/"ui"bei Requisiten. - Koordinaten. Die Leinwand ist
sc.W × sc.H(1920×1080, 1080×1920 oder 1080×1080).sc.groundYist der Boden (80 % unten im Querformat, 74 % im Hochformat). Figuren stehen mity= ihren Füßen. - Dinge. Requisiten, Text, Diagramme, Formen sind
Things:.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. - Versteckt bis zum Auftritt. Erstellen mit
{ hidden: true }dann.pop(t); Text ist versteckt bis.in(t, fx).
Szenen-Gerüst
const film = SM.film(); // Thema/Format kommen aus film.json
film.scene("hook", sc => {
sc.enter("fade"); // optional, zum vorherigen Exit passend
sc.ground(); // Bodenlinie (Stil: "grass" | "none")
const bob = sc.figure({ x: -150, face: "dots" }); // oder 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("dieses"));
const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
chart.grow(sc.cue("wuchs"));
sc.text("Umsatz [verdoppelt]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("verdoppelt") - 0.1, "words");
sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3); // langsamer Push
sc.exit("wipe-left");
});
Intros & Outros
Clips, die "intro" / "outro" in film.json deklarieren, bauen sich selbst. Sie brauchen dafür keine Szene. Um Extras hinzuzufügen (Requisiten, die um den Titel herumplatzen, eine Figur, die zum CTA winkt), schreiben Sie die Szene und rufen das Preset selbst auf; die automatische Version wird dann übersprungen:
film.scene("intro", sc => {
const t = sc.intro("countdown", sc.clip.intro); // gibt zurück, wann der Titel gelandet ist
sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
sc.exit("wipe-left");
});
film.scene("outro", sc => {
sc.enter("fade", { color: "bg" });
sc.outro("kino", sc.clip.outro);
sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});
Regeln für die Inszenierung (was es gut aussehen lässt)
- Alle 2–3 s ändert sich etwas. Planen Sie 3 Beats pro Clip; füllen Sie Lücken mit einem Kamerapush, einem Blinzeln/Nicken, einem Requisiten-Wackeln, einer Hervorhebung.
- Bühne vor der Animation. Entscheiden Sie, wo die Figur, die Hauptrequisite und der Text leben (Drittel bei 16:9; gestapelt bei 9:16). Halten Sie Text vom Kopf der Figur und von anderem Text fern.
- Figuren agieren, nicht stehen. Verwenden Sie Gesten, die etwas bedeuten:
pointauf das Besprochene,thinkvor einer Idee,surprisebei einer Enthüllung,shrugbei einem Mythos,celebratebei einem Erfolg,push/climb/runTofür Anstrengung. - Ein fokaler Auftritt nach dem anderen; staffeln Sie um 0.1–0.2 s, wenn mehrere Dinge erscheinen.
- Passen Sie Exits und Entrances zwischen Clips an (gleicher Übergangstyp) oder Match-Cut (gleiche Pose/Objektposition).
- Akzente tragen Bedeutung:
"a1"Problem,"a2"Lösung,"a3"Belohnung. Übergeben Sie Farbnamen:"a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper"oder Hex. - Bodenwahrheit: Figuren stehen auf
sc.groundY(oder einer von Ihnen berechneten Oberfläche); Requisiten, die auf dem Boden ruhen, verwendeny = sc.groundY - size*0.4. - Hochformat: Figur
size: 420-460, Requisiten 200-300, Text 70-120, halten Sie das mittlere Band belebt und Untertitel tief.
Überprüfen (obligatorische Schleife)
stickman check <verz>→ muss Check passed ausgeben.page_error= Ihr JS hat einen Fehler ausgelöst; beheben Sie ihn.stickman snapshot <verz>(oder--atzu Schlüsselzeitpunkten) → öffnen Siesnapshots/contact-sheet*.jpgund die PNGs und schauen Sie. Korrigieren Sie: Abschneiden, Überlappungen, schwebende Figuren, leere Momente, unleserlichen Text, Arme durch Köpfe (Posen-Overrides anpassen), falsche Akzentfarben.- Wiederholen, bis alles sauber ist, dann rendern.
Fallstricke
- Planen Sie jede Figur chronologisch.
celebrate()plant eine Rückkehr zustandbei +1.0 s; übergeben Sie{ hold: true }, wenn Sie kurz danach wieder posieren. bob.hold(prop)befestigt an der rechten Hand und bleibt aufrecht; vor Gebrauch erstellen und.pop(t)darauf.- Text-Markup:
"[akzentuierte Wörter]"färbt eine Phrase mit deraccent-Option (Standarda2). - Diagramme zählen Zahlen mit diskreten Schritten; geben Sie
prefix/suffix/decimalsin den Diagrammoptionen an. - Verwenden Sie nicht
Math.random/Date/setTimeout. Verwenden SieSM.rng(seed). - Rohes GSAP ist erlaubt:
sc.tl.to(el, vars, sc.T(localTime))– halten Sie es als reine Funktion der Zeit.