棒人間アニメーター
あなたは**scenes.js**を書きます - 各クリップに対してfilm.scene(id, sc => { … })を、film.jsonと同じid、同じ順序で記述します。すべてはグローバルSMエンジンに対するプレーンなブラウザJSです。書き始める前にreferences/api.md(完全なチートシート)とreferences/cookbook.md(コピペレシピ集)を読んでください。
メンタルモデル
- ローカル時間。 シーン内のすべての時間は、クリップ開始からの秒数です。
sc.dur= クリップの長さ。 - チェーン可能。 すべてのアクションは終了時間を返します:
const t = bob.walkTo(900, 0.2); bob.wave(t); - ボイス同期。
sc.cue("word")= ナレーターがその単語を発声する推定ローカル時間(sc.cue(["word", 1])= 2回目の出現、sc.cue(0.5)= VOの途中)。視覚効果は単語の上または直前に配置します(sc.cue("idea") - 0.15)。 - レイヤー。
world(環境)→back(プロップ)→ 図形 →front(図形の上のプロップ)→ui(スクリーン空間、カメラを無視)→top(トランジション)。プロップには{ layer: "front" }/"ui"を渡します。 - 座標。 キャンバスは
sc.W × sc.H(1920×1080、1080×1920または1080×1080)。sc.groundYは床(ランドスケープで80%ダウン、ポートレートで74%ダウン)。図形はy= 足の位置で立っています。 - もの。 プロップ、テキスト、チャート、シェイプは
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。 - 出現まで非表示。
{ hidden: true }で作成し、.pop(t)します。テキストは.in(t, fx)まで非表示です。
シーンの骨格
const film = SM.film(); // テーマ/フォーマットはfilm.jsonから
film.scene("hook", sc => {
sc.enter("fade"); // オプション、前のexitと合わせる
sc.ground(); // 床ライン(スタイル:"grass" | "none")
const bob = sc.figure({ x: -150, face: "dots" }); // または 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("this"));
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("grew"));
sc.text("Revenue [doubled]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("doubled") - 0.1, "words");
sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3); // スロープッシュ
sc.exit("wipe-left");
});
イントロとアウトロ
film.jsonで"intro" / "outro"と宣言されたクリップは自動的に構築されます。それらのシーンを書く必要はありません。エクストラ(タイトル周りに飛び出すプロップ、CTAで手を振る図形など)を追加するには、シーンを書いて自分でプリセットを呼び出します。その場合、自動バージョンはスキップされます:
film.scene("intro", sc => {
const t = sc.intro("countdown", sc.clip.intro); // タイトルが配置された時間を返す
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);
});
演出ルール(見栄えを良くするためのルール)
- 2~3秒ごとに何かが変わる。 クリップあたり3ビートを計画し、ギャップをカメラプッシュ、まばたき/うなずき、プロップの揺れ、ハイライトで埋めます。
- アニメーションの前にステージを設定する。 図形、メインプロップ、テキストの配置を決めます(16:9では三分割、9:16では積み重ね)。テキストは図形の頭部や他のテキストから遠ざけてください。
- 図形は立っているだけでなく、動作する。 意味のあるジェスチャーを使います:議論しているものを
point、アイデアの前にthink、暴露でsurprise、神話に対してshrug、勝利でcelebrate、努力のためにpush/climb/runTo。 - 焦点となる入場は一度に一つ;複数のものが現れる場合は0.1~0.2秒ずつずらします。
- クリップ間でexitとenterを一致させる(同じトランジションタイプ)、またはマッチカット(同じポーズ/オブジェクト位置)。
- アクセントは意味を持つ:
"a1"問題、"a2"解決策、"a3"報酬。カラー名を渡します:"a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper"または16進数。 - グラウンドトゥルース: 図形は
sc.groundY(または計算した表面)に立ちます。床に置くプロップはy = sc.groundY - size*0.4を使います。 - ポートレート: 図形
size: 420-460、プロップ200-300、テキスト70-120、中央の帯を忙しくし、キャプションは低く。
検証(必須ループ)
stickman check <dir>→ Check passedと表示される必要があります。page_error= JSがエラーをスローしました。修正してください。stickman snapshot <dir>(またはキービートで--at時間)→snapshots/contact-sheet*.jpgとPNGを開いて確認してください。 修正:クリッピング、重なり、浮いている図形、空白の瞬間、読めないテキスト、頭を通る腕(ポーズオーバーライドを調整)、間違ったアクセントカラー。- 問題がなくなるまで再実行し、その後レンダリングします。
落とし穴
- 各図形を時系列でスケジュールします。
celebrate()は+1.0秒後にstandに戻るスケジュールを設定します。すぐ後にまたポーズを取る場合は{ hold: true }を渡します。 bob.hold(prop)は右手に取り付けられ、直立したままになります。使用前に作成し.pop(t)します。- テキストマークアップ:
"[アクセント付き単語]"はaccentオプション(デフォルトa2)でフレーズに色を付けます。 - チャートは離散ステップで数字をカウントします。チャートオプションで
prefix/suffix/decimalsを指定します。 Math.random/Date/setTimeoutは使用しないでください。SM.rng(seed)を使用します。- 生のGSAPは許可されています:
sc.tl.to(el, vars, sc.T(localTime))- 時間の純粋関数として保ちます。