motion-animate
デザインはフレームが良いかどうかを決める。モーションはそれが高価に見えるかどうかを決める。 線形イージングと同時登場でアニメーションされた同じ構図は生成されたように読める。以下の語彙でアニメーションすると、手書きで作られたように読める。
エンジンレシピ: 付録A、付録B。
四つの法則
- 何も線形ではない。 すべてのプロパティはイージングで動く。線形モーションは物理世界に存在せず、目はそれを即座に見抜く。
- 何も一度に登場しない。 要素は意図的な順序で、60〜120msの間隔を空けて到着する。同時登場は最も目立つモーションの欠点である。
- カメラは決して完全に静止しない。 どの構図の下でも、ゆっくりとした連続的なプッシュまたはドリフトが行われる。静的なフレームはスライドショーのように読める。
- 何もメトロノームではない。 長さとカットの間隔を変化させる。均一な1秒のビートは、それぞれのビートがどんなに良くても自動化されたように感じられる。
タイミングテーブル
30fpsでの値。60fpsの場合はスケーリング。時間はms。
| 要素 | 長さ | スタガー | イーズ |
|---|---|---|---|
| テキスト行内の単語 | 400–550 | 60–90 | out-expo / power3.out |
| テキスト行(単位として) | 500–650 | 120–180 | out-cubic / power2.out |
| アイコン/小さなUI要素 | 350–450 | 80–120 | out-back (オーバーシュート ≤1.06) |
| パネル/カード | 550–700 | 140–200 | out-quint / power4.out |
| ヒーローオブジェクト スケールイン | 700–900 | — | out-expo |
| ヒーローオブジェクト スライドイン | 650–850 | — | out-quint |
| ライン/ストローク描画 | 600–1000 | — | in-out-cubic |
| カメラプッシュ(シーンごと) | シーン全体の長さ | — | out-sine、または非常に遅い場合は線形に近い |
| 終了(任意の要素) | 250–350 | 40–60 | in-cubic |
終了は常に登場よりも速く、おおよそ半分の時間である。対称的なアウトアニメーションは鈍く感じられる。
コアな動き
テキスト — ポップ・ブラー・フェード、単語ごと
特徴的な動き。すべてのプロパティが単語ごとに、スタガーされながら一緒にアニメーションする。
y: +18px → 0
blur: 12px → 0
opacity: 0 → 1
ease: out-expo, duration 480ms, stagger 70ms
オプションで scale: 0.96 → 1 を追加する。回転は追加しない。バウンスさせない。
長い行の場合は、単語ごとにスタガーする。文字ごとのスタガーはタイプライターのギミックのように読め、時間がかかりすぎる。文字ごとのスタガーは、短いアクセント単語1つのために取っておく。
アクセント単語
同じ動きを行うが、隣接する単語より120〜200ms遅らせて、追加のプロパティ(色の変更、1.04へのスケールアップ、背後にワイプインするハイライトバーなど)を1つ与える。最後に着地し、異なる方法で着地する必要がある。
アイコンとUI
ポップ・フェード: scale 0.7 → 1、opacity 0 → 1、out-back (オーバーシュートは1.06に制限)。1.1を超えると安っぽいバウンスのように読める。
連続ルール: アンカー要素が最初に登場し、次にその依存要素が登場する。カードが登場し、次にそのアイコン、次にそのラベル。決して逆順ではなく、同時でもない。
パネル/カード/ガラス
y: +40 → 0、opacity 0 → 1、out-quint、600ms、スタック全体で160msのスタガー。パネルが着地した後に150msでパネルを横切る光のスイープハイライトを追加する — パネルが到着し、それから光を受ける。
ヒーローオブジェクト
アーキタイプに応じて2つのオプションから選択:
- スケールイン:
scale 1.25 → 1.00、rotate 3° → 0°、out-expo、800ms。所定の位置に落ち着くように感じられる。 - スライドイン: フレーム外から、2°の傾きが0°に解消される、
out-quint、750ms。配達されたように感じられる。
キャストシャドウとクリップされたテクスチャはヒーローにペアレント化され、それと一緒に動く必要がある。ペアレント化されていない影が独立してスライドするのは重大な失敗である。
ストローク/ライン描画
パスの長さを0〜100%でアニメーション、in-out-cubic、600〜1000ms。イーズインおよびアウト — 最大速度で開始する描画は機械的に見える。ラベルを被写体に接続したり、アクセント単語の下線を引いたり、グラフをトレースするために使用する。
カメラ
すべての構図の下で、以下のいずれか:
- プッシュイン: ビート全体で
scale 1.00 → 1.08、out-sine。 - プッシュアウト:
scale 1.12 → 1.00、開始時は速く、その後落ち着く。 - ドリフト: ビート全体で2〜4%の
xまたはyの移動。
アンチジッター契約:
- ラッパー要素をアニメーションし、レイアウトやクリッピングを所有する要素は決してアニメーションしない。
transformのみを使用 — 決してtop/left/width/heightは使用しない。- 移動レイヤーをフレームより約6%大きくスケールアップして、端が露出しないようにする。
will-change: transformを設定し、GPUコンポジットを強制する。- 総移動距離を小さく保つ。大きなカメラ移動はすべての丸め誤差を増幅させる。
ビート間のトランジション
- ハードカット SFXヒットでマスク — デフォルト。デザインされたフレーム間のクロスフェードは両方を濁らせる。
- スケールスルー — 要素がフレームを埋めるようにスケールアップし、その内部で次のシーンが明らかになる。
- シェイプによるワイプ — 円やパネルがフレーム端を超えてスケールし、次のシーンを運ぶ。
デザインされた2つの構図をクロスフェードしない。ストックのトランジションプリセットを使用しない。
禁止事項
- 可視のものへの線形イージング。
- バウンスオーバーシュート >1.1(例外: 意図的に遊び心のあるSaaS/プロダクトスタイルで、かつ一貫している場合)。
- すべての要素が同じフレームで登場すること。
- 編集全体で均一なビートの長さ。
repeat: -1または無限ループ — レンダリングはフレームサンプリングされ、決定論的でなければならない。- コンポジション内での
Math.random()、Date.now()、またはネットワークフェッチ。同じ入力は毎回同じフレームを生成しなければならない。 - フレームワークが既に制御しているラッパーへのモーション適用(付録B §clipルールを参照)。
セルフチェック
レンダリングを0.25倍速でスクラブする。確認:
- 何かが突然開始したり停止したりしていないか? → イージング不足。
- すべてが一緒に着地していないか? → スタガー不足。
- フレームが完全に静止している瞬間がないか? → カメラ不足。
- 連続するビートがドラムビートのように感じられないか? → 長さが均一すぎる。
- 移動レイヤーの端が露出していないか? → スケール不足。
付録A — Remotionレシピ
フレームベース、構造上決定論的。すべてのタイミングは useCurrentFrame() から派生する。
ヘルパー: フレームではなくms単位の時間
フレームで作成すると、fpsがハードコードされる。変換する。
import {useVideoConfig, useCurrentFrame, interpolate, Easing} from 'remotion';
const useMs = () => {
const {fps} = useVideoConfig();
return (ms: number) => (ms / 1000) * fps;
};
イージングマップ
タイミングテーブル内の名前をRemotionの用語で:
Easing.out(Easing.exp) // out-expo
Easing.out(Easing.cubic) // out-cubic
Easing.out(Easing.quad) // out-quad
Easing.out(Easing.poly(4)) // out-quint-ish
Easing.inOut(Easing.cubic) // in-out-cubic
Easing.out(Easing.sin) // out-sine
Easing.in(Easing.cubic) // in-cubic (exits)
Easing.bezier(0.16, 1, 0.3, 1) // the workhorse — expo-ish out
オーバーシュートには、Easing.back よりも spring を推奨 — 微妙さを保ちやすい。
import {spring} from 'remotion';
const s = spring({frame, fps, config: {damping: 200, stiffness: 120, mass: 0.6}});
// damping 200 = 可視のオーバーシュートなし。小さな落ち着きのためには約14に下げる。
テキスト — ポップ・ブラー・フェード、単語ごと
const Words: React.FC<{text: string; delay?: number}> = ({text, delay = 0}) => {
const frame = useCurrentFrame();
const ms = useMs();
const STAGGER = ms(70);
const DUR = ms(480);
return (
<span style={{display: 'inline-flex', flexWrap: 'wrap', gap: '0.28em'}}>
{text.split(' ').map((word, i) => {
const local = frame - ms(delay) - i * STAGGER;
const p = interpolate(local, [0, DUR], [0, 1], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return (
<span
key={i}
style={{
display: 'inline-block',
opacity: p,
filter: `blur(${(1 - p) * 12}px)`,
transform: `translateY(${(1 - p) * 18}px)`,
willChange: 'transform, filter, opacity',
}}
>
{word}
</span>
);
})}
</span>
);
};
アクセント単語は同じコンポーネントで、delay を120〜200ms遅らせ、独自の色と scale(1.04) を追加する。
カメラ — 常時オンのプッシュ
シーン全体をラップする。端が露出しないようにオーバースケールする。
const Camera: React.FC<{children: React.ReactNode; durationInFrames: number}> = ({
children, durationInFrames,
}) => {
const frame = useCurrentFrame();
const scale = interpolate(frame, [0, durationInFrames], [1.0, 1.08], {
extrapolateRight: 'clamp',
easing: Easing.out(Easing.sin),
});
return (
<AbsoluteFill style={{transform: `scale(${scale})`, willChange: 'transform'}}>
{children}
</AbsoluteFill>
);
};
カメラをグラウンドレイヤーの上、フレーム端にピン留めする必要がある要素の下に配置する。
スタガーされたカードスタック
const cards = ['One', 'Two', 'Three'];
const ms = useMs();
{cards.map((label, i) => {
const local = frame - i * ms(160);
const p = interpolate(local, [0, ms(600)], [0, 1], {
extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
easing: Easing.out(Easing.poly(4)),
});
return (
<div key={i} style={{
opacity: p,
transform: `translateY(${(1 - p) * 40}px)`,
}}>{label}</div>
);
})}
終了 — 登場の半分の時間
const exitStart = durationInFrames - ms(300);
const out = interpolate(frame, [exitStart, durationInFrames], [1, 0], {
extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
easing: Easing.in(Easing.cubic),
});
構造
ビートごとに <Sequence from={...} durationInFrames={...}> を使用し、motion-plan テーブルから直接駆動する。行ごとに1つの Sequence。ビートの長さは計画から取得し、丸めた数値ではない。
<Series>
<Series.Sequence durationInFrames={ms(5200)}><BeatTwo /></Series.Sequence>
<Series.Sequence durationInFrames={ms(2100)}><BeatThree /></Series.Sequence>
</Series>
決定論
- 決して
Math.random()を使用しない — ばらつきが必要な場合は、要素インデックスからシードする。 - 決して
Date.now()またはnew Date()を使用しない。 - コンポーネント内でフェッチしない。
staticFile()/delayRender()でプリロードする。 <Video>/<Audio>は、レンダリングの正確性のために可能な限り<OffthreadVideo>でなければならない。
注意点
- 多くの同時要素に対する
filter: blur()は高コスト — 同時ブラーノードの数を制限するか、アセット内で事前にブラーをかける。 - フォント読み込み:
@remotion/google-fontsを使用するか、ローカルのFontFace.load()の周りでdelayRenderを使用する。そうしないと、最初のフレームがフォールバックフォントでレンダリングされる。 - 入力範囲が単調増加でない場合、
interpolateはエラーをスローする — 計算された範囲をガードする。 - 値を範囲外に実行させたい場合を除き、常に
extrapolateLeft/extrapolateRight: 'clamp'を渡す。
付録B — HyperFrames / GSAPレシピ
HyperFramesはHTML + GSAPを構成し、ヘッドレスブラウザのフレームサンプリングによってレンダリングする。決定論は必須である。
現在のAPIについては npx hyperframes docs を実行すること。このファイルはその上にあるモーション標準である — パイプライン(init → preview → lint → render)については hyperframes スキルを参照。
クリップルール(違反するとレンダリングが壊れる)
すべてのタイミング要素には data-start、data-duration、data-track-index および class="clip" が必要。フレームワークは .clip 上の可視性とtransformを所有する。
GSAPで .clip 要素自体をアニメーションしないこと。 子のラッパーをアニメーションする。
<div class="clip" data-start="4.2" data-duration="5.2" data-track-index="2">
<div class="cam"> <!-- カメラはここで動く -->
<div class="inner"> <!-- 要素のモーションはここで -->
<h1 class="headline">…</h1>
</div>
</div>
</div>
タイムライン登録
const tl = gsap.timeline({paused: true});
window.__timelines['main'] = tl; // id は data-composition-id と一致しなければならない
常に一時停止。レンダラーがこれをシークする。
イージングマップ
| テーブル名 | GSAP |
|---|---|
| out-expo | expo.out |
| out-cubic | power2.out |
| out-quint | power4.out |
| out-back (制限あり) | back.out(1.2) |
| in-out-cubic | power2.inOut |
| out-sine | sine.out |
| in-cubic (終了) | power2.in |
テキスト — ポップ・ブラー・フェード、単語ごと
作成時に単語スパンに分割する(ランタイムスプリッターに依存しない — 最初のサンプリングフレームと競合する可能性がある)。
<h1 class="headline">
<span class="w">What</span> <span class="w">looks</span>
<span class="w accent">like</span> <span class="w">discipline</span>
</h1>
tl.from('.headline .w', {
y: 18,
opacity: 0,
filter: 'blur(12px)',
duration: 0.48,
ease: 'expo.out',
stagger: 0.07,
}, 0);
// アクセント単語は最後に、そして異なる方法で着地する
tl.from('.headline .accent', {
scale: 0.96,
color: 'var(--surface)',
duration: 0.5,
ease: 'expo.out',
}, 0.18);
カメラ
.cam をアニメーションし、決して .clip はアニメーションしない。
tl.fromTo('.cam',
{scale: 1.0},
{scale: 1.08, duration: 5.2, ease: 'sine.out', force3D: true},
0);
.cam { will-change: transform; transform: translateZ(0); }
プッシュアウトやドリフト中に端が露出しないように、移動レイヤーをフレームより約6%大きくオーバースケールする。
スタガーされたカードスタック
tl.from('.card', {
y: 40, opacity: 0,
duration: 0.6, ease: 'power4.out', stagger: 0.16,
}, 1.2);
// ライトスイープはパネルの150ms後に着地する
tl.fromTo('.card .sweep', {xPercent: -140}, {
xPercent: 140, duration: 0.7, ease: 'power2.inOut', stagger: 0.16,
}, 1.35);
ストローク描画
tl.fromTo('.connector', {drawSVG: '0%'}, {drawSVG: '100%', duration: 0.8, ease: 'power2.inOut'});
// DrawSVGPluginなし? stroke-dasharray/offsetを使用:
tl.fromTo('.connector', {strokeDashoffset: 1000}, {strokeDashoffset: 0, duration: 0.8, ease: 'power2.inOut'});
厳格なルール
- 決定論のみ —
Math.random()、Date.now()、fetch、repeat: -1は禁止。 - 9:16 = 1080×1920。
#root { container-type: size; }を設定し、すべてをcqw/cqh(1cqw = 10.8px)でサイズ設定し、決してvw/vhを使用しない。 - 隣接する同じトラックのクリップは接触してはならない。 浮動小数点演算により
3.2 + 0.35 = 3.5500000000000003となり、これは3.55で開始するクリップと重なり、overlapping_clips_same_trackをトリガーする。ギャップを残すか、0.34のような長さを使用する。 - オーディオ: ビデオは
muted。1つのプリミックスされたマスター<audio>トラック(ffmpegのadelay+amixでミックスされたVO + SFX)を、専用の高いdata-track-indexで使用する。複数の `<a