繪畫動畫
一種完全以程式碼製作短篇卡通的技術,源自 JohnHeibel/PDoomVideo(一首由 Claude Opus 繪製的 156 秒音樂影片)及其通用工具包 ClaudeAnimationBase(MIT 授權),後者已作為 template/ 包含在此套件中。
運作方式: 每一幀都是時間 t 的純函數。studio.html 會載入 p5.js + p5.brush 以及你的場景檔案;每個鏡頭會以水彩填色和沸騰墨水線條繪製整個 1920×1080 的畫面。render.mjs 驅動無頭 Chrome 來渲染聯繫表供檢視,或並行渲染每一幀,最後 ffmpeg 將它們編碼成 MP4(可選擇加入音訊)。
工作流程
0. 初始設定
bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir> # 加上 --keep-demo 保留範例場景
此命令會複製範本、解開示範場景、執行 npm install,並檢查 node / ffmpeg / Chrome 是否就緒。然後在設計任何內容之前,完整閱讀 <project-dir>/ANIMATION_GUIDE.md:裡面包含了規則、動畫原理以及完整的引擎 / Clawd API。使用「讀取」工具查看 docs/emotions.jpg 和 docs/views.jpg(模型表)。
對於音樂影片或長度超過約 20 秒的影片,也請閱讀 references/music-video.md。對於歌詞影片,請先取得歌曲檔案和 LRC 歌詞檔,並使用 scripts/beat_grid.py 測量節奏:歌詞行通常比你想像中還要快。
1. 先寫故事板,再寫程式
在專案中建立 STORYBOARD.md(格式請參閱指南:一句話梗概、世界與色調弧線、主題、角色情感弧線,然後是每個鏡頭及其 閱讀重點 —— 觀眾必須理解的時間點列表)。實作範例:examples/xiaozhen/(一個 31 秒的歌詞影片:包含故事板和完整的場景程式碼)。
在開始建置前,先向使用者展示故事板並讓他們提供意見,除非使用者說直接進行。
2. 逐鏡頭建置
- 在
src/config.js中設定duration、bpm、offset(以及audio)。 - 在
src/scenes/中,每個場景/章節建立一個 IIFE 包裹的檔案,結尾使用shots([[t0, fn], ...]);並將其<script>標籤加入studio.html。 - 先標記關鍵姿勢,以靜止幀檢查,然後再加入兩者之間的動作。
3. 渲染與檢視 —— 每個鏡頭都要檢查多次
你無法透過閱讀程式碼來看到動作。從專案目錄執行:
node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg # 關鍵幀
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg # 某個時刻的每一幀
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg # 全解析度細節
用「讀取」工具打開每張圖片,並根據指南的檢視清單實際檢查:事件是否清晰?角色是否夠大?閱讀重點是否安排好,讓初次觀看者能理解?是否有預期動作/跟隨動作?沒有跳幀?腳部和持握的道具有接觸地面/手部?每個接縫處都有轉場?沒有文字、3D、純黑/純白、或模糊的光暈?修正後再次檢查。預算:每個鏡頭至少 1 張聯繫表,每個關鍵動作和轉場至少 1 條連續幀條,每個承載故事的臉部至少 1 個局部裁切。
4. 渲染影片
node render.mjs --clip --out=out/video.mp4 # 短片,單一工作執行緒
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3] # 長片,並行 + 可中斷續傳
報告輸出路徑、長度及每幀毫秒數。提供 open out/video.mp4 的建議。
最重要的規則
以下是指南規則的摘要;指南本身是最終權威。
- 手工質感。 只能使用
paint()/inkLine()(p5.brush)—— 絕不使用一般的 p5rect/ellipse/fill。僅限平面 2D:轉向需透過繪製的關鍵視角(turn()、spinView()),絕不使用 3D 投影。透過glow()(加法混合)來表現光線,因為顏料混合會讓黃色加藍色變成綠色。 - 無文字。 沒有字幕、標籤、標誌或對話框;用畫面來表現。反應以繪畫表情符號表示(
!、汗水、愛心……)。唯一的例外是歌詞影片中的卡拉 OK 字幕,以及最多幾個大的音效文字。 - 每個鏡頭都有事情發生 —— 一個事件、因果關係、鋪陳與收尾。
- 為觀眾留時間。 列出每個鏡頭的閱讀重點;一次一個閱讀重點;動作快,意涵停留;引導視線;閱讀重點決定鏡頭長度。這是生成式動畫最容易失敗的地方。
- 保持生動。 沒有東西是靜止的(透過
feel()的閒置動作、飄移的鏡頭、沸騰效果);臉部透過emotions()變化,絕不透過交換圖片;角色要夠大(中景 u≈20–28,特寫 40–70);所有東西都要跟隨節奏。 - 每個接縫處都要有轉場,並選擇符合故事情境的轉場方式(筆刷擦拭、圓形/異形光圈、甩鏡、匹配剪輯、動作剪輯、鏡頭跟隨)。
- 單一作品。 一個世界、一條色彩弧線、一條情感主線、彼此連結的場景、一個與開頭呼應的結尾。
引擎注意事項
- 時間
t的純函數。 幀是並行且無序渲染的:不能在幀之間保留狀態、不能使用Math.random()、不能使用逐幀物理運算。使用hash(i)來獲得穩定的亂數,使用jit()來實現沸騰效果。 - 每個獨立的背景元素/道具前都要使用
boilSeed(key),否則一個移動中的物體會導致在其之後繪製的所有東西每一幀都重新沸騰(產生抖動)。 - 不要使用 p5 已定義的全域名稱。 p5 將
line、OVERLAY、text、color、scale等定義為全域變數;若頂層宣告function line()會失敗,出現Cannot redefine property,導致頁面永遠無法準備就緒(渲染器會超時)。請將輔助函式保留在場景的 IIFE 內部,或為它們取用不同的名稱。 - 門口、窗戶和螢幕的分層: 先繪製內部內容,然後將周圍的牆壁/框架重新繪製在上面,如此一來,開口以外的地方就不會顯示更寬的內容(例如火車的
inDoor加上門框、電視邊框元件)。 - 點列表中的
NaN會拋出Failed to construct 'OffscreenCanvas'錯誤 —— 請保護好退化的幾何形狀。 - 在鏡頭縮放 ≳ 2 倍時,巨大的形狀會失去輪廓線;輪廓線的粗細會隨縮放而變化,因此在特寫時需要調低
sw。 - 成本 = 填色和筆畫的數量。目標是 ≤ 約 1.5–2.5 秒/幀(日誌會輸出每幀毫秒數)。偏好更少、更大的形狀。在沒有真正 GPU 的機器上,水彩填色會很慢——考慮減少
fill形狀,或者作為最後手段使用--soft-gl。 - macOS:渲染器會使用
--use-angle=metal並自動在/Applications/Google Chrome.app尋找 Chrome;否則請傳入--chrome=<路徑>。
改編指南
- Clawd 是預設主角,但非必須。新的角色、道具和情緒使用相同的工具(
paint、ribbon、through、glow)繪製,並在跨鏡頭時保持角色模型一致;新的情緒請加入src/clawd.js的EMO物件中。 src/karaoke.js(在範本中)透過core.js中的window.overlayHook鉤子為歌詞影片提供逐字卡拉 OK 功能。LOOPS.name = t => {...}; LOOPS.name.len = 4;+node render.mjs --loop=name --png可用於製作無縫循環,供 GIF 使用(ffmpeg -i out/loop_name/f%04d.png …)。- 使用較高的推理努力程度通常會產生更華麗、細節更豐富的場景。