Skip to content

nzl153/paint-video-skill / paint-video

paint-video

Verified

用代码做手绘风格的动画短片:水彩、水墨用 p5.js + p5.brush,蜡笔绘本用自写的 2D canvas 蜡笔引擎,皮影用自写的皮影引擎,打斗用自写的设色水墨引擎;逐帧画,无头 Chrome 渲染,ffmpeg 合成 MP4。用户说「做个短片 / 动画 / MV / 开场动画 / 十几秒的视频」时用这份;配整首歌的长片或 MV 另看同目录的 mv-workflow.md,蜡笔画风看 crayon.md,皮影看 piying.md,打斗和雾山五行风看 wushan.md,科普讲解片(原理科普、HTML 演示 + 代码合成声效 + edge-tts 配音,允许字幕和标注)看 explainer.md。版画系列(孔版、铜版、大理石纹、蓝晒、网点、植物图版,SVG 生成,每段一种工艺)看 prints.md;音符驱动的流体彩墨 MV(WebGL 流体、抽象、不画人)看 fluid.md;沙画(灯箱上的沙底下透光、一幅抹成下一幅,WebGL 高度场)看 sand.md;作业本涂鸦(圆珠笔勾线 + 彩铅排线 + 手机俯拍的作业本,涂鸦小东西活过来,带实物笔和影子)看 doodle.md;共点蒙太奇(同一个形状始终落在画面同一点,快切或画风接力)看 montage.md;走马灯(纸雕灯里的多层剪纸被烛光透过、卷成圆柱转,灯外推进灯里,适合绕圈的故事)看 zoumadeng.md;赛璐珞动画质感(清晰清新、黄昏光、哑光陶土 Clawd、道具经手的叙事 MV、竖排纸条字幕)看 cel.md;90 年代美式动画片头(粗描边平涂、定格大头照、甩镜抖动拖影、串台换画风:黑白胶片、漫画、设定稿、8-bit)看 toon.md;要自己写配乐(Tone.js + 真乐器采样含 VSCO2 管弦乐和真鼓,离线导出,分轨加自写混音台,按拍对画面)看 music.md。

FileKindSize
SKILL.mdskill md26.6 KB
cel.mdmarkdown9.8 KB
crayon.mdmarkdown10.5 KB
directing.mdmarkdown12.5 KB
doodle.mdmarkdown13.3 KB
explainer.mdmarkdown9.4 KB
fluid.mdmarkdown9.2 KB
montage.mdmarkdown6.4 KB
music.mdmarkdown14.0 KB
mv-workflow.mdmarkdown14.3 KB
piying.mdmarkdown9.4 KB
prints.mdmarkdown6.5 KB
sand.mdmarkdown10.2 KB
toon.mdmarkdown9.3 KB
wushan.mdmarkdown22.6 KB
zoumadeng.mdmarkdown9.2 KB
# 赛璐珞:清晰的动画质感,黄昏光,哑光陶土角色

范例是 4 分 16 秒的叙事 MV《八音盒纸带》:修八音盒的他每为她心动一次,就在空白纸带上打一个孔;她坐火车走了,冬天他把整卷纸带摇完,大半是空白。整片的画面代码都在 `cel-kit/`。原片配的是一首有版权的流行歌,仓库里不带音频和歌词,字幕放的是自己写的示例词;没有音轨照样能渲出完整的无声版。

这套画风是在两次失败之后才做成的,失败的原因比做法更值得读:
- 第一版像 PPT:一个正面机位撑了十几个镜头;
- 道具不经手就自己飞;
- 布景只有几块色块;
- 剧情是常见桥段。

下面的规矩大多是从这几条反过来定的。

## 什么时候用这套

- 要「清晰」「动画感」「清新」,不要纸纹颗粒。这套是干净的色线、平涂、一档硬阴影加轮廓光。
- 适合有地点、有道具、有人物关系的叙事短片和 MV。
- 纯 2D canvas,帧是 t 的纯函数,可以四路并行。实测每帧约 25 ms,4:16 全片 6144 帧四路并行约 10 分钟。

## 文件

