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

zoumadeng.md

View on GitHub
# 走马灯:纸雕灯里的多层剪纸,烛光透过来

范例是 2 分 34 秒的《一圈》。纸骑手在灯里追一只发光的鹿,追了四季都没追上;烛火将尽时他停下回头,鹿从身后走了回来。配乐是代码写的 3/4 圆舞曲。画面、乐谱和混音配置都在 `zoumadeng-kit/`:

| 文件 | 内容 |
|---|---|
| `src/deng.js` | 引擎 |
| `src/cast.js` | 马、骑手、鹿、下马的人 |
| `src/scenes/world.js` | 四季 |
| `src/scenes/room.js` | 灯外的屋子和灯壁 |
| `src/scenes/film.js` | 全片时间线 |
| `src/tempo.js` | 画面和配乐共用的小节表 |
| `music/` | 乐谱、分轨导出、混音配置 |
| `tools/mixdesk.py` | 混音台 |
| `STORYBOARD.md` | 分镜 |

```bash
cd zoumadeng-kit
npm install
npm run sheet      # 10 个时刻的联系表
npm run stems      # 六组干声 → out/music/stems/(第一次要联网下 Tone.js 和 VSCO2 采样)
npm run mix        # 混音 → out/music/yiquan.wav(要 Python 3、numpy、scipy)
npm run video      # 渲全片并合成
```

## 什么时候用这套

- 要光影、灯、剪纸、纸雕、民俗的温暖感,又不想做皮影那种「侧身戏台」的表演。
- 适合「绕圈」的故事:轮回、追逐、四季、等待。走马灯本身就是一个圈,这是这套画风天然带的隐喻。
- 纯 2D canvas,不用 p5.brush。帧是 t 的纯函数,可以四路并行。实测每帧 3–20 ms,2:34 全片 3703 帧四路并行约 5 分钟。

## 引擎原理(`deng.js`)

照真的纸雕灯画:背后一团烛光,前面一层层剪纸。

1. **底光** `backlight()`:以火苗为圆心的径向渐变,从火心到最外六个色(`LAMP.pal`)。每一季换一套底光色,这是换色调的主要手段。`LAMP.glow` 控制亮度,`LAMP.flash` 加闪电。
2. **一层纸** `layer(k, blur, draw, o)`:
   1. 先把已经画好的光整体糊一下(`blur`)。层与层之间有空隙,光会散开,所以越远的层越虚、越亮。
   2. 这层纸单独画在草稿层上,贴纸纤维纹理(纹理跟着纸走,不会在纸上游泳)。
   3. 用 `multiply` 乘到光上:纸挡光,彩色玻璃纸只透自己的颜色。
   4. `rim` 给纸的上沿加一线朝火的亮边。
   - `k` 是这层跟着转的快慢:角色层 1,远山 0.08–0.26,前景 1.7。视差就是这么来的。
3. **自己发光的东西** `glow(k, draw, o)`:画完用 `lighter` 加到光上,带外晕(`halo`)。发光的鹿、雪、雨丝、闪电都走这个。全片只有这些东西是「亮的纸」,其余全是「挡光的纸」,主角一眼就能找到。
4. **卷成圆柱** `wrap()`:所有层都画在一张展开的平面上,最后按竖条卷到画面上:中间宽、两边压扁,两侧竖向略缩(`PERSP`),两侧再压暗(`edgeShade`)。这一步让它像在「灯里」,而不是在「幕布上」。
5. **最后一道** `finish()`:辉光、暗角、胶片颗粒、闪白、黑场。
6. **镜头** `LAMP.cam = {z, x, y}`:绕火苗缩放。远层放大得少、近层放大得多,推镜也有纵深。

## 灯外和灯里接上(`room.js`)

- 灯壁和灯里用同一张展开平面、同一个卷法。灯外只是把平面缩小画(参数 `e`),圆柱半径也小(`RS = 175`)。镜头推到 `ZMAX = RC / RS` 倍时,灯壁在画面上和灯里的镜头完全重合,可以直接化过去,中间不断。
- 灯壁上的影子是同一套角色,用平涂色画、加模糊。背面那半圈隔着火淡淡透过来、往反方向走,这是真走马灯的样子。
- 灯外影子太小时读不出,推近前先按比例放大(`ms`),推到贴壁时回到 1。
- 墙上的投影:把灯里的整幅平面糊一下、提对比度和饱和度,用 `screen` 叠到屋子的墙上。高潮拉出灯外时用它,整间屋子被灯里的世界照满。
- 屋子是冷色(夜蓝的窗、深色家具),灯是暖的。家具朝灯的那一侧描一线暖边。

## 角色(`cast.js`)

- 马和鹿共用一副四足骨架,全是「由粗到细的胶囊」拼的剪影。步态用首尾相接的关键帧循环 `cyc()`:`gallop` 奔跑、`bound` 鹿的蹿跳、`walk` 慢步。
- 参数:
  - `go` 从 1 到 0 是从跑到站;
  - `air` 是腾空,前腿探出、后腿蹬直;
  - `back` 是回头;
  - `head`、`neck` 是低头。
- 剪纸感靠**镂空**:`hole()` 用 `destination-out`,刻出马身上的卷云月牙、鹿的梅花点、披风上的两道刻线。没有镂空就是一团黑影。
- 骑手的朱红披风是全片的「一点红」,换季也不换色。
- `man()` 是下了马的人,返回手的世界坐标,用来接触其他东西。

