用途 paper-cutout 用于以编程方式制作剪纸 / 定格动画风格的视频(MP4)。画面模拟手工纸艺:手工纸、卡纸、牛皮纸、毛毡和薄纸碎片,配剪刀裁切边缘,形成逐格动画的观感。
主要能力
- 运行时结构:studio.html 加载共享运行时 src/kit.js(时间线、运动辅助、镜头、渲染钩子)、src/cutout.js(材质、裁剪/撕边碎片、阴影、布景、道具、转场、字幕、成片质感)、src/cast.js(木偶角色),每个镜头一个场景文件。render.mjs 驱动无头 Chrome 生成联系表、条带、裁剪图和最终帧。
- 造型与材质:通过 piece() 与形状辅助函数绘制,材质可选 paper、card、kraft、felt、tissue、corr、wood;提供椭圆、矩形、多边形、云、叶、心、星、水滴等形状,以及剪裁、变换、图钉、线绳、弹出等元素。
- 镜头与布景:paperCam 支持平滑或步进式运镜;backdrop、layer 实现屏幕固定纸片与视差深度;提供山丘、草地、树、云、太阳、房子、彩旗、条纹、纸屑等布景与道具。
- 转场:提供翻书、撕开、翻卡、滑片四种转场,在镜头接缝处使用。
- 角色:pom 与 lulu 两个木偶,含手、肘、肩、脚、头等关节点,支持 13 种表情、情绪切换通过 moods() 实现,还支持眨眼、行走循环、跳跃姿态和表情符号。
- 字幕:captionTrack 叠加字幕,中文字体回退为 Chiron GoRound TC → Zen Maru Gothic → Noto Sans TC,字幕尺寸建议不小于 70px。
- 渲染:支持生成联系表、运动条带、面部和手部裁剪检查,以及多进程逐帧渲染后编码为 MP4,可附加音频。
使用方式
- 用脚手架脚本创建项目:bash .claude/skills/paper-cutout/scripts/new_project.sh <project-dir>,加 --keep-demo 保留示例。
- 通读 GUIDE.md,查看 docs/demo-sheet.jpg、docs/expressions.jpg(13 种表情 × 两个木偶)和 docs/poses.jpg。
- 先做分镜(读者在何时需要理解什么),遵循“一次一个信息点”“预期→动作→跟随”和接缝处转场的规则。
- 在 src/scenes/ 中每个镜头建一个 IIFE 文件,结尾调用 shots([[t0, fn]]),并在 studio.html 中 cast.js 之后加入 script;在 src/config.js 设置时长;镜头起点取 1/12 秒的倍数。
- 检查造型:node render.mjs --sheet=... --cols=4 --w=480 --out=out/check/a.jpg,用 --strip=a:b 看运动、--crop / --crop-at 看面部和手部;逐张查看后修正再渲染。
- 最终渲染:node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=...]。
核心规则
- 一切皆为纸:场景中只用 piece() 与辅助函数绘制,不用原生 fillRect/arc;每个物体选定材质,风景和标签用撕边,角色和道具用剪刀边。
- 深度即阴影:背景层 depth 0.3–0.8,布景约 1,木偶 1–1.3,悬浮或举起物 1.5–3;用 layer(k) 做视差,不做伪 3D。
- 定格节奏:姿态用 sm(lt) 驱动(每秒 12 步);木偶每步自带轻微抖动,布景固定(jit: 0);运镜可平滑或步进。
- 表情替换:用 moods() 切换表情,并借助眨眼掩盖切换,而不是逐帧翻转脸。
- 接缝转场只用四种之一;下一镜头使用转场时,上一镜头不得自行绘制出转场。
- 手机尺寸可读性:中景中 pom 的 u ≥ 55、lulu 的 u ≥ 36,字幕 ≥ 70px。
- 纯函数:不得使用 Math.random(),帧间不保留状态,使用 hash/rnd/sway(key)。
- piece() 按形状键 + 种子缓存轮廓;不同碎片应使用不同种子。
- 轮廓依赖形状尺寸,动画改尺寸会导致逐帧重裁、边缘闪烁;应改用 sx/sy 或镜头缩放。
- prevFrame() 以当前时间渲染上一镜头并交换 G;场景必须使用 G 而非捕获的上下文。
- 被翻转木偶手中的道具会自动反镜像,保证文字和非对称道具可读。
- 性能:每帧绘制约 5–30ms,1920×1080、4 进程含 JPEG 编码时约 130ms/帧。
适用场景 适合需要手工剪纸定格观感的短片、演示、说明性动画和社交媒体视频,尤其是希望以代码精确控制构图、节奏与角色表演的创作。
限制 该工具是代码驱动的制作流程,需要编写 JavaScript 场景脚本并理解其渲染管线;无图形化时间线编辑界面。具体收费、平台支持范围与商业授权信息暂未提供。