| 文件 | 内容 |
|---|---|
| `src/cel.js` | 引擎:路径、`cel()` 上色、`soft()` 柔化层、`glow()`、镜头、bloom、调色钩子 |
| `src/clawd_cel.js` | Clawd 角色:四个视角、表情、围巾和毛线帽,返回手和耳朵的世界坐标 |
| `src/world.js` | 天、云、树冠、树枝 |
| `src/scenes/base.js` | 转场、雪、飘落物、烟火 |
| `src/scenes/pb_lib.js` | 纸带、八音盒、打孔器、剪刀、伞、手臂 IK、飘进打孔器的光、回忆泡泡、车票 |
| `src/scenes/pb_look.js` | 质感层:黄昏调色、光柱、窗格光斑、投影、浮尘、木纹、墙纸、旧痕 |
| `src/scenes/pb_shop.js` | 店里(正面大全景)、工作台、台灯、窗外街景 |
| `src/scenes/pb_out.js` | 外景:街口、电车、车厢、电车站、湖边烟火节和冬湖、火车站台 |
| `src/scenes/pb_1.js` ~ `pb_4.js` | 42 个镜头 |
| `src/scenes/pb_subs.js` | 竖排纸条字幕 |
| `src/scenes/pb_timeline.js` | 镜头时间表 |
| `tools/lrc.mjs` | 把 LRC 歌词转成字幕数据 |
| `STORYBOARD.md` | 逐镜分镜 |

```bash
cd cel-kit
npm install
npm run sheet                      # 12 个时刻的联系表
node render.mjs --loop=pbsets --sheet=0.5,1.5,2.5,3.5,4.5,5.5,6.5,7.5,8.5 --cols=3 --w=640 --out=out/check/sets.jpg   # 布景样张
npm run lyrics                     # 换成自己的 lyrics.lrc
npm run video                      # 渲全片(无声)
```

要配原曲:自己准备音频,渲完后用 ffmpeg 把画面和音轨合在一起(`--encode --audio=歌.wav`),节拍在 `src/config.js` 里改。

## 引擎(`cel.js`)

- 世界坐标按 1920×1080 写,`cam(cx, cy, z)` 把世界点 (cx, cy) 放到画面中心并放大 z 倍。
- `cel(path, {base, shade, L, line, lw, rim})`:底色,加上把形状朝背光方向平移得到的一档阴影,再加色线和轮廓光。
- `soft(fn, blur, a, comp)`:画进草稿层后整体模糊再贴回来,用于景深、体积光、虚影。
  - **必须可重入**。只有一张草稿层时,嵌套调用会互相清空,症状是背景全黑。这里按深度取一个 canvas 池。
- `GRADE` 钩子在 bloom 之后跑,用于调色和字幕。

## 黄昏质感(`pb_look.js`)

只有平涂色块的布景看起来简陋。下面这几层叠上去,才有质感:

- **整片调色** `duskGrade(k, cool)`:用 soft-light 叠一层上冷下暖的渐变,再用 multiply 压暗角。`cool` 从 0 到 1 推向蓝夜。
- **光**:
  - 太阳低低地从一侧照进来,窗格光斑用 `paneLight` 投到地板和墙上;
  - 体积光柱用 `beam`,光柱里有浮尘 `motes`;
  - 地上拉出长影子,用 `longShadow` 或 `shadowShape`。
- **材质**:木纹 `woodGrain`、碎花墙纸 `wallpaper`、墙面旧痕 `grime`、砖缝、方砖、窗帘褶。
- **天**:
  - 用 `duskSky` 画上紫蓝下橙的渐变;
  - 云用 `streakCloud` 画成条状晚霞:暗紫的云身,底边被落日烧亮。
  - 积雨云堆在黄昏天上,像一座粉色的山。
- **楼**:`building()` 带窗帘、阳台、空调外机、花箱,受光一侧有亮边,远处的楼往天色靠,做出空气透视。
- **夜里**用 `dark` 参数:整体压向深蓝,只留台灯一团暖光;关灯后换月光。
- **布景先打样**:先把最常用的那一处做到满意,再用同样的标准做其他地点。

## 角色(`clawd_cel.js`)

- 他是陶土橘,她是雾蓝,戴一朵小白花发夹,有睫毛。另有一个路人色 `other`。
- 坐标约定:(x, y) 是脚下的地面点,身体占 -5u..5u × -8u..-2u。
- 视角有四个:`front`、`q`(3/4)、`side`、`back`。
- **材质要哑光陶土,不要塑料**。具体做法:
  - 不加顶部的白色高光条;
  - 明暗是柔和的线性过渡,阴影只留一档、而且是软边;
  - 身上加固定在身体坐标里的细颗粒(跟着身体走);
  - 底部压一点暗;
  - 受光一侧是一条柔和的暖光,不是一根亮线。
- **冬装**:`scarf` 是围巾,`hat` 是毛线帽,`pom` 是毛球颜色。
  - 帽子要小、要压住头顶:帽檐往下包住身体的顶边,不旋转,只让帽尖往一侧耷拉。
  - 帽子太大会像扣了个篮子;绕一个点转出来的歪戴,一侧会翘离头顶。

## 物理:道具一律经手,够不着就挪人

