用途:以纯代码方式制作短片卡通/音乐视频,来源于 JohnHeibel/PDoomVideo 与通用套件 ClaudeAnimationBase(MIT),模板随包提供。
主要能力与工作方式:每帧是时间 t 的纯函数;studio.html 加载 p5.js + p5.brush 与场景文件,每个镜头用水彩填充和“沸腾”墨线绘制整个 1920×1080 画面;render.mjs 驱动无头 Chrome 渲染胶片(contact sheet)用于检查,或并行渲染每帧,再由 ffmpeg 编码为 MP4(可带音频)。
使用方式:先用 bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir> 搭建项目(--keep-demo 保留示例场景),随后完整阅读 ANIMATION_GUIDE.md 与模型表 docs/emotions.jpg、docs/views.jpg;超过约 20 秒或音乐视频需读 references/music-video.md,歌词视频先要歌曲与 LRC 并用 scripts/beat_grid.py 测速。先写 STORYBOARD.md 并让用户确认,再逐镜头开发:在 src/config.js 设时长、bpm、offset;每场景一个 IIFE 文件放 src/scenes/,以 shots([[t0, fn], ...]) 收尾并加入 studio.html;先做关键姿势再补中间运动。检查命令示例:node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg、--strip=2.1:2.6、--crop=760,420,500,400。输出:短视频用 node render.mjs --clip --out=out/video.mp4,长视频用 --frames --workers=4 后 --encode(可 --audio)。
限制与注意事项:只用 paint()/inkLine(),禁止普通 p5 rect/ellipse/fill;仅平面 2D,不做 3D 投影;无文字(歌词视频卡拉OK 与少量大 SFX 除外);每镜头需有事件、按节拍、注意视线引导与转场;帧需为 t 的纯函数,不能有跨帧状态或用 Math.random(),用 hash(i)、jit()、boilSeed();避免以 p5 全局名命名;成本按填充/描边数量计,目标约 ≤1.5–2.5 秒/帧;无真实 GPU 时水彩较慢;macOS 自动用 --use-angle=metal 查找 Chrome,否则需 --chrome=<path>。具体收费、平台、效果等资料暂未提供。