Craft 2D Animation (EffectCraft + FilmCraft)
通用且可重複使用的方法,用於在 EffectCraft 中設計、動畫化與組裝片頭、產品展示、短場景或 2D 短片(可在 FilmCraft 中選擇性剪輯/輸出),無論是否有音樂音軌。
參考 CLI/MCP 與共用的 Flatpak 權限:../craft-music-video/references/mcp-and-commands.md
1. 視覺方向與場景可讀性
- 可透過顏色辨識的場景:將短場景限制在最多 2 或 3 個場景,每個場景有其主色調照明與專屬色板(例如:暖色走廊/夜晚、被螢幕照亮的辦公桌、僅以單一強調色保留給錯誤或警報的明亮房間)。
- 實心剪影而非中空輪廓:使用填滿的幾何形狀(貝茲曲線或圓角矩形)來建構角色與場景元素,搭配極簡的臉部(簡單的眼睛、眉毛、嘴巴),並在光源側添加微弱的邊緣光(
rim light)。 - 剪影對比:從縮圖階段就需區分每個角色(例如:圓潤、矮胖的剪影 vs. 方形肩膀、動作俐落的直立剪影)。
- 為攝影機運動預留的超大場景:繪製比畫面更寬的背景/牆壁(
2200–2400 px用於1920×1080的縮放/晃動,或3600+ px用於全景平移),以避免畫面邊緣出現 10–20 px 的黑色邊框。
2. 取景與視覺語法
變換鏡頭景別以無需多餘文字即可敘述動作:
| 景別 | 敘事角色 | 技術最佳實踐 |
|---|---|---|
| 廣角鏡頭 (Establishing) | 展示場景、燈光與元素的相對位置 | 在返回同一場景時,保持固定的空間參考點(辦公桌、螢幕、標誌、門) |
| 過肩鏡頭 (OTS) | 顯示角色的目標及其對介面或物體的視角 | 在首次嘗試與最終成功之間重複使用完全相同的 OTS 取景,以建立即時的視覺回顧提示 |
| 中景 / 側面 | 追蹤姿態、移動與場景的物理變化 | 非常適合展示逐漸畏縮、椅子後退或大幅度動作 |
| 特寫 (Close-up) | 聚焦於意圖、介面細節、按鍵上的手、表情或笑點 | 保持動作簡短清晰;利用特寫來創造乾淨的負空間區域 |
攝影機取景計算 (cam_focus)
使用錨點為 [0, 0] 的 Null 攝影機,若要將世界座標點 (tx, ty) 置中於 W × H 畫面的中央,且縮放比例為 sc %,則完全符合以下公式:
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 姿勢。
- 在動作之前添加一個微小的反向預備動作(例如:手指抬起並猶豫後再按下按鍵;門先微開再砰然關上;身體先靠穩再後退)。
- 以輕微的過衝(
overshoot)或清晰的停頓(hold)結束,以賦予重量感(例如:角色後退一步,暫停欣賞其工作)。
- 漸進式的姿勢階段:在等待或張力上升期間,讓姿勢在兩個鏡頭之間透過清晰的階段性變化來演進(軀幹傾斜、頭部下垂、手臂放鬆),而非持續漂浮。
- 在兩個動作之間保持鏡頭靜止:讓構圖在重點之間有呼吸空間(眨眼、微慢速縮放、游標閃爍),而不是讓所有圖層持續晃動。
- 強制無聲測試:不開聲音觀看任何動作、片頭或展示場景(或透過 3–5 張關鍵幀
render-frame進行)。角色的目標與場景進展必須 100% 僅透過畫面即可理解。
4. 角色錨點、攝影機與疊加順序 (EffectCraft 陷阱)
這些規則能避免 EffectCraft 中(表現與 After Effects 相容)的偏移、肢體分離或元素隱藏等錯誤:
A. Null 物件與攝影機
comp.layers.addNull()預設會建立一個錨點在[50, 50]、位置在[960, 540]的 Null。在定位或建立父子關係之前,務必強制將anchorPoint.setValue([0, 0])(這就是ec_runtime.py中makeCamNull所做的)。- 務必先執行
child.parent = parent,再執行child.position.setValue(...),這樣子物件的座標才能直接在其父物件的局部座標系中解釋。
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 s,即使跨越鏡頭剪輯點也是如此)。
- 套用柔和的投影效果(
- 嚴格區分故事內文字(
V1)與疊加文字(V2):- 場景內建文字(
V1):招牌、螢幕介面、紙張、黑板、按鍵標籤。它們是動畫世界的一部分,並保留在所有輸出中。 - 疊加文字(
V2,ProRes 4444 RGBA):標題、卡片、字幕、歌詞或 UI 註解。將其放置於單獨的透明合成中,可一鍵輸出一個有標題的版本和一個乾淨版,且剪輯完全一致。
- 場景內建文字(
6. 視覺檢查與節省資源的渲染
- 在任何影片渲染前使用關鍵影格進行檢查:對每個鏡頭的 1 到 2 個關鍵時刻使用
effectcraft-cli render-frame --max-side 960(並對V2疊加層使用--transparent),以在幾秒鐘內驗證取景、關節連接與文字可讀性。 - 安全的序列化渲染(8 GB RAM / 普通 CPU 機台):
- 一次只渲染一個合成(切勿在 8 GB 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 Runtime 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 | 以低負載渲染 V* 場景(ProRes HQ RGB)與 L*/T* 疊加層(ProRes 4444 RGBA),並透過 ffprobe 自動續傳 |
| FilmCraft 組合與輸出 | ~/.t3/shared/craft-video/assemble_filmcraft.py | 將 V1(+ 可選的 V2 alpha 與 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
# 預覽低負載序列化渲染計畫(場景 + Alpha 標題)
~/.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