除了明确画成幻想的段落,所有东西都要符合现实和物理。

- **IK 工具**:
  - `armFor(view, which, u, gy, target)` 反算角色该站在哪、手臂该抬多少;
  - `handAt(...)` 正算手在哪里;
  - 道具的位置一律从手的坐标取,不要自己插值。
- **递东西**:先定接手人的手能够到的点,东西就放在那里;递的人把东西送到这一点,接触的那一帧之后,东西改跟接手人的手走。
- **Clawd 的胳膊很短**,手只够得到脚下往上 2.4u 到 6.6u 这一段:
  - 够不到地面,也够不到天花板;
  - 东西放在地上,就要放在台阶或踏板上;
  - 挂在高处,就要搭人字梯。
- **摇柄朝着摇的人**:用 `boxL` / `woodL` 把盒子镜像一下,别让手臂穿过盒子去够另一侧。
- **前后遮挡**:
  - 站在台子后面的人先画,再画台子;站在台子前面的人后画。
  - 手里举着的东西画在人之后,否则会被身体挡住。
  - 人站在码头上时,栏杆和灯笼柱要画在人之后(`lakeFront`)。
- **两手碰不到一起**:Clawd 的两只手分在身体两侧。打孔就让纸带平放在台面后沿上,一只手按住,另一只手打。
- **看不见的东西也要合理**:火车开出画面,要接着往岸上开、被楼挡住,不能在桥头凭空消失。人锁门走了,店和楼上的窗就得是暗的。
- **走路**:步子按走过的距离推进(`walkPh`),脚不打滑。下梯子一级一级下。

## 叙事:核心设定要用看得见的动作演出来

只写在分镜里的设定,观众看不到。这部片靠三处交代把它演出来:

1. **设定第一次出现时,用一个可见的动作把它连起来**:每次打孔,从她身上飘出一点暖光(`mote`),落进打孔器,孔亮一下,表示这个孔记下的是她。她不在时那一孔,光从空座位上飘过去,颜色发冷。
2. **关键信息用具体的道具交代,不靠表情**:她要走,就让她亮出一张画着火车的车票,再看向对岸开过的火车。只有一个「指」的动作,没人看得懂。
3. **结尾的领悟要可视化**:音梳每弹响一个孔,上方就浮出对应的那个瞬间(`memBubble`:笑、伞、台灯、烟火、空座位、雪)。一大段空白滑过去,什么都不浮出来。

另外两条:
- **动机先交代再行动**:火车站那段,他先在店里看一眼墙上的钟,再抓起盒子冲出门,然后才是站台。少了这一步,观众只会问他在干嘛。
- **伤感片也要有趣的小事**:打孔怕她看见,赶紧把打孔器藏到背后;伞斜过来遮住他;在冰湖上认错人。

## 字幕:竖排纸条(`pb_subs.js`)

- 每句按空格拆成几列,从右往左读。每列写在一条竖着的米色纸条上,纸条边上有一排打孔,和片里的纸带是同一种纸。
- 字用华文仿宋(STFangsong,没有时依次退到仿宋、楷体),62px,深褐色。出现时纸条一列一列展开。
- 白字配柔光太细,在亮背景上看不清;纸条压在什么背景上都看得清。
- 放左上还是右上,按每镜里人物的位置手动指定(`SUB_SIDE`)。一句歌词跨两镜时,用开唱后 0.3 秒的那一镜来判断。
- 显示时长取「到下一句开始」和「开唱后 5.6 秒」里较短的那个(`tools/lrc.mjs`)。

## 流程

1. **先定一个不落俗套的核心意象,再写剧情**。写完自问「观众能品出什么」,先给一句话梗概。
2. **地点要多,每镜都换景别和机位**:这部片用了 7 处地点、42 个镜头,平均每镜 6 秒。
3. **每写完一批镜头就出联系表自己看**:`--sheet` 看每镜的首、中、尾帧,`--strip` 看接触前后的连续帧,`--crop` 放大看手和道具。这部片自查抓到的问题:
   - 镊子没拿在手上;
   - 纸带横在脸前;
   - 人站在台子里面;
   - 光点投到了画面外;
   - 码头上的人被前景柱子挡住;
   - 背影看起来像一块砖(改成侧坐);
   - 认错的那个人太小看不清(加近景)。
4. **重渲用 `--force`**:旧帧会挪到 `out/frames_old_*`。

## 还能更好的

- 人群是同一个 Clawd 换色,看起来有点单调。
- 秋天的树冠 `clump` 是尖叶,在站台背景里有点像刺猬。
- 音梳特写里,簧片和孔的对位是示意性的,不是真的机械结构。
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall