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。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 26.6 KB |
| cel.md | markdown | 9.8 KB |
| crayon.md | markdown | 10.5 KB |
| directing.md | markdown | 12.5 KB |
| doodle.md | markdown | 13.3 KB |
| explainer.md | markdown | 9.4 KB |
| fluid.md | markdown | 9.2 KB |
| montage.md | markdown | 6.4 KB |
| music.md | markdown | 14.0 KB |
| mv-workflow.md | markdown | 14.3 KB |
| piying.md | markdown | 9.4 KB |
| prints.md | markdown | 6.5 KB |
| sand.md | markdown | 10.2 KB |
| toon.md | markdown | 9.3 KB |
| wushan.md | markdown | 22.6 KB |
| zoumadeng.md | markdown | 9.2 KB |
toon.md
View on GitHub# 90 年代美式动画片头:粗描边平涂、定格大头照、串台换画风
范例是 56 秒、17 个镜头的原创片头《乱跑三人组》:斑仔的红帽子被风吹走,三个人一路追,追进一面电视墙,一个台换一种画风,最后片名砸下来。画面、角色设定和自写的主题曲都在 `toon-kit/`。
角色是重新设计的,三个人的体型分别是圆、梨形、细长条:豆豆(人类女孩,冲天马尾,黄卫衣)、斑仔(浣熊,反戴红帽)、阿飞(瘦高少年,橙色刺头)。
## 什么时候用这套
- 要卡通片头、美式动画、Cartoon Network 或 Nickelodeon 那种味道;
- 几个角色挨个亮相、追逐打闹、片名砸下来;
- 复古卡通广告也能直接复用这套角色和引擎。
引擎沿用赛璐珞的 `cel.js`:纯 2D canvas,帧是 t 的纯函数。实测每帧 5–220 ms,后处理换画风的镜头最慢;全片 1344 帧四路并行约 3 分钟,配乐离线导出不到 1 分钟(采样已缓存时)。
## 文件
| 文件 | 内容 |
|---|---|
| `src/toon.js` | 角色骨架:粗外轮廓细内线、三指手套手、角度驱动的四肢、表情 |
| `src/scenes/design.js` | 三个角色的设定;`--loop=sheet`、`runs`、`faces`、`hands` 是人设图、跑姿、表情表、手势表 |
| `src/scenes/motion.js` | 跑步循环和起跳(`--loop=motion`) |
| `src/scenes/lib.js` | 红帽子、雪花屏、贴纸描边、定格卡、镜头系统、画风后处理 |
| `src/scenes/street.js` | 街景布景 |
| `src/scenes/shots_a.js` / `channels.js` / `shots_b.js` | 第 1–6 镜、7–11 镜(四个台)、12–17 镜 |
| `STORYBOARD.md` | 分镜,带每镜的运镜表 |
| `music/score.js` | 主题曲 |
用法:`npm run sheet` 出联系表,`npm run cast` 出人设图,`npm run audio` 导出配乐,`npm run video` 出整片。配乐的鼓是 DRSKit 真鼓,下载和整理方法跟 `fluid-kit` 一样(`python -I tools/drs_build.py <解压目录> samples/drs`),只看画面不用下。
## 角色:先打样,打回三次才定
人设一定先出设定图让用户挑,别直接开拍。打样时翻过的车:
1. **「有点丑」**:第一版只有平涂。补上这些才过:
- 线条分粗细:外轮廓 `OLW=.15` 单位,五官、衣褶用细线 `INL=.075`;
- 眼睛加黑瞳和高光,脸上加腮红、雀斑;
- 每个角色一个带性格的站姿(举拳、招手、插兜);
- 三人体型分开(圆、梨形、细长条),站在一起剪影就不一样。
2. **「手和手臂分开了」**:手要和前臂一笔接上。先把整条胳膊描黑边,再画手,最后补胳膊的颜色,接缝就被盖住了。
3. **「手就一个圆,太乖」**:改成 90 年代经典的三指加拇指,每根手指是一段圆头粗线。所有手指和手掌**先统一描边、再统一填色**,整只手就是一个干净的剪影。手画大一点,描边比身体细一档。手势五种:`open`、`wave`、`fist`(带指节)、`point`、`grab`。
4. **「腿太短」**:男孩的比例对,女孩和动物的腿要拉长(豆豆 2.9→3.7,斑仔 1.9→2.9 单位),短裤改短、衣服下摆往上收。
5. **侧脸怪**:侧脸不能只把正脸的五官平移。要单独画一个侧面头型(额头、鼻尖、下巴的起伏),刘海往上收,远侧那只眼睛收窄,放在脸的轮廓里面。
骨架约定(`toon.js`):
- 四肢用角度驱动:`legN/legF/armN/armF = [大臂角, 小臂角]`,单位是度,从竖直向下量起。正面视图里正角度往外张,侧面视图里朝前。
- `toon()` 画完会把手、胯、头的世界坐标记在 `C.last` 里,道具从这里取(梳子拿在手上就靠它)。
- 表情走全局 `FACE.expr`:眼睛(吃惊时瞳孔缩小,生气时眼皮斜,大笑时眯成弧)、眉毛(绕自身中心转)、嘴型一起变。眼罩是黑色的角色(浣熊),闭眼的弧线要改成浅色,否则看不见。
- 🔴 **`lerp` 只能算单个数。** 拿坐标点去插值会得到 NaN,而且不报错,只是那一笔不见了(插兜的胳膊、袜子上的杠就这样丢过)。坐标点用 `lp()`。
- 🔴 局部变量别叫 `pop`,会盖掉全局的 `pop()`,渲染直接崩。
## 动作
- **跑步**:腿的角度按相位算,身体高度由「最低那只脚刚好踩地」反算(`footPlant`)。鞋子倾斜后脚尖会往下戳,也要算进去,否则会陷进地里。换脚的瞬间加一点腾空,否则看着像快走。
- **按世界位移推进步态**:`ph = x / 步长`,脚就钉在地上,不管跑多快都不会滑。
- **起跳**分五个关键帧:下蹲蓄力 → 蹬地时身体拉长 → 空中收腿 → 伸腿下落 → 落地压扁。压扁拉长以脚下为原点缩放,体积大致守恒。
- 跳起来时手别挡住脸:一只手往后甩,一只手往前上方举。
## 定格大头照(这一套的招牌)
`L.freeze(lt, f0, scene, hero, o)`:
- 动作做到最高点时停住(`actionT` 把时间冻住),镜头往里推,画面换成这个人的代表色,加放射线和网点;
- 人物用 `L.sticker` 加白边和投影,像一张贴纸;
- 名字用立体块状字弹跳着落进来;
- 停 1.6 秒(一小节),然后卡片沿斜线被撕走,露出接着动的画面。
要点:
- **一定要推到角色身上放大**(`fx/fy/zoom`)。第一版用的是原镜头,人物太小,不像大头照。
- 定格的那一帧压在重拍上,配乐给每个人一件自己的乐器(大号、萨克斯、小号)。
- 🔴 名字下面的色带用 `rect()` 画时会把透明度重置成 1,弹出的头两帧会闪一条空色带。透明度要显式传进去。
## 运镜(最容易被忽略,也最重要)
镜头系统在 `lib.js`:
- `L.keys(lt, [[t, cx, cy, z, rot, 缓动]])`:关键帧。缓动可选 `over`,急停时冲过头一点再弹回,像手持摄影师跟不上;
- `L.shake(lt, [[t0, 幅度, 时长]])`:按时间衰减的抖动;
- `L.autoSmear`:相机速度超过每秒 1500 像素时,把整帧沿运动方向抹开,再加速度线。抹的长度要封顶(240 像素),复制份数多一点(12 份),否则拖影会一格一格的。
规矩:
- 镜头永远有目的:推是强调,拉是交代,跟是速度,甩是接下一镜;
- 追逐时镜头跑在人前面;
- 甩镜、猛推只有零点几秒,之后一定接一段稳的;
- 撞击就抖,抖完就停;
- 上一镜往哪边甩,下一镜就从那边甩进来。
每一镜的运镜写进分镜表,单独一列。
## 串台换画风:整层后处理
画风不重画角色,而是整帧画完以后统一改。四个台复用同一套角色:
| 台 | 做法(`lib.js`) | 换场 |
|---|---|---|
| 黑白橡皮管 | `L.layer` 画进离屏层,`grayscale + contrast` 贴回,加画面晃动、闪烁、`L.film` 颗粒划痕暗角;帽子在滤镜之后画,保持红色;树和云跟着节拍伸缩 | `L.iris` 光圈收到帽子上 |
| 漫画 | 一格一格进场(滑进 0.14 秒),网点 `L.dots`,速度线,角色层再叠一层青色错位做套色不准 | 撞穿边框,反相一帧 |
| 设定稿 | `L.toLine`:深色描边转白线,其余变成淡蓝,帽子保留红色;左边一截保留原色,像正在上色 | 跑到纸边掉下去,画面渐渐像素化 |
| 8-bit | `L.pixel`:缩小再放大加减色;镜头按 8 像素一格卷动;人物要缩小(`U=32`),否则比砖块大太多 | 钻进发光的屏幕,白光吞掉画面 |
- 换画风要有剧情上的理由:帽子钻进电视,三个人跟着跳进去,一台一种画风。
- 画面里不出现现有作品的角色、标志和认得出的关卡(水管、旗杆这类)。
## 片名
- 立体字,每个字一个颜色、各自歪一点,弹跳着出现;
- 背后要有一块深色的锯齿爆炸星托底。第一版是浅色字压在黄色星上,读不出来;
- 片名砸下来时整个画面抖,每弹一下抖小一点,第二次落下顺手把帽子砸飞(呼应开头)。
## 配乐(`music/score.js`)
- 150 BPM,F 大调,冲浪摇滚加铜管,全部真采样:nbrosowsky 的 bass-electric、guitar-electric、trumpet、trombone、tuba、saxophone、clarinet、piano、xylophone;GM 的拨弦、颤音弦乐、方波、定音鼓、orchestra hit、钟琴、反向镲;DRSKit 真鼓。
- 画面事件全部按拍写:一拍 0.4 秒,定格、撞击、片名落地都压在拍子上。
- 四个台的配器跟着换:拉格泰姆钢琴加单簧管、大乐队铜管加摇摆镲、拨弦加木琴、芯片方波。
- 叹气用长号「哇哇哇哇——」,帽子扣到头上用钟琴「叮」。
- 坑:
- 采样文件名先用 `gh api repos/nbrosowsky/tonejs-instruments/git/trees/master?recursive=1` 列一遍再填。tuba 没有 D2,bass-electric 的 Cs3 在 jsDelivr 上返回 403;
- 音名里的升号要写成 `#`,`Fs1` 会让 Tone 报「No available buffers for note: NaN」;
- GM 的方波和拨弦采样本身很轻,要加 10 dB 以上。每段都要量一下 RMS,段与段之间的落差别超过 6–7 dB;
- 总线上的 Limiter 不前瞻,峰值会超过 1。在它前面压 4 dB,限幅设在 -3。
## 收尾
结尾别对着片名空等。三人跑出画面后,帽子被风吹回来,他们掉头再追,最后一声「哒哒!」时整个画面定格,和开头的定格大头照首尾呼应。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |