Craft 2D Animation (EffectCraft + FilmCraft)
EffectCraft(オプションでFilmCraftでの編集・出力も可)を使用して、イントロ、プロダクトデモ、短いシーン、2D短編アニメーションをデザイン、アニメーション化、組み立てるための汎用的で再利用可能な方法です。音楽トラックの有無を問いません。
共有CLI/MCPリファレンスとFlatpakパーミッション:../craft-music-video/references/mcp-and-commands.md。
1. ビジュアルディレクションとシーンの可読性
- 色で識別できる場所:短いシーンは最大2〜3つの場所に制限し、それぞれに支配的な照明と専用のパレットを割り当てます(例:暖かく暗い廊下、画面に照らされた作業スペース、エラーや警告用に1色のみのアクセントカラーを持つ明るい部屋)。
- 中抜きの輪郭ではなく塗りつぶされたシルエット:キャラクターと背景は塗りつぶされた幾何学的形状(ベジェ曲線または角丸長方形)で構築し、ミニマルな顔(目、眉毛、口はシンプルに)と、光源側にわずかな逆光線(
リムライト)を追加します。 - シルエットのコントラスト:サムネイルの段階から各キャラクターを区別します(例:丸みを帯びてうずくまるシルエット vs 角ばった肩と素早い動きの直立したシルエット)。
- カメラ移動のための拡大された背景:背景/壁はフレームよりも広く描画します(
1920×1080でズーム/シェイクの場合は2200–2400 px、パノラマトラベリングの場合は3600+ px)。これにより、フレーム端に10〜20ピクセルの黒い境界線が表示されるのを防ぎます。
2. フレーミングとビジュアルグラマー
ショットサイズを変えて、不必要なテキストなしでアクションを伝えます:
| ショットサイズ | ナラティブ上の役割 | 技術的なベストプラクティス |
|---|---|---|
| ロングショット( Establishing ) | 場所、照明、要素の相対的な位置を提示する | 同じ場所に戻ったときに、固定された空間的な目印(机、画面、パネル、ドア)を維持する |
| オーバー・ザ・ショルダー( OTS ) | キャラクターの目的と、インターフェースやオブジェクトに対する視点を示す | 最初の試行と最終的な成功の間でまったく同じOTSフレーミングを再利用し、即座に視覚的なコールバックを生み出す |
| ミディアムショット / プロフィール | 姿勢、動き、シーンの物理的な変化を追う | 徐々にうずくまる、椅子を後ろに下げる、または大きなジェスチャーを示すのに理想的 |
| クローズアップ( Close-up ) | 意図、インターフェースの細部、キーを押す手、視線、ギャグを切り取る | 動きは短く読みやすく保つ;クローズアップを利用して、すっきりとした負のスペースを生み出す |
カメラフレーミングの計算 (cam_focus)
アンカーヌルカメラが[0, 0]の場合、ワールド上の点(tx, ty)を、スケールsc %のフレームW × Hの中央に配置するには、次の式に正確に従います:
pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty]
(ec_runtime.py内のcam_focus(tx, ty, scale_pct, width, height)で直接利用可能です)。
3. ポーズの変更、重み、視覚的リズム
- 予備動作 → アクション → オーバーシュート / ホールド:
- ポーズAからポーズBへ直線的に移行しないでください。
- アクションの前に、逆方向の小さな予備動作を追加します(例:キーを叩く前に指が上がってためらう、ドアがバタンと閉まる前に少し開く、後退する前に体が支えをとる)。
- わずかなオーバーシュートまたは読み取り可能な停止(ホールド)で終了して、重みを与えます(例:キャラクターが一歩下がって、自分の仕事を賞賛するために一呼吸置く)。
- 段階的な姿勢の変化:待機中または緊張が高まっているときは、常に浮遊させるのではなく、ショット間で明確な段階を経て姿勢を変化させます(胴体の傾き、頭を下げる、腕のリラックス)。
- アクション間のショットの保持:すべてのレイヤーを常に動かし続けるのではなく、アクセントの間(まばたき、スローズーム、点滅するカーソル)に構図を呼吸させます。
- 必須の無音テスト:すべてのアクションシーン、イントロ、デモを音声なしで(または3〜5枚の
render-frameキーフレームキャプチャを介して)視聴します。キャラクターの目的とシーンの進行は、映像だけで100%理解可能でなければなりません。
4. キャラクターアンカー、カメラアンカー、スタッキング順序(EffectCraftの落とし穴)
これらのルールは、EffectCraft(After Effects互換の動作)での位置ずれ、パーツの分離、要素が隠れるなどのバグを回避します:
A. ヌルとカメラ
comp.layers.addNull()は、デフォルトでアンカーを[50, 50]、位置を[960, 540]に作成します。ヌルを配置またはペアレントする前に、常にanchorPoint.setValue([0, 0])を強制してください(これはec_runtime.pyのmakeCamNullが行うことです)。child.position.setValue(...)の前に、常にchild.parent = parentを割り当ててください。これにより、childの座標が親のローカル空間で直接解釈されます。
B. ペアレンティングとトランスフォームに関する絶対ルール
- 親がニュートラルポーズの間(
rotation = 0°、scale = [100, 100])に、すべての子をアタッチします。 - 初期回転、カメラズーム、または親のキーフレームは、子階層全体の作成が完了した後にのみ適用します。
- 理由:
child.parent = parentを割り当てる前にparent.rotationまたはparent.scaleを変更すると、AEスタイルの逆補正がトリガーされ、頭/腕が体から離れたり、背景全体がフレームの隅に縮小されたりします。
C. 関節2Dキャラクターのアンカー階層
- 着席キャラクター:
Rootを腰(hip_pos)に →Chair、Legs、TorsoNull(胴体ピボット[0, 0]) →BackUpperArm(肩) →BackForeArm(肘) →TorsoBody→Head(首の付け根) →UpperArm→ForeArm - 立位キャラクター:
Rootを足の間の床(foot_pos)に置き、ズームや後退時に靴が床に固定されるようにする →LegBack/LegFront(腰ピボット) +TorsoPivot(腰ピボット) →Arms、Blazer/Body、Head - 首/襟の接続:常に、襟/首の塗りつぶし形状を、胴体の上部と頭の下部に重なるように追加します。これにより、強い傾き(
25°~35°)があっても、あごと肩の間に隙間が生じることはありません。
D. スタッキング順序
- 同じシェイプレイヤー内(
ADBE Root Vectors Group) :最初に追加されたグループが一番上に描画され、最後に追加されたグループが一番下に描画されます(前 → 後ろの順序)。 - コンポジション内の個別レイヤー間:新しいレイヤーはインデックス
1(一番上)に挿入されます。レイヤーは後ろ → 前の順序で構築します(背景 → グロー → 背景 → キャラクター → 前景)。
5. テキストの可読性とダイジェティック/オーバーレイの分離
- 恒久的な黒帯は禁止:タイトル、字幕、キャプションは各ショットの空いている負のスペース(画面の上、壁の暗い隅、地平線の下)に配置し、顔、画面の境界線、背景のパネルと重ならないようにします。
- コントラストとセーフマージン:
- ソフトなドロップシャドウ(
ADBE Drop Shadow、不透明度190–230、距離4–6 px、ブラー14–18 px)を適用して、明るい背景と暗い背景の両方での可読性を確保します。 - 水平方向のセーフマージン(
1920×1080で>= 70 px)と、読み取り可能なホールド時間(アクションまたは最後の単語の終了後>= 0.35秒。ショットカットをまたいでも)を遵守します。
- ソフトなドロップシャドウ(
- ダイジェティックテキスト(
V1)とスーパーインポーズテキスト(V2)の厳格な分離:- 背景に統合されたテキスト(
V1):看板、画面インターフェース、書類、黒板、キーボードのキー。アニメーション世界の一部であり、すべての書き出しに存在します。 - スーパーインポーズテキスト(
V2、ProRes 4444 RGBA):タイトル、テロップ、字幕、歌詞、UI注釈。これらを別々の透明コンポジションに配置することで、タイトルありバージョンとクリーンバージョンを、編集的にまったく同じ状態でワンクリックで書き出せます。
- 背景に統合されたテキスト(
6. ビジュアルチェックとリソース効率の良いレンダリング
- 動画レンダリング前のキーフレームチェック:ショットごとに1〜2個のキーとなる瞬間で
effectcraft-cli render-frame --max-side 960を使用し(オーバーレイV2の場合は--transparent)、フレーミング、関節の接続、テキストの可読性を数秒で確認します。 - 安全なシーケンシャルレンダリング(8GB RAM / 低性能CPUマシン向け):
- 一度に1つのコンポジションのみレンダリングします(8GB RAMでProRes 4444 RGBAの並列レンダリングは避けてください)。
- スレッドを制限し(
RAYON_NUM_THREADS=2、OMP_NUM_THREADS=2)、低優先度で起動し(nice -n 15 ionice -c 3)、VRAMがシステムRAMと共有されている場合は--gpuを避け、メモリ解放のためにレンダリング間に2秒の間隔を空けてください。
7. 共有T3 Codeツールと依存関係
再利用可能なスクリプトは ~/.t3/shared/craft-video/ にあります:
| ツール | パス | 2Dアニメーションでの使用法 |
|---|---|---|
| EffectCraft用ランタイムJSX | ~/.t3/shared/craft-video/ec_runtime.py | JsxBuilder、cam_focus、hex_to_rgba、run_effectcraft_scriptをインポートして、.ecproj(アンカー[0,0]、ベジェ、グロー、スムーズ/ホールドキーフレーム)を適切に生成する |
| バッチシーケンシャルレンダリング | ~/.t3/shared/craft-video/render_ec_batch.sh | ffprobeによる自動再開機能付き低負荷で、V*シーン(ProRes HQ RGB)とL*/T*オーバーレイ(ProRes 4444 RGBA)をレンダリングする |
| FilmCraftアセンブル&書き出し | ~/.t3/shared/craft-video/assemble_filmcraft.py | V1(+ オプションでV2アルファとA1オーディオ)をRec.709で.fcprojにアセンブルし、Master + Cleanを書き出す |
必要な依存関係
- Python 3.9以上(標準ライブラリのみ)
ffmpegとffprobe- EffectCraft CLI(
effectcraft-cliまたは Flatpakai.storyteller.effectcraft、--filesystemアクセス付き) - FilmCraft CLI(
filmcraft-cliまたは Flatpakai.storyteller.filmcraft、マルチトラックアセンブル/書き出し用) - Linuxでオプション:
nice、ionice、taskset
コマンド例
# 利用可能な依存関係を確認する(レンダリングなし)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env
# 低負荷シーケンシャルレンダリングプランをプレビューする(シーン + アルファタイトル)
~/.t3/shared/craft-video/render_ec_batch.sh \
--project ./projects/demo_2d.ecproj \
--out-dir ./renders_vfx \
--rgb V01_Intro,V02_Demo \
--rgba T01_Intro,T02_Demo \
--threads 2 --cores 0-3 --dry-run
# 音楽なしのFilmCraftアセンブリをプレビューする(無音のイントロ/デモ、Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
--out-fcproj ./projects/demo_2d.fcproj \
--v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
--v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
--export-master ./exports/demo_2d_titles.mp4 \
--export-clean ./exports/demo_2d_clean.mp4 \
--dry-run