motion-graphics
動画は、全ピクセルが時間 t の純粋関数である1つのHTMLページであり、ヘッドレスChromiumでフレームごとにレンダリングされ、ffmpegでエンコードされます。目標はシニアモーションデザイナーのショーリール品質であり、決してスライドショーではありません。
1. フォーマットを選択
| 依頼内容 | 参照ファイル |
|---|---|
| 実際の製品のローンチ、プロモーション、コマーシャル、フィーチャーリール、アプリトレーラー | formats/launch-video.md |
| Shorts、Reels、TikTok、縦型説明動画やストーリー | formats/shorts.md |
フォーマットファイルに従い、ブリーフ、コンテンツ手順、ビート構造を確認してください。その後、ビルドのためにここに戻ってきます。また、コンポジションを作成する前に references/pitfalls.md も読んでください。
毎回新しいコンセプトで作成。 各動画には独自のアイデア、スクリプト、ルックがあります。ユーザーが過去の作品を参照しないように指示した場合は、以前の動画やコンポジションをワークスペースで開かないでください。
2. 作業フォルダ
ユーザーが希望する場所(デフォルトはカレントディレクトリ)に <slug>-<YYYYMMDD>/ を作成します:
brief.md フォーマットのブリーフテーブルからのパラメータ
beats.md ビートシート(時間、コピー、アセット、動き、トランジション、アクセントヒット)
assets/ キャプチャ、画像、フォント、オーディオ
assets/manifest.md アセットファイルごとに1行:ソース、ライセンスまたは「<サーフェス>からキャプチャ」、表示内容
motion.html コンポジション
motion.json {"size": [W, H], "fps": 60, "duration": 30, "stills": [ビート時間], "captions": []}
engine/ このスキルの engine/ からコピー
out/ スチル、レンダリング、コンタクトシート
フォルダごとに一度だけエンジンをセットアップします:
cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. コンポジション
motion.html は engine/runtime.css と engine/runtime.js をロードし、DOMを構築し、シーンを登録して、MG.ready() を呼び出します。
| ヘルパー | 使用法 |
|---|---|
MG.scene(start, end, fn, el) | fn(local, t, dur) は start <= t < end の間実行されます。el は範囲外では非表示になります。アニメーションするプロパティはすべての呼び出しで設定します。 |
MG.always(fn) | 毎フレーム実行:背景、グレイン、プログレスバーなど。 |
MG.prog(t, a, b, ease) | イージングされた0..1の進行度。イージング:MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) または任意の関数。 |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | キーフレーム。値は配列でも可。 |
MG.spring(t, {stiffness, damping}) | オーバーシュートを伴う物理的な0→1。 |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | 要素ごとにフレームごとに1回呼び出し。 |
MG.clip(videoEl, start, rate) | start からフレーム精度でスクリーンレコーディングを再生。 |
MG.rng(seed), MG.noise(x, seed) | 決定論的な乱数と揺らぎ。 |
MG.fmt(n, {decimals}) | カウンター用のロケール数値書式設定。 |
MG.captions() | motion.json のキャプションを下部UIブロックの上に描画。 |
決定論:レンダリングロジック内で Date、performance.now()、requestAnimationFrame、Math.random を使用しないでください。CSS @keyframes は許可されています。ランタイムは t でそれらを一時停止するため、animation-delay でタイミングを合わせてください。マニフェストにリストされているフォントと画像のみを使用してください。
フレームのプレビュー:open "motion.html?w=1920&h=1080&t=3.2&guides=1"(ガイドはセーフゾーンを表示)。リアルタイム:?play=1。キャプションはレンダリング時のみ表示されます。
4. クラフト基準
- フレーム0はすでに動いている。 黒からのフェードイン、ロゴのイントロはなし。
- 0.8~2秒ごとに、レイアウト、スケール、色、数字、またはカメラに意味のある変化がある。
- エントランスにはスプリングまたはイーズアウトエクスポを使用し、わずかにオーバーシュートさせる。30~60 msのずらし。リニアはティッカーだけ。
- 速い動きのときのみモーションブラー。ホールドショットではスロープッシュ(スケール 1 → 1.04)。2~3のデプスレイヤーでパララックス。
- 背景ファミリーは1つ、テキストカラーは1つ、アクセントは1つ。フラットフィルがアップロード後にバンディングしないように、グレインまたはグラデーションノイズを追加。
- コピーは2回読める時間画面上に残す。主要テキストはセーフゾーン内に収める。
- ビートは音と同期:各変化にウーッシュ、ヒット、または音楽のビート。
5. レンダリング
node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4
まずスチルでレイアウトを確定します:ビートごとに1枚、各トゥイーン内に1枚、各スプリングのオーバーシュートピークに1枚。1回のフルレンダリングを実行します(1080p60、4ワーカーで25秒間で約10分)。
6. オーディオ
マニフェストにリストされ、使用を許可するライセンスがある音楽とSFXのみを使用するか、ユーザーが提供するファイルを使用します。それらがない場合は、無音で納品し、その旨を伝えます。キューミックスしてから、マルチプレックス:
ffmpeg -i music.wav -i whoosh.wav -filter_complex \
"[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
-af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"
統合ラウドネスは約−14 LUFS、トゥルーピークは−1 dBFS以下を目標にします。SFXは約−6~−14 dB、音楽は−14~−18 dB。画面上のテキストの下の音楽はインストゥルメンタルにします。
7. QA
ffprobeで、長さ、サイズ、fpsがブリーフと一致していることを確認。- コンタクトシート:
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png。各ビートチェンジで、コンタクトシートとフルサイズのフレームを確認(ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png)。 - すべてのフレーム:エッジでクリップされていない、空白または半ばフェードしたフレームがない、ガイドの残骸がない、誤字やプレースホルダーテキストがない、2秒以上静止しているものがない。
- フォーマットファイル独自のチェック。
すべてのチェックがパスするまで修正と再レンダリングを繰り返します。新しい教訓があれば、スキルの references/pitfalls.md に 日付 · 動画 · 教訓 の形式で追加します。
納品
最終的なMP4のパス、長さ、サイズ、fps、表示内容、必要なクレジットを含むオーディオステータス、再レンダリングコマンドを報告します。作業フォルダは保持します。アップロードまたは投稿はユーザーから依頼があった場合のみ行います。