## 色调:别单调,也别一直变

- **一季一套色**,每套是底光六色加纸六色(从远到近),写在 `SEASON` 里:
  - 春:桃粉、柳绿;
  - 夏:青绿;
  - 雷雨:靛蓝、闪电白;
  - 秋:朱红、金、紫;
  - 冬:靛蓝、银白。
- 换季用 `mixPal` 在一两小节里化开,或者用事件砸过去(第三道闪电打白,直接换成秋)。
- 色弧要有形状:
  1. 暖;
  2. 冷到底,冬天只剩一豆暖火;
  3. 一下子金白,是全片最亮的地方;
  4. 四季的颜色两小节一换;
  5. 回到屋里,窗外天亮。
- 灯外的屋子始终是冷色,衬灯的暖。

## 故事怎么撑起来

- 让主角之外的东西**承担意义**:鹿是唯一发光的纸,它就是那点火。它走远火就小,它回来碰手,烛芯就蹿高。
- 每一季至少一个**只能在这里发生**的事件:
  - 春天伸手够;
  - 夏天雷雨;
  - 秋天断崖腾空,腾空那一帧压在烛火上,是全片的海报帧;
  - 冬天下马。
- 先埋再收:秋天他回头时,远处另一侧有一只淡淡的鹿影往反方向走,后面「从身后回来」才不突兀。
- 失去一个东西表示变化:落地时斗笠被风掀走,之后一直散着发带。
- 结尾和开头是同一个机位,最后一眼灯壁上两个影子挨在一起。用小节表反解尾声的转速,让最后那一刻正好转到正面(`film.js` 里的 `SLOW`)。

## 时间表和配乐

- `tempo.js` 按段写「几小节、起止速度」,段内速度线性变化:火旺时转得快,冬天越来越慢,停住,回来时渐快。`barT(小节, 拍)` 和 `barAt(秒)` 可以互查。
- **画面和乐谱都只按小节写,不写秒**。闪电、腾空、碰手、换季都落在拍上。配乐改了速度,画面自己跟着走。
- 乐谱 `music/score.js` 不用走带,每个音直接排在离线上下文的绝对秒数上(由 `barT` 算),变速就不用操心 `rampTo`。
- 配乐的段落顺序:
  1. 八音盒引子;
  2. 嘭恰恰:大提琴拨低音,中提琴拨和弦;
  3. 主题,独奏小提琴;
  4. 第二遍加弦乐组,单簧管和旋律对答;
  5. 雷雨:转 b 小调,震音、定音鼓;
  6. 秋天:大提琴跳弓八分音符;
  7. 冬天:只剩钢琴和大提琴;
  8. 空五度;
  9. 八音盒把第一句弹回来,长渐强;
  10. 升全音到 E 大调全奏;
  11. 八音盒原样收尾,停在加九和弦上。
- 这些 VSCO2 乐器的**文件名都比实际低一个八度**,`render-audio.mjs --calib` 用自相关量过:单簧管 susLong、长笛 susvib、大提琴 pizzT 和 spic、中提琴 pizz 和 spic、小提琴组 Pizz。
- 出声:`npm run stems` 出六组干声(keys / perc / solo / strings / pizz / winds),`npm run mix` 进混音台。
  - 厅堂混响:原片用的是 Bricasti M7「Concert Hall」脉冲响应(Samplicity 的免费库)。自己下载后用环境变量 `HALL_IR` 指过去;不给就用混音台算出来的 2.6 秒混响。
  - 弦乐组 v1 力度层本身极轻,分轨里比独奏小提琴低十几 dB,混音时要 +24 dB 才平衡。**先按段落量每组 RMS 再定增益**,别靠猜。
  - 混音配置里的 `rel` 直接写各段目标相对响度(LU),不需要参考版。《一圈》各段:
    - 引子 −1.5、灯壁 0、春 +2、夏 +4、秋 +5.5;
    - 冬 −3.5、停住 −9、回来 +0.5、高潮 +8、尾声 −3。
  - 成品 −15.8 LUFS,峰值 −1.5 dBTP。

## 已知毛病

- 马奔跑时前腿收起的那几帧形状乱,像一团。
- 骑手在慢步的马上时,披风垂下来像搭在马背上的一块布。
- 断崖读起来像一道沟,不够深。
- 灯外的屋子偏平,家具都是正面平涂,没有体积。

## 踩过的坑

- **前景大东西挡主角**:夏天的前景荷叶一开始太大,直接压在骑手身上。前景只放在画面最下沿,或者压低到只露一半。
- **下马的人和马叠成一团**:剪影同色,前后一叠就分不出来。人和马之间至少空出半个马身。
- **灯壁上的影子太小**:远景看灯时影子只有几十像素,什么都读不出。推镜前按比例放大。
- **鹿走回来和马头重叠**:发光的鹿压在黑马上,亮暗一叠反而糊。镜头要跟着把它们拉开。
- Windows 的 PowerShell 下,混音台的中文输出会乱码,先设 `$env:PYTHONIOENCODING='utf-8'`。
- 分轨渲染偶尔有一个 VSCO 文件拉取失败,Tone 会在 `page.evaluate` 里直接抛错,要接住再整次重试(`render-audio.mjs` 已经这样写)。
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