Skip to content

nexu-io/open-design / skills/huashu-art-motion

huashu-art-motion

Verified

辅助艺术动画与解说任务:35 种艺术风格配方、9 种解说语法、分镜与确定性 Canvas 绘制工具。按宿主时间轴实现,素材与导出使用宿主能力。

FileKindSize
LICENSEother1.1 KB
SKILL.mdskill md5.5 KB
SOURCES.mdmarkdown1.0 KB
references/art-styles-1.mdmarkdown93.8 KB
references/art-styles-2.mdmarkdown52.8 KB
references/canvas-helpers.mdmarkdown81.9 KB
references/craft-workflow.mdmarkdown56.8 KB
references/explainer-grammars.mdmarkdown127.4 KB
references/index.mdmarkdown3.0 KB
references/license.mdmarkdown1.1 KB

references/art-styles-1.md

View on GitHub
# 艺术风格配方

> 上游工艺参考。原作者的样片耗时、质量指标与实验结论不是 Open Design 的验收结果。文中的上游工程路径和渲染命令用于解释原实现,不是本包可执行入口;实际工具、品牌和交付约定以 SKILL.md 为准。无需复现作者的画面、角色、字体或独立制作流程。


---

<a id="01_cave"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/01_cave.md

# 01_cave · 40,000 BC 洞穴岩画(纯代码)

文件:`scenes/01_cave.js`(约 330 行)。最终性能:warm max 22ms / mean 21.1ms,cold(建缓存)在引擎 boot 时完成;确定性通过;0.2↔0.7s 运动差分 3.9% 像素。

## 管线
1. **岩壁(全部缓存,`cave_relief`/`cave_bg`)**
   - 半分辨率 960×540 算高度场:`fbm(x·0.0022,4oct)·1.0 + fbm(x·0.011,3oct)·0.16 + noise(x·0.05)·0.03`(坐标用全分辨率像素)。
   - 有限差分×52 得法线,光源 L=(-0.55,-0.62,0.56)(左上),`shade = clamp(0.5+(dot-0.56)·0.9)`;底色在 `#ce925a`(亮赭)/`#6e4426`(暗)/`#b6643a`(红斑) 之间用两层低频 fbm 混,再 ×(0.72+shade·0.55)。放大到全屏用平滑插值 → 起伏柔和。
   - 叠两层 `P.grain`(暗 0.22 密度 α0.32、亮 0.10 α0.28)出颗粒;10 条随机游走裂缝(每步转角 ±0.45rad、步长 14–40px、12% 概率分叉),深线下面垫一条 +1.6px 偏移的亮线 → 刻痕感。
   - 暗角:径向渐变 r 260→1180,外圈 α0.8;中心静态暖光用 lighter(α0.36)只照亮岩壁。
   - **踩坑:relief 的中频项系数一大(0.35、×60 法线)整面墙就成了迷彩/沙丘,人物叠上贴图后像迷彩服**。中频降到 0.16、法线 ×52 后才像岩面。
2. **「颜料吃进岩石」**
   - 所有图形统一画法 `shape()`:先用 **fuzz 图案**(稀疏炭点,宽 2lw+7)描一遍 → 再用 **ink 图案**(炭黑、7% 随机孔洞 + 噪声 >0.58 处大孔,宽 2lw)描 → 最后平涂填色盖住内半圈。效果 = 实心炭线 + 喷点毛边,且 painter 顺序天然处理遮挡(手臂盖住外衣的线)。
   - 炭笔「沸腾」:两张 256 图案每 1/9 s 用 `pattern.setTransform` 随机平移一次,几何不动、颗粒在跳,比抖动路径省且不变形。
   - 整个颜料层画完后 `source-atop` 叠一张 `cave_figtex`:岩面阴影→黑 α(0.5-v)·150、亮处→暖白 α(v-0.5)·50、暗/亮颗粒、低频干湿斑 α≤70。**颜料层只有一次全屏合成**,所以 19ms。
   - 填色都是不透明平涂,颜色靠贴图「脏」掉;不要用 multiply 叠颜料——白垩(猫的白)会消失。
3. **负形手印/爪印**:320² 临时画布高斯喷点(σ46·s 3200 点 α0.15–0.6 + σ28 1400 点),再 `destination-out` 一张实心手形蒙版,最后蒙版 α0.3 填 `#f6e2bc`。**手形必须逐块 fill 到蒙版**:把手掌椭圆和手指胶囊 addPath 进一个 Path2D 一次 fill,子路径绕向相反处 nonzero 抵消,出现缺口(r4 踩到)。
4. **火光**:每帧一层径向渐变,中心 (1000+40·noise(t·3.1), 540+26·noise(t·2.3)),强度 `0.13+0.09·noise(t·8.5)+0.04·sin(21t)`,**用 overlay 合成**(α=强度×2.6)。外圈再叠一层随火光反向呼吸的暗角。踩坑:一开始用 lighter,少女的金发和兽皮被洗成粉白、失去赭石饱和度,改 overlay 后颜色回来了。
5. **余烬**:`P.particles` 三组(左 0–360 ×11、右 1540–1920 ×12、中间 ×5),y 从 1110 漂到 120,life 5.5s;亮核 r 2.2–4.6 + 3.2 倍光晕,`|sin(6t+1.9i)|` 闪烁,`sin(q·π)` 首尾淡入淡出,lighter 合成。

## 母题动画
- **野牛/马两张姿态**:`ph = floor(t·60/7)%2`(每 7 帧换),腿的终点两套坐标(伸展/收拢)、头绕颈点 ±0.07rad、整体 y 交替 -3/+1px;马与野牛反相。腿只用炭线(原片也是),身体是填色剪影 + 背脊一道 22px 深色晕染(拉斯科式明暗)。
- **端杯**:没用 RIG 的杯子轨迹(桌面→嘴,桌面点在少女胸前,不像原片「伸臂端在半空」)。自定:`hold=(1084,506)` → `mouth=HP(1224,380)`,进度 `k = choreo(max(0,lt-0.95)).cup`(choreo 曲线整体平移 0.95s,对上原片 58 帧起举杯),手臂用 `RIG.ik2(G.A.shoulder, cup+(34,10), 170,128,-1)`;`RIG.girl({cup:k})` 仍负责头部后仰与喝的微仰。k 在 lt≈1.85(T01 转场末)到 1。
- **热气**:三条炭线 `x0 + sin(13q − 11t + 1.3j)·6`,高 58px,跟杯走。
- **猫**:RIG.cat 的 head/eyes/nose/earInner/stripes/tailPts 锚点 + 自画梨形身体、白胸、白前腿、大腿弧线;尾巴 = fuzz/ink/橙三层描边 + 每 4 个采样点一道横纹;眨眼来自 choreo.blink。
- **猫的尺寸(复核返修)**:RIG.cat 原尺寸耳尖在 y≈535,顶进壁画框底边(550)。整只猫用画布变换以脚底 (540,905) 为锚缩 0.86(translate→scale→translate,RIG.cat 本身仍 s=1),耳尖落到 y≈582,与框底留出约 30px,脚底不动。线宽随之 ×0.86,看不出差别。
- **标题**:`Kalam-700` 78px letterSpacing 7,水平缩放到 930px 宽,`#9b2a18`,画进颜料层(同样吃岩面贴图)。α = t<0.933 ? 1 : 1-(t-0.933)/0.2。

## 运动量返修(复核口径:静止段帧 21–84,480×270 逐帧平均帧差)
复刻 0.62 vs 原片 0.86,偏静。只加局部动作,不靠全屏闪烁:
- 火光:强度 `0.14+0.11·noise(9.5t)+0.04·sin23t+0.03·sin37t`,中心游移 ±60/±36px(原 ±40/±26)。试过更大(±0.16、±90px)会冲到 1.22,画面发晃,回调。
- 余烬 28→49 颗(左 20、右 20、中 9),亮核 r 2.6–5.4,光晕 α0.32、3.6 倍,闪烁 `0.3+0.7|sin|`。
- 手印忽明忽暗:每个手印叠一块 r=105 的暖色径向渐变(lighter),α=0.2·clamp(0.5+0.9·noise(7t+3.7k)),各自独立相位。
- 野牛/马颠簸 ±3→上下 9px、左右 ±3px,头部摆 ±0.12rad。
- 猫头小动作(对原片 65–81 帧):lt 1.08–1.35 用 `sin(πq)` 包络,绕颈点 (596,680) 抬头转 −0.16rad,RIG.cat look 推 1.5,耳朵 60Hz 微抖 ±0.06rad。
- 结果:**0.62 → 1.06**(原片 0.86);每帧 max 22ms。

## 少女的时代化
红赭石 `#9c3520` 剪影(脸/颈/手臂/小腿),侧脸只留一只杏仁眼(米白眼白+黑瞳+一根睫毛,眨眼变弧线)——这一笔是「少女感」的关键;金发用黄赭 `#cf8f2c` 填 + 6 条 `#6e3c0e` 波浪发丝(振幅随长度增大),轮廓也是波浪;发丝下半段逐渐不跟头部旋转(HB 函数),避免喝水仰头时整片头发甩动。及膝兽皮外衣 = G.torso + 自画下摆(每 15px 一个 ±16px 锯齿毛边),`#b06a2c` + 26 个「圆斑+7 个小点」豹纹斑 + 18 道短毛线,接缝靠「先描两块的边再一起填」盖掉。

## 色板
墙 `#ce925a/#6e4426/#b6643a`;炭 `#21150d`;红赭 `#9c3520`/暗 `#74261a`;黄赭(猫)`#c9772f`;金发 `#cf8f2c`/`#6e3c0e`;兽皮 `#b06a2c`/斑 `#4e2610`;白垩 `#f0dfbf`;野牛 `#8c3d22`/头 `#76301a`;马 `#cf8236`;石 `#c98c50`/`#c08048`;桌面 `#d49a5a`;手印 `#8e2a1a`;余烬 `#ffe082`。

## 仍可改进
- 少女身体是 RIG 的写实曲线,比真正岩画人形「太顺」;更原始的做法是把轮廓点降采样到 12–16 个再加大手绘抖动。
- 岩壁浮雕是静态的,火光只改亮度不改阴影方向;真要「火光跳动下岩面起伏在动」需要两张不同光向的 shade 图按火光插值(+1 次全屏合成)。

---

<a id="02_egypt"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/02_egypt.md

# 02_egypt · 公元前1350年埃及墓室壁画(纯代码)

文件:`scenes/02_egypt.js`(约 460 行)。性能:warm max 20.7ms / mean 10.5ms(1920×1080),boot 时 `init()` 预热缓存,第一帧不再卡 170ms。确定性检查通过。

## 管线
1. **静态层 `eg_static`(缓存一次)**:灰泥墙 → 象形文字栏 → 窗(檐口/彩块框/白底/阿顿日盘/圣蛇) → 陶罐×3 → 供桌与供品 → 金椅 → 蓝碗 → 地线与底部多层饰带 → 深蓝带 → 顶/左右彩块边框。
2. **会动的母题(每帧画,便宜)**:水纹象形字流动、阿顿光线+末端小手开合、两条长光线伸到猫面前托安卡、圣甲虫推日球。
3. **角色**:埃及程式重画,不走 RIG.drawGirl/drawCat,只取锚点与编舞。
4. **壁画表面**:`eg_surface` 斑驳图层 `multiply` 全画面+`P.grain` 颗粒+6 条随机游走发丝裂纹(裂纹画在表面层里,所以会跨过人物,像真墙面老化)。

埃及壁画是「无透视、平涂、轮廓线」,这里**不用任何笔触渲染器**,线条也不沸腾(干净的 2.2–2.8px 深棕线 `#2a1810` 才像),时代感全靠程式(侧脸正面眼、正面双肩)+色板+纹样密度。

## 色板
墙 `#eadcb8`→斑驳暗部 `#d8c597`;四色边框 红 `#b8322a` 蓝 `#2a58a8` 黄 `#e2b13a` 绿 `#2e8a55`,块间米白 `#f2ead6`、黑缝 `#231a14`;金 `#e0ab38`/暗金 `#a8741c`/亮金 `#f3d27a`;深蓝带 `#1c2236`;分栏红线 `#9a2b22`;阿顿日盘 `#c8372b`、光线 `#c23a2a`、小手 `#b4452c`;肤色 `#e6b282`(埃及女性的浅黄赭);猫 橘 `#e08a3c` 条纹 `#b45a1c` 白 `#f6efe0`;圣甲虫 青金 `#2c56b0`+绿松石 `#3fa6a0`。

## 象形文字(最出时代感的部分)
- 写了 **24 个字形函数**(安卡、日轮、面包、芦苇、猫头鹰、隼、鹭、角蝰、荷鲁斯之眼、王名圈、圣甲虫、坐人、腿、手臂、篮、房、三竖、羽、杰德柱、申环、罐、莲花、nfr、嘴、水纹),每个在 ~50px 框内用 10–20 笔画出,自带候选颜色。线宽 3.1(缩放后约 3px),`round` 端点。
- 栏位照原片量:左 3 栏 x=78..306/y=66..566、中上 4 栏 x=852..1172/y=66..452、右 4 栏 x=1560..1866/y=252..882、猫左 1 栏 x=298..366/y=614..886。
- 排布:`U.rng(1350)` 种子,逐栏往下塞,字形缩放 = 栏宽/78×(1.0–1.14),间距 6–11px;**同栏不相邻重复、同栏同字形 ≤3 次、圣甲虫/水纹降权 60%**(第一版没限制,满屏都是圣甲虫,像贴纸)。
- 排布在模块初始化时算好、存位置——这样水纹字可以不进缓存,单独每帧画。保底至少 6 个水纹字。

## 母题动画(全部只靠 lt/t,确定性)
| 母题 | 做法 | 数字 |
|---|---|---|
| 圣甲虫推日球 | x(lt)=800+642·(lt−0.394),原片 10.7px/帧量出来的;取模 2160 循环;球滚动角 = 球心x/半径;腿两套姿态 `floor(lt*15)%2`(60fps 每 4 帧换) | 整体 ×1.22,球 r=23×1.22 |
| 阿顿小手开合 | open=0.5+0.5·sin(2π·lt/0.4+k·0.9),手指张角 (0.1+0.24·open) | 周期 0.4s,13 只窗内+2 只窗外 |
| 光线微颤 | 末端 x+=3·sin(7t+1.3k),y+=2·cos(6t+k) | ±3px |
| 水纹字流动 | zigzag 相位 = floor(lt·12)·0.5,12fps 步进、4 步一循环 | 0.33s/循环,像逐张手绘 |
| 端杯 | `cup = lerp(0.8,1,choreo.cup)`:原片「一直端在嘴边喝」,只走最后 20% 的举杯+choreo.sip 仰头 | — |
| 猫 | choreo.tail 甩尾(RIG.cat.tailPts)、blink(t≈2.18–2.30,正好落在本段 lt≈0.77–0.89)、breathe 上身 | — |

运动量:lt 0.45↔0.9(避开拍点冲击缩放)动像素 3.5%,集中在光线小手、猫尾、少女头臂、圣甲虫——量不大但都是视线焦点。

## 角色:埃及程式
**少女**(`RIG.girl({dy:-25})`,dy 让脚落在 y=900 地线上):
- 侧脸取 `G.face`;**正面眼**自己画:杏仁形白眼+黑瞳 r4.2 贴上眼睑、上眼线 3.2px 往后拖 18px(kohl 拖尾)、长眉。
- **正面双肩**:躯干不用 G.torso,自己画宽梯形 x 1270–1452(两个肩都看得见,上宽下窄)。
- 白亚麻:先填肤色,再 `alpha .9` 罩白 → 透出一点肤色=亚麻半透明感;裙身 27 条贝塞尔细褶从腰扇形散到下摆(clip 在裙里,`rgba(120,96,70,.5)` 1.3px),胸前竖褶间距 9px。
- 宽领项圈:5 条同心半椭圆(蓝/红/绿/金/蓝,rx 50→88、ry 24→55),外圈 18 颗红蓝交替水滴坠。
- **金色发辫**:假发轮廓 clip 后画 15 束竖辫,每束 = 11.5px 深金底线+8.5px 金色线+每 8px 一道左右交替的斜分节(人字纹),末端长短错落。第一版用小圆珠铺满,像「金色鱼子酱」,换成长条+斜节才读成编发。
- 金发箍(贝塞尔 15px 黑底/11px 金/3px 亮金)+后垂带、大金耳环、金臂环(金 8px+蓝 2.5px 横条)。
- **端杯手臂**:RIG 默认的手在杯侧、肩在躯干中间,肘会甩到很远。改成「手托在杯身下(杯脚)」,肩挪到前肩 (1282,476),`RIG.ik2(sh, hand, 140, 160, -1)` 让肘下垂到胸前。
- 蓝色莲花杯:花瓣形杯身+三道浅蓝瓣线+杯脚,跟 G.cup 的位置/倾角走。

**猫=巴斯特坐姿**(`RIG.cat({dy:-5})` 取 headC、tailPts、blink、breathe,身体自己画):
- 剪影:挺直的胸+圆臀,**前腿包在剪影里**,胸口到前爪一整片白,再用两条线分出两条前腿+趾线。第一版把前腿画成两根独立白柱,像保龄球瓶。
- 侧头+高尖耳+正面杏仁眼(黄 `#e8cf4a`、竖瞳、黑眼线拖尾)、白口鼻、胡须、金耳环。
- 项圈 clip 在「身体∪头」里(`Path2D.addPath` 合并),不然圆头描边会戳出脖子;荷鲁斯之眼金坠子。
- 橘色虎斑:背上 9 道、大腿 4 道、头顶 5 道深橘弧线,尾巴每 3 个采样点一道横纹,尾尖白。

## 踩到的坑
- selfcheck 的 0.2↔0.7 差分在本段会「全画面都在动」——那是引擎的拍点冲击缩放(lt<0.36s),不是场景在动。看真实运动要比 lt≥0.4 的两帧。
- `P.texture` 首次生成约 170ms;在 `init()` 里预热(引擎 boot 时调用),否则会卡在 T01 转场第一帧。
- 原片 ref 里的碎石块是转场残留,不是画面内容,别照抄(设定稿里也没有)。
- 年份牌区域 1500–1890×40–210 只留墙面;右侧象形栏从 y=252 开始正好避开。
- 复核返修:猫原尺寸时耳尖 y≈530,压到窗框底部彩块(y 530–560)上,像猫头插进窗框。改为以脚底 (540,898) 为锚、画布变换整体缩到 0.85(RIG.cat 仍是 s=1),耳尖落到 y≈585;两条长光线末端用同一变换 `catPt()` 换算,小手仍落在猫头/口鼻处;背线和臀部前移 12–20px,让巴斯特坐姿更修长。**教训:猫/人和窗框各自对齐标准构图框还不够,两个框在 y≈540–600 贴得很近,加高耳朵这类超出骨架框的部件要单独查和邻近物体的间隙。**

## 返修 v2:埃及偏静(审片报告第 3 条)
口径:整片 renderFrame,静止段帧 112–140,480×270 逐帧平均绝对差(屏蔽计数器)。**改前 0.32 → 改后 0.84(原片 0.90)**,性能 warm max 21.7ms。
- **端杯循环**:lt<0.35 照 choreo 举到嘴边;之后每 0.6s 一个循环 `cup = 1 − 0.46·(1−cos 2πu)/2`(杯离嘴下放到 0.54 再举回);杯在嘴边时加仰头 `sip += 0.3·clamp((cup−0.78)/0.22)·(0.65+0.35·sin 13lt)`,头部倾角到 ~0.2rad。这一项贡献最大。
- **铭文被写出来**:每 0.12s 从打乱的字表(种子 77,跨所有栏)取 6 个字:先用墙面纹理 `drawImage` 子矩形擦掉,再用 `setLineDash([p·95, 999])` 按笔画描出(每个子路径的 dash 会各自从头开始,正好像逐笔书写),填色部分 p>0.55 才出现;笔迹颜色从亮金 `#f6c846` 落回原色,带 10px 金色 shadowBlur 余辉,0.36s 写完。同时约 18 个字在写。
- **阿顿脉动**:周期 0.45s;光线长度沿扇形依次 ±9%(相位 −0.55k,像一道波扫过),线宽 2.2→3.8,小手整体缩放 0.9–1.2、手指张角 0.03–0.45;日盘外金色光晕+亮环脉动,日盘重画在光晕之上保持红色。小手坐标 clamp 在窗内(x 428–752,y≤512),否则伸长时会被窗框裁掉半只。
- **猫**:尾巴幅度 `tail·2.1 + 0.25·sin 9.5t`;两耳错相快速一抖(每 ~0.38s 一次 0.1s,绕耳根中点转 0.32–0.38rad)。
- 教训:阿顿光线、水纹字这类细线母题在 480×270 的帧差里几乎不计分,**测「看得出在动」要靠面积够大的局部动作**(手臂+头、整字擦写),细线摆动只能当点缀。第一版日盘脉动用半透明橙色盖在日盘上,峰值时把红日盘冲成橙色,改成盘外光晕+亮环。

---

<a id="03_greek"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/03_greek.md

# 03_greek · 公元前530 阿提卡黑绘陶器 —— 代码画法笔记

文件:`scenes/03_greek.js`(纯 Canvas 2D,无图片)。最终自检:warm max 15.9ms / mean 7.6ms / cold 80ms,确定性通过,0.2↔0.7s 运动差分 22% 像素在动。

## 一句话诀窍
黑绘 = **黑釉剪影 + 刻线 + 附加色**三件套,缺一不可:
- 剪影:所有人/物填 `#1b120d`(近黑带暖),不描边,靠剪影和陶土底对比成形。
- 刻线:在黑剪影上「刻穿」,用陶土亮橙 `#e8904c` 画 1.5–2px 细线(衣褶、五官、肢体重叠处的分界)。
- 附加色:紫红 `#8a2a37` 色带(发带、袖口、下摆、项圈、坐垫)+白色小点(`#f6ead6`,r≈2,间距 11–17px)。
做到这三样,不需要任何纹理就一眼是希腊陶瓶。

## 色板
陶土 `#dc6a2f`、亮陶土(瓶面板)`#e8803f`、黑釉 `#1b120d`、紫红 `#8a2a37`、白 `#f6ead6`、刻线 `#e8904c`、金发 `#f2bd48`、陶土留白(猫白区)`#f3cfa4`、猫橘 `#f2913f`、猫鼻 `#e7897a`。

## 管线与参数
1. **陶土底(缓存 `gr_bg`)**:480×270 低分辨率逐像素算 fbm(×0.016, 4 octave) 斑驳 ±30 + `noise(x*0.006, y*0.85)` 的**水平条带噪声**(拉坯纹)±9,放大到 1920×1080(低频本来就糊,省 16 倍计算);再画 560 条随机水平细线(长 150–1050,alpha 0.03–0.08,深/浅两种)当拉坯细纹;420 个深色小点 + 120 个浅点;两层 `P.grain`;5 条裂纹(每 9px 一段、±2px 抖动,下沿再画一条 1px 偏移的淡亮边,裂缝立刻有厚度)。中心叠一层暖色径向提亮 0.16。冷启动整帧 ~80ms。
2. **暗角(缓存 `gr_vig`)**:径向 380→1180,外沿 rgba(30,6,0,.62),最后一层盖全画面(含纹带)。
3. **静态黑绘层(缓存 `gr_static`)**:画框(黑边 18px+白点串 11.6px 间距+内细线)、葡萄藤(正弦茎+三角葡萄串 3-2-1 圆点)、桌(腿带兽爪脚)、车旋椅腿(宽度表 [y,w] 折线对称成形)、天鹅颈椅背(13px 粗描边曲线+椭圆头+三角喙)、双耳瓶(24 点对称轮廓→`RIG.smooth`,瓶面板留陶土+小黑猫、瓶底射线纹、一条竖向 0.09 的光泽渐变)、两段希腊铭文。
4. **希腊铭文**:字体库没有希腊字形 → 自写**笔画表**(每个字母 1–3 段折线,单位格 0..1)。字高 30、笔宽 3.4、每字高度 ×(0.9–1.06) 随机、基线 ±6% 抖动、顶点 ±0.7px 抖动;Ο 画成小圆(字高 0.25,原片就是小 o),Ι 宽 2px。手写陶画铭文味道主要来自「字母不等高 + 小 o」。
5. **滚动纹带**:顶部回纹(周期 60px,7px 黑线,单元折线 `[[4,46],[4,0],[50,0],[50,34],[18,34],[18,14],[36,14],[36,22]]` +通长底线)与底部莲苞链+射线纹(周期 76px=两个 38px 单元,奇数苞填紫红,所以真实周期是 76)各预渲成宽 W+2P 的条带,每帧 `drawImage(strip, -(off mod P))`。偏移曲线:
   - 顶:`off = 22·lt + 60·easeInOut((lt−0.49)/0.35)`,向左;
   - 底:`off = −(18·lt + 76·easeInOut((lt−0.477)/0.367))`,向右。
   原片只在 169–191 帧做一次 easeInOut 周期跳;我额外加了 18–22px/s 匀速漂移,让本段前 0.47s 也能看出在走。
6. **画框内母题**(每帧画,clip 进画框):6 条海豚(自写贝塞尔剪影:喙、背鳍、腹鳍、尾叉+腹部刻线+白眼点)沿自身朝向 ±9px 来回游、角度 ±0.12rad,周期 0.85s,彼此相位差 1.3;船整体绕 (560,420) 起伏 ±4px、摇 ±0.025rad,周期 0.9s。白帆+紫红缝线、新月船身+蝎尾形船尾、紫红船舱、斜倚人形。
7. **里拉琴**:以钉子 (1050,150) 为轴 `0.09·sin(2π·lt/0.8+0.5)` 摆(±5°,音箱处位移 ±17px,1 秒内明显)。龟壳音箱=黑圆+刻线圈+5 个刻线小圆。
8. **玫瑰花饰**:8 瓣黑椭圆+刻线分瓣+紫红心,`lt·1.6` rad/s 正反交替旋转。
9. **橘白猫**(自画,不用 RIG 默认多边形;尾巴用 `RIG.cat` 的 tailPts 跟 choreo.tail 摆):整体以 (548,903) 缩 0.9 落进标准框;橘剪影+黑描边 3.4px;白胸/白爪/口鼻用「陶土留白」奶油色;**背部虎斑沿背轮廓按弧长等距取 12 点,朝身体中心 (575,800) 画锥形斑**(长 30–48,根宽 10)——比手摆斑纹自然得多;大腿弧、前腿竖斑;古风大圆眼(白眼+黑瞳+高光+上方一道眉弧),眨眼时换成弧线;紫红项圈白点。
10. **少女**:`RIG.girl({cup,sip,breathe,s:0.97,dy:-14,hair:'long'})`——缩放下移让脚落在地线 903。
    - 身体直接填 RIG 的 Path2D(farSleeve/skirt/torso/neck),远侧手换成小椭圆(RIG 的 farHand 在黑剪影里像一片刀片)。
    - **头部自画**:在 RIG 静止坐标系里写希腊侧脸(直鼻梁连额、细下巴)+发型轮廓,用 canvas 变换复刻 RIG 的头部运动:`translate(neck)·rotate(G.tilt)·translate(−neck)·T`。同一个矩阵用 `DOMMatrix` 再算一份,`Path2D.addPath(faceSil, M)` 拿来做刻线裁剪区。
    - **金发**(认出「金发少女」的关键):发区 clip 内画 11 条头顶波浪发丝(二次贝塞尔+法向 2.6px·sin(7πu) 波动)、8 绺背后长卷发(正弦 4.5 个半波+末端小螺旋)、发髻双螺旋、额前 4 个小卷、鬓角两条螺旋卷(黑底 6px 垫一道再画金 2.2px,跨出剪影也看得清)。金线 2.5px 在 1080p 下才够「量」,2px 时缩略图里就看不出是金发。
    - 刻线:衣褶 16 条(clip 在身体内)、杏仁眼(浅色眼白+黑瞳,正面眼画在侧脸上)、眉、鼻翼、唇、下巴。**近侧手臂与身体/头重叠处的分界**:clip(身体∪头) 后描手臂轮廓的刻线——黑叠黑只能靠这个分开,手举到嘴边时脸才不会糊成一团。
    - 附加色:下摆 15px 紫红带+白点、袖口带(clip 在上臂内,沿上臂法向画 15px 宽色带+上下刻线)、手镯、白点四瓣小花 8 朵、发带。
    - 基里克斯杯(宽浅双耳,半宽 32)跟 `G.cup`(含 tilt),杯口紫红线;热气是三道「≀」黑细线,相位 `t·9`。

## 动的东西(0–0.94s 内都可见)
端杯(choreo.cup 0.9s 举到嘴边+头微仰)、猫尾/眨眼/呼吸、顶底纹带滚动(漂移+拍点周期跳)、里拉琴摆、船起伏、海豚游、玫瑰转、热气扭。

## 踩到的坑
- RIG 头发轮廓直接放大后后脑太宽(第一版后脑伸到 x=1450,头像头盔);按设定稿收到 1424,长发只垂到 y≈558。
- 杯子在嘴边时黑手黑杯黑脸糊成一块:①手臂对头部做刻线分界 ②杯子缩小(半宽 44→32)③杯口留一条紫红线。
- RIG 猫的头顶到 y=535,标准框猫顶是 610;不缩会压到画框下沿。
- 底带奇偶苞交替时真实周期是 2 个单元(76px),预渲条带的 wrap 周期必须用 76,否则每 38px 跳色。
- `P.grain` 的种子 = key 长度,两层 grain 的 key 必须不同长度,否则图案相同。
- **端杯终点要时代化(复核返修)**:RIG 的 cup→mouth 终点在鼻尖附近、杯倾 −0.45rad,换成宽浅的基里克斯杯后像一根鸟嘴/烟斗插在脸上,手还捂住嘴和下巴。改成自己做 IK:唇点 rest(1243,391) 用头部 DOMMatrix 变换到屏幕,杯沿中心 = 唇点 −(30,−1)(杯沿右端刚碰嘴唇),倾角 −0.08·cup(≤5°),手的 IK 目标 = 杯沿 +(lerp(32,6,cup), 30),即托在杯脚下;`RIG.ik2(S, 手目标, 165s, 122s, −1)`+`RIG.taper` 自己出上臂/前臂。前臂竖在胸前,鼻、唇、下巴的侧脸轮廓完整露出。热气跟随杯沿。

## v1 审片返修(猫改黑绘 + 顶带滚动加量)
- **猫必须和人同一套画法**:亮橘大圆眼卡通猫在黑绘里一眼跳戏。改成黑釉剪影,「橘白」只靠附加色和刻线分区:背部沿轮廓画一条 26px 紫红鞍带、头顶一块紫红(椭圆 46×22 clip 在头内)、尾巴黑底+7px 紫红芯;虎斑全部是陶土橙 `#f2913f` 3px **刻线**(沿背轮廓弧长等距 14 条朝身体中心的弯线+大腿 3 条+前腿 3 条+尾巴每隔 2 点一道环);白胸/口鼻/爪用白彩 `#efe1c8`,爪上黑刻趾;眼睛改古风刻线杏仁眼(白彩眼白+竖椭圆黑瞳+眼尾小刻线),眨眼是一道下弯刻线;鼻子紫红,须左侧用刻线(落在黑脸上)、右侧用黑线(落在陶土上)。
- **周期图案滚整数个周期 = 首尾两帧一样**:顶带 60px 周期跳一次后画面和跳之前完全相同,看静帧对比或抽帧很容易判成「没动」。匀速漂移从 22→48px/s(底带 18→30px/s),保证任意两帧间都有相位差。
- 整片静止段运动量(480×270 帧差均值):03_greek 1.87 → 2.02,原片 2.06。warm max 17ms。

---

<a id="04_roman"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/04_roman.md

# 04_roman · 公元79年 庞贝马赛克 —— 手法笔记

文件:`scenes/04_roman.js`(约 330 行)。最终自检:warm max 17ms / mean 13ms(1920×1080),init 206ms(boot 时一次),17,871 块石头,其中 13,067 块在动态区每帧重新取色。确定性通过。

## 核心思路:布局只算一次,颜色每帧流过石块

马赛克的动画应当长成这样:石块本身固定在墙上,动的是颜色从一块流到另一块。所以渲染器拆成两半。

1. **init(`build()`,206ms)**:先算出每一块石头在哪、多大、朝哪、哪些像素属于它、斜面明暗如何,存成 `ID`(Int32,每像素对应的石块号,-1 表示灰浆)和 `SH`(Uint8,每像素明暗,128=1.0)。
2. **每帧**:重画平涂底稿,`getImageData` 一次,然后在动态石块的中心点取色(加上每块石头固定的颜色抖动),再在动态矩形里逐像素填 `色×明暗>>7`,最后 `putImageData` 到自己的离屏画布,用 `drawImage` 贴到 `c` 上。
   - 坑:**不能直接对 `c` 做 `putImageData`**,因为它会无视引擎的镜头冲击缩放(punch zoom)和转场裁剪。必须先写进离屏画布再 `drawImage`。
   - 每帧逐像素只处理约 100 万像素(4 条边框带、画框内、少女、猫),用 JS 循环大约 5ms。所有离屏 context 都用 `{willReadFrequently:true}`,`getImageData` 才快。

## 石块布局(andamento:沿轮廓排)

按 Hausner 2001「Simulating Decorative Mosaics」的思路简化而来。

- **结构图**:静态底稿加上第 0 帧的猫和少女(不画会动的近侧手臂),降采样到 960×540。相邻像素的 RGB 差之和大于 34 就记为边缘,再把类别图里边框带的边界也算作边缘。
- **距离场**:用 Felzenszwalb–Huttenlocher 精确欧氏距离变换(两遍一维下包络),半分辨率下约 20ms。
- **沿轮廓走线放石块**:候选像素满足 |d−(k+½)s|<1.5、k<该类的圈数,也就是距离场的等值线带。从未访问的候选点出发,沿 8 邻域优先走「和上一步方向最一致」的候选(方向做 0.6/0.4 平滑),离上一块的距离 ≥s 时放一块。石块的朝向取距离场梯度的切向。空间哈希保证任意两块的间距 ≥0.8×平均尺寸。
- **规则成行补洞**:每个类别铺一张砖缝错开半块的网格(行抖动 ±5%、列抖动 ±9%)。最小间距检查用 0.86,能放下就放。这一步同时填掉轮廓行之间和中轴线上的洞。
  - 坑:起初只让「距离 ≥K×s」的地方放网格,结果窄形状(猫尾巴,26px 宽)里一块石头都没有,整条尾巴露出灰浆。改成只靠最小间距之后就解决了。
- **边框带单独排**:每条边在自己的局部坐标里排 11 行,石块 7.6px,沿边方向宽度在 0.86–1.14 之间随机;四角是 11×11 的方格。

| 类别 | 石块边长 px | 沿轮廓圈数 | 颜色抖动 |
|---|---|---|---|
| 墙 | 12 | 1,之后规则成行 | ±8%,7% 的石块额外压暗 12% |
| 晕圈(人/猫/物件外侧白边) | 11 | 9(整条晕圈都沿轮廓) | ±5% |
| 少女身体 / 物件 | 10 | 全部沿轮廓 | ±5% |
| 少女脸、猫头 | 6 | 全部 | ±4% |
| 头发 | 8 | 全部 | ±5% |
| 火山画内 | 9 | 2 | ±6% |
| 外框带 | 7.6 | 沿边成行 | ±5% |
| 文字 | 7 | 全部 | ±5% |
| 地面带 | 13 | 1 | ±6.5% |

除了表里的抖动,每块石头还会加一个 ±7 的加性灰度抖动。9% 的石块偏暖(+12,+4,−8),7% 偏冷(−6,0,+9)。

## 石块形状与灰浆:加权 L∞ Voronoi

- 每块石头是一个旋转方块。四条半边长各自独立取 `s/2×(1.08–1.28)`,旋转角再抖动 ±0.06rad。像素到石块 k 的距离定义为 `D=max(|u|/h±, |v|/h±)`,其中 (u,v) 是像素在该石块局部坐标里的位置。
- 光栅化时对每个像素记录最小的 D1、次小的 D2 和对应石块号,开销是每块石头的包围盒 1.5h。
- **灰浆**:满足 `D1>1`,或 `(D2−D1)·h/2 < g`(g = clamp(0.1s, 0.75, 1.25)px)的像素算灰浆,也就是落在两块石头的平分线附近。所以缝宽约 1.5–2.5px,石头被邻居「切」出不规则边,像真的錾过。
  - 坑:半边长最初只取 `s/2×(0.9–1.1)`,石块小于间距,结果灰浆占了约 40% 的面积,看起来很稀。把石块做得比半间距大 8–28%,交给平分线去切,石块就密实了。这一处是质感的关键。
- **斜面明暗**:离边 2.2px 以内,按外法线与光向 (−0.6,−0.8) 的点积 ±16% 变亮或变暗(左上亮、右下暗)。再加穹顶项 `−5%·D1²` 和 ±3% 的像素颗粒。
- 灰浆色:`rgb(112,103,92)` ±8 噪声。

## 平涂底稿与配色

- 墙 `#e4ddcd`,晕圈 `#f5f1e8`(每个人和物件外面都描一圈 44–50px 的晕圈,石块会沿它排出白边),描边 `#46322a`,描边 8px(脸部 8px,以便成排)。
- 画框:红 `#a8322a`,往里依次是深红 `#7c221d` 线、金 `#d0a23c` 线、深色线。
- 火山:三个面分别是亮 `#7c84b8`、中 `#4e5796`、暗 `#2f3672`;天空 `#9ec0d8`→`#d3e3e4`;山坡 `#6f9341`/`#92b254`;地面 `#cba344`;柏树 `#2b5a2f`;熔岩 `#d64a22`/`#f2952c`。
- 少女:斯托拉 `#efe7d5`,下摆两道红条 `#a8322a`;红披肩分三块(背后斜披、膝上一条、前襟垂下),褶线 `#7c221d`,配金色胸针;短袖口是在上臂里裁一个以肩为圆心、半径 62 的圆,加红边;金发 `#dcaa42`,分层线 `#9c6c1c`,脑后螺旋发髻;红发带用三次贝塞尔并跟随头部 tilt 旋转。眼睛画成 10×6 的白加半径 5.5 的深色,这样恰好落成「一白一深」两块 6px 石头。
- 猫:橘 `#dc8530`,背部压暗 `#c06a24`,条纹 `#9c4818`,白 `#f7f2e8`,大黄眼 `#e9c22c`(半径为 eyeR×1.65),红项圈 `#b02a22` 带金坠。身体用 `RIG.smooth(K.bodyPts)` 平滑出梨形,替代原来的多边形。尾巴的环纹用虚线 `setLineDash([9,13])` 画。
- 「CAVE CATTVM」:**自己写的等宽粗笔画字母**(C 用椭圆弧,A、V、E、T、M 用折线),笔画 14px、字高 60px、字距 16,横向缩放到 600px 宽。
  - 坑:用 Cinzel-700 直接 fillText,细横笔在 7–9px 石块下会断(E 变 F、A 丢横),字距紧时还会粘成一团。三轮迭代下来,结论是「马赛克字 = 等宽粗笔画、每笔约 2 块石头宽」。

## 母题动画(本段 lt 0–0.94s,T04 转场期间画到 1.29s)

- **四边波浪纹顺时针流动**:每条边用 `setTransform` 切到局部坐标(u 沿顺时针方向,v 从外往里),画同一个维特鲁威卷涡:从内侧黑带起笔,螺旋 r 从 24 收到 5、转 2.25 圈,线宽 13,周期 81px。相位为 `42·lt + 81·easeInOut((lt−0.485)/0.365)`,即全程匀速漂移,再在原片的 226–248 帧多走一个周期。石块位置不动,所以黑白在石块间流动,正是马赛克动起来的样子。0.4→0.9s 之间边框带有 20% 的像素在变。
- **维苏威冒烟**:火山口离画框顶只有 70px,烟往上飘很快就被裁掉,看不见(第一版就踩了这个坑)。改为让整条灰云带以 55px/s 向右漂(周期 380px),再加 9 团烟(深 `#3f3c3a`→浅 `#a29c94`)贴着天空往右压低飘,加 12 颗火星(10px 方块,抛物线轨迹)和火山口熔岩脉动。画框内有 4.4% 的像素在变。
- **端杯**:节奏用 `choreo.cup/sip`,杯子是金色双耳杯 kantharos,杯口有白石热气,透明度为 1−0.85·cup。路线是自写的 `armPose`(见文末「复核返修」)。
  - 坑:墙石 15px 时,手和杯子在大石块里糊成一团。一度给手臂扫过区单独换成 8.5px 石块,结果静止时成了发白的补丁,最后改成全墙统一 12px。
- **猫**:尾巴用 `choreo.tail×1.6`(9px 石块下原幅度太小,看不出摆),眨眼时眼睛变成橘色石块加一条深线。

## 性能与动态矩形

- 动态矩形在 init 时由采样姿态的包围盒算出(cup 从 0 到 1 每 0.05 一档,sip 取 0/0.15;猫尾 tail 在 ±0.75 范围内),外扩 58px,包住晕圈和热气。矩形外是第 0 帧的静态马赛克。
  - 坑:矩形要包得足够大,否则跨边界的石块会出现一半新色、一半旧色。
- 全片时间轴里罗马段(包括前后两次转场、新旧两层同画)的帧,除了首次进入转场时其他时代的冷缓存外,都在 40ms 以下。

## 自检里要知道的

- `selfcheck` 的「运动差分 0.2↔0.7」会被引擎的拍点镜头冲击污染。lt<0.37 时整幅画面在缩放,结果报 68%,那不是画在动。改用 0.4↔0.9(冲击已结束)测:全画面 6.2%,其中边框带 20.4%、少女 8.4%、画框 4.4%、猫 0.8%。

## 还能更好的地方

- 少女举杯到嘴边时,手、杯和脸挤在一起,在 6–8.5px 的石块尺度下略糊。

## 复核返修(第二轮)

- **猫**:以脚底 (540,905) 为锚,用画布变换缩到 0.85(类别图、动态矩形同步缩放),耳尖从 y≈540 降到约 590,晕圈不再碰画框。头改画成正脸庞贝猫:两只 R17 的大黄圆眼、黑竖瞳、7px 深色眼眶,头部 11px 深色描边,类别图里也描进 6px 小石块,所以轮廓能成排。
- **举杯糊脸**:不再走骨架原来的举杯路线,改用自写的 `armPose`。杯子沿「桌面→前上方 (1150,470)→唇前」的二次贝塞尔移动,终点是杯沿右端贴在 `G.lips[0]`,倾角 0.15rad(8.6°)。手托在杯脚下(偏移从 (28,34) 插值到 (3,44)),IK 用同一副臂长 165/122 和肘向。前臂竖在下巴前方,鼻、唇、下巴和眼都露出来了。面部描边加粗到 10px。
- **补墙感**:去掉了「手臂扫过区 8.5px」这个类别。墙石统一改为 12px(也更接近原片墙石的尺度),动态区的墙和周围共用同一套布局,只是每帧重新取色,看不出边界。
  - 教训:动态区千万别为了细节单独换石块尺寸,静止时它就是一块补丁。
- 返修后:warm max 17.1ms,mean 13.0ms,确定性通过。

## 审片返修(第三轮,v1 审片报告第 3、4 条)

- **边框看不出在滚**:整片时间轴(renderFrame)里其实在动,但「石块不动、只换色」的做法下,卷涡每帧只移 1–3px,被 7.6px 的石块量化之后,在运动热力图里几乎不亮。
  - 改法:边框改成「传送带」。在 init 里预烘一条长 2106px(26 个周期)的石块带。图案周期是 81px,石块布局也按 81px 循环:每行 11 块,宽度各自随机,但归一化到正好 81px,抖动也按周期复用。所以整条带平移任意相位都能无缝接上。
  - 每帧对四条边各做一次 `c.transform(边的局部坐标)`,再裁剪、`drawImage(strip, BW−2·81+相位, 0)`,石块跟着图案一起顺时针走。四角方块保持静态。
  - 相位改为 `15·lt + 81·easeInOut((lt−0.485)/0.365)`,匀速漂移从 42 降到 15px/s,主运动留给原片 226–248 帧那一个周期。
  - 静止段运动量(motion.py,480×270 平均帧差,帧 222–253):复刻从 1.98 升到 4.62,原片 2.90。漂移是 42px/s 时为 5.5。
  - 规律:慢速图案位移小于石块尺寸时,「只换色」会被量化吃掉,要么让石块跟着走,要么位移必须远大于石块。
- **杯子读不出**:杯子从底稿里拿掉,改成 4.4px 小石块的拼片 `cupSprite`。内容是放大 1.3 倍的双耳杯:深色描边石块、金色杯身(右侧压暗)、亮杯口加深色杯内、两只耳、杯脚。每帧按 `armPose` 的位置和倾角整块叠在马赛克上。热气也改成两列沿正弦上行的白色方石(`steamTiles`),带灰浆边。底稿里只留杯子的白晕。
  - 规律:小于 3 块石头宽的道具在固定布局里读不出来,应当做成随手移动的「嵌片」(emblema 式拼片)。
- **脸读不出五官**:脸部石块从 6px 改为 5px。眼睛白色 13×7,深色 8×7,约 3 块深石加白;嘴唇改成红 `#a8282a`、8.5×6 的椭圆,约 2 块;眉毛 6px 深棕。1080p 缩到一半看,能读出眼睛和嘴。
- 返修后:warm max 20.9ms,p90 17.4ms,mean 13.9ms,确定性通过。

---

<a id="05_gothic"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/05_gothic.md

# 05_gothic · 1290 哥特泥金手抄本

每帧 11–22ms(中位 12ms)。静态层+金箔掩膜在 `init()` 里一次性建好。

## 管线
1. 静态层 `goth_static`(缓存):羊皮纸 → 金箔 → 菱格压花 → 山墙、小尖塔、侧柱 → 尖拱窗和彩玻璃 → 桌子、宝座 → 拉丁文栏 → 页边小骑士。
2. 金箔掩膜 `goth_mask`:对静态层逐像素算「金色度」 `clamp((r-b-70)/50)·clamp((g-b-30)/40)·clamp((r-140)/40)`,结果当 alpha。羊皮纸 (236,223,194) 的 r−b 只有 42,被排除;粉色带 b 值高,也被排除。**不用再画一遍金色形状来做遮罩**,凡是金色的地方都会自动被高光扫到:背景、首字母、金球、山墙顶饰。
3. 每帧依次画:彩玻璃闪烁 → 斜向高光 → 高光经过处出现四角星 → 藤蔓花饰 → 蜗牛 → 跑过的老鼠 → 猫 → 少女 → 颗粒。

## 金箔质感(规范要求的「细纹理+高光」)
- 逐像素着色:`f = 0.52 + fbm(x·.0035)·0.42 + 横向打磨纹 noise(x·.004, y·.09)·0.5 + 左上受光 + 颗粒±0.05`,再在 goldLo #9c6a1a / gold #d9a63a / goldHi #f8de86 三个色之间插值。打磨纹的 y 频率是 x 的 20 倍以上,所以看起来是横向的金属拉丝。
- 菱格:间距 46px,两族斜线(x+y、x−y 各为常数)。每条线画两遍:一遍暗线,一遍错开 1.2px 的亮线,看起来就是刻进金里的。菱心压 4 个点,左上亮、右下暗。
- 每隔 118×125px 画一条极淡的方块接缝,模仿一片片贴上去的金箔。
- 斜向高光:先在一张 920px 宽的 scratch 上画线性渐变带,斜率 K=0.45(“/” 方向)。用 `destination-in` 乘掩膜,再以 `lighter`、α0.62 叠回画面。**按匀速移动** `x = lerp(150,1650,(lt-0.08)/1.15)`。最初用 inOut 缓动,结果 0.9s 时高光已经扫出金区,少女身上看不到;改成匀速后,0.3s 扫到窗边,0.9s 正好扫过少女。光环、11 个固定点按 `|u − sweepX| < 70` 判定,在高光经过时出四角星闪光。

## 母题动画(0.25–1.4s 窗口内都看得出)
- 藤蔓:两条茎各约 120 个点,每个点加 `sin(t·2.1+i·.09)·2.5` 的摆动。每 3–5 个点挂一片三瓣常春藤叶(蓝/红/金轮换)或一颗带 3 根须的金球。叶片绕挂点按 `sin(t·3.1+k·1.7)·0.28` 摆。叶片缩放第一版用 0.85,太小太稀,改为 1.05–1.45 后,密度才接近原片。
- 彩玻璃:26 个随机点,`sin(t·5+h·40) > 0.6` 时点亮一团白色径向光。
- 猫抬起一只前爪,拎着老鼠尾巴,老鼠像钟摆一样摆 `0.32·sin(t·5.5)`,小腿乱蹬。蜗牛以 62px/s 向左爬,触角晃动;文字栏下的老鼠在 0.12–1.17s 内跑过 360px,腿每秒摆 40 弧度。
- 少女按共享编舞端起金杯,杯沿有一颗四角星闪烁,杯上热气用细墨线。

## 角色
- 少女直接拿 `RIG.girl` 的 Path2D 自己按顺序画,**不调 `RIG.drawGirl`**,原因有两个:drawGirl 一定会画成带把手的马克杯;斗篷和光环要插在中间某几层之间。画的顺序:光环(以 headC 为中心偏 (16,−22),r=114,红圈加 36 颗压印点)→ 波浪长金发 → 红袍(金细竖条每 20px 一条,袍摆一道金边)→ 蓝斗篷(锚在 nape/back 上,带金边)→ 头 → 金圣杯。
- 猫做成手抄本里「人脸猫」:脸部是一块奶油色椭圆,杏眼瞳孔挤在右侧斜睨少女,上眼皮加粗,眉毛挑起,嘴角下撇,两颊红晕。只用 `legs[0]`,另一条前腿用 `RIG.limb` 自己画成抬起的姿势。
- 拉丁文正文用 UnifrakturMaguntia 44px。50px 会把 “cum poculo suo” 挤出画面右边。句首的 Cattus/Nemo/Mus 用朱红,这是中世纪的朱批做法。

## 坑
- scratchpad 和其它时代作者共用,`check.py` 被别人覆盖过一次。自检脚本要放进自己的子目录。
- 运动差分图如果拿 lt=0 当基准,会被引擎前 20 帧的镜头冲击(1.03 缩放)污染。基准要取 lt≥0.35。

## v2 微调
藤蔓摆幅 ×2、叶摆 0.42;彩窗闪点 40 个;金箔高光 α0.85、高光带加宽。静止段帧差 1.10 → 1.32(原片 1.64)。

---

<a id="06_renaissance"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/06_renaissance.md

# 06_renaissance · 1503 文艺复兴盛期(达芬奇式)

每帧 16–37ms(中位 16ms)。

## 管线
1. 静态层 `ren_static`:先在原始 canvas 上画完房间,再整层用 `filter: blur(1.3px)` 画进缓存,相当于全画面做一遍 sfumato。房间内容如下:
   - 墙:P.texture #43321f→#22180e,加窗光晕的径向渐变,顶部压暗。
   - 窗:半圆拱窗,石框左侧受光,窗洞里是远景。
   - 地砖:透视棋盘。按真投影算:`y = 420 + f·h/Z`,`x = 960 + f·X/Z`,f=1029、h=5.75,Z 从 16 往前每块砖 1.4。第一行落在 y=790,往下依次 825/868/922/989,和原片的行距对得上。地砖色是 #a88c64 和 #5c2418,再叠一层 soft-light 光池和一层四周压暗的径向渐变(以 760,960 为中心)。
   - 方桌白布、梯背椅。
2. 远景(空气透视):画三层山,越远越蓝越淡(#9fb4b8 → #7d9294),轮廓用 fbm 生成。之后是湖、河谷(由灰绿过渡到暖赭)、蜿蜒的银白河(宽度随远近从 3 增到 16px)、柏树和圆树、石桥。
3. 每帧依次画:河面碎光(24 个光点顺流移动、闪烁)→ 飞鸟 → 扑翼机(三者都裁剪在窗洞内)→ 角色层 → 光柱和浮尘 → 罩层。
4. 罩层 `ren_over`(缓存后一次 drawImage):
   - 暗角:0.55 处 α0.3,边缘 α0.8。
   - 黄釉:α0.07。
   - 画布经纬:每 3px 一条线。
   - 油彩笔触肌理:9000 笔,α0.022/0.028,线宽 5–10,方向随机。
   - 龟裂纹:P.craquelure 取 α0.32;再用 `brightness(0) invert(1)` 把它变成白线,错开 1px、α0.16、`lighter` 叠一遍,模拟漆皮翘起的亮边。

## 晕涂(sfumato)
角色先画进离屏层 `renChars`,只处理 (320,180,1200,780) 这块区域。画回主画面分两遍:先 `blur(2.6px)` 全不透明,再叠一张 α0.38 的清晰层。这样边缘是软的,五官还认得出。角色不描线,全部靠渐变出体积:
- 裙褶:亮褶 rgba(200,70,60,.3),暗褶 rgba(40,0,0,.45)。
- 天鹅绒袖子:沿骨骼方向画一条 rgba(170,200,140,.45) 的光带。
- 脸:左侧受光渐变,加眼窝阴影。

## 母题动画
- 扑翼机:0–1.35s 从 x=470 飞到 740,同时上下浮动、略有俯仰。两张蝙蝠翼的扇动按 `up = 0.5+0.5·sin(t·12+相位)`,翼尖在 −118 到 +24px 之间。远翼缩到 0.78 倍、颜色压暗、相位错开 0.5。翼的画法:前缘梁+6 根放射肋+扇贝形后缘膜,尾舵也在摆。第一版是平面「纸飞机」,认不出是达芬奇的扑翼机,重画成现在的肋骨扇形翼后才认得出。
- 光柱:楔形一次性画进缓存并做 `blur(28px)`,每帧 screen 叠加。第一版每帧直接填多边形,两条硬边很假。浮尘是 46 颗粒子,沿光柱缓慢上浮并闪烁。
- 少女按编舞用银杯啜饮,cup>0.7 时闭眼。猫一直眯眼微笑,尾巴在摆。

## 坑
- 第一版油彩肌理用 26000 笔、α0.05、方向跟着 noise 走,结果整面墙像梵高的漩涡(后印象派)。降到 9000 笔、α0.025、方向随机后才回到古典油画的感觉。
- 猫身体的轮廓内侧压暗用了 26px、α0.45,奶白色身体看起来像个玻璃罩。改成 14px、α0.22,白色的胸部改用径向渐变把橘色毛「晕」进来,不留硬边界。
- 地砖第一版太亮、对比太强,像矢量插画。必须压暗四周,只留下窗光照到的那块光池。

## v2 返修(审片:偏静 0.20 vs 0.46;主角被模糊、窗外反而清晰,景深倒置)
- 晕涂改为:模糊层 1.6px(原 2.6),清晰层 α0.82(原 0.38)。软边保留,五官和轮廓清楚了。
- 扑翼机放大 1.6 倍,航程 440→790,俯仰幅度 ±0.07;飞鸟增加到 14 只、放大 1–1.8 倍。
- 猫:头绕脖子歪蹭 ±0.16rad,眯眼松紧交替,尾巴 ×2.2,呼吸 ×3,look 左右转头。少女:发梢摆 ±11px,sip ×1.6。
- 窗外云影掠过河谷;光柱亮度随「云过日」以 0.75±0.35 变化;浮尘 70 颗。
- 静止段帧差:0.20(审片口径)/0.30(我量)→ 0.37。原片 0.43。

---

<a id="08_impressionism"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/08_impressionism.md

# 08_impressionism · 1874 印象派(莫奈)

每帧 65–76ms(中位 69ms)。主要开销是两遍全屏 P.strokes 加一遍角色笔触。

## 管线(照 09_postimp 标杆)
1. 平涂底稿 `impBase`,每帧重画,因为罂粟、云、花束、盆栽、窗帘都在动:
   - 粉紫墙(#d8bede→#f0c8cc→#f2c4d4),右上叠一个 r=900 的暖黄阳光径向渐变。
   - 窗外花园:天、树林、红顶屋、草地,70 朵罂粟(茎底不动,花头横摆 `sin(t·3.2+ph+x·.02)·(6+r·.6)`),撑阳伞的女子加孩子(向《罂粟田》致敬),花丛。
   - 白窗框、淡紫窗帘、墙上的《日出·印象》、圆桌白紫桌布、花瓶、茶壶、右侧盆栽(整团叶子随 `sin(t·1.9)·8` 摆)。
2. 笔触重画,**两遍**:
   - 主画面:cell 11、len 20、width 7、outline 0、jitterCol 26,用 mask 排除窗景和墙上的小画。
   - 窗景和《日出》:cell 6、len 11、width 4.5,只画 mask 范围内。
   - 第一版只有一遍粗笔,窗外的房子、撑伞女人全被糊掉,《日出》也被斜笔刷成一片。分开两遍、《日出》改成横向水波笔后就都认得出了。
   - 画布先铺 #f2e6ee,笔触缝隙里露出浅色底。
3. 方向场:墙向右上斜(阳光区 −0.95 弧度,其余 −0.55,再加 ±0.55 噪声);地面接近水平;窗帘和桌布竖向;盆栽从盆口往外放射;窗里的天空横向。
4. 区域色板 `P.swatch`(mixBase 0.3–0.45):墙 9 色粉紫黄;阳光墙 7 色奶黄;地面 7 色玫瑰橙紫;天空、草绿、窗帘淡紫、桌布蓝紫各一组。白窗框用 `col > (240,236,225)` 判定,混回白色,否则会被刷成墙色、窗框消失。罂粟的红返回 null,保留底稿原色。
5. 角色:先用 `RIG.drawCat` / `RIG.drawGirl` 的 fill 模式平涂,再在角色层上用 `source-atop` 跑一遍 P.strokes(cell 7、len 13),只在角色内部出笔。白裙用白、淡紫、奶黄四色抽色。之后只补五官,用淡紫细线,印象派不勾轮廓。
   - 草帽、蓝丝带、腰带飘带都在飘。
   - `pal.line` 一定要设成发色金:drawGirl 的 locks、lid 这些部位即使 lw=0 也会用 pal.line 描线,默认的深蓝会在脸旁边留下黑道。猫同理,要设 `line`/`whisker`。

## 母题动画
- **阳光斑闪烁跳动**:26 个斑块(6 块在桌面,20 块在地面)。每块的强度是 `0.5+0.5·sin(t·sp+ph)·sin(t·sp·0.53+2ph)`,再用 clamp 截断,所以亮灭的节奏不规则。斑块缓慢横漂 ±10px。每块是 40 笔亮黄白短笔,按 8fps 换种子沸腾。第一版用 screen 叠加、α0.75,在粉底上几乎看不见,改成 source-over、α0.95 才够亮。
- 墙上阳光区有 60 根斜向亮笔,按 6fps 换种子闪烁。
- 猫毛闪光:60 个候选点,用 `isPointInPath` 限定在猫身和猫头的左半边(受光侧),按 `sin(t·7+h·30)` 明灭。
- 全画 8fps 沸腾,热气白色。

## 性能
两遍全屏笔触加一遍角色笔触,约 69ms。转场时引擎要同时画前后两个时代,08→09 合计约 69+110ms,会超过 150ms,但只发生在转场的那十几帧里。

## v2 返修(审片:整屏每 7–8 帧笔触重洗,帧差 18)
- 笔触位置全部固定:`boil: 0`。**光固定种子不够**:P.strokes 的随机数是一条顺序流,palette 返回 null 时 jitter 会多吃 3 个数;而返回不返回 null 取决于底稿颜色,罂粟一摇、盆栽一摆,后面所有格子的笔就整体重洗。`stable(palette)` 包装成每格只吃 1 个数、永不返回 null。
- 角色笔触不用 alphaMask(端杯一动跳过的格子就变,整层重洗),改成自写循环:每格随机数用 `U.hash(i,j)`。顺带每帧从 115ms 降回 72ms。
- 「活」改由局部运动承担:光斑漂移 ±44px、明灭频率 5–11;罂粟摆幅加到 10+;云横走 45px/s;窗帘和盆栽摆动;窗外花草的笔按风向 ±0.22rad 转角;猫甩尾(×2.2)、扭头(look)。
- 静止段帧差(480×270,屏蔽计数器,去掉段尾转场帧):v1 均值 4.14、峰值 20.5,是频闪;v2 均值 0.57、峰值 1.9。原片 0.77。

---

<a id="09_postimp"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/09_postimp.md

# 09_postimp · 1889 梵高(标杆实现)

文件:`scripts/engine/scenes/09_postimp.js`,每帧约 110ms(全幅三遍笔触)。其他时代照它的结构写。

## 管线
平涂底稿(墙/地/窗/床大面积)→ 流场笔触重画(区域色板)→ 道具层(桌椅花瓶画框吊灯,单独小笔触 source-atop)→ 环境线稿(深蓝 4.5px,8fps 沸腾)→ 角色(平涂 → 细笔触 source-atop → 补线与五官)→ 会动的高光(灯晕虚线环外扩、星星闪、热气)。

## 关键参数
- 方向场:墙竖向 −π/2 ± 0.22·noise;地板沿透视线指向消失点 (960,330);星空沿最近漩涡切线+0.3t 旋转;灯晕沿圆周;床头竖、床单近水平。
- 三遍笔触:非墙非地 cell10 len22 w6.5;墙 cell14 len64 w8;地 cell12 len46 w8。描边 outline 0.8–0.9、混 40–45% 深蓝。8fps 换种子。
- 区域色板(P.swatch,mixBase 0.3–0.45):墙 `#7f9be6 #5f7fd8 #a7bbf2 #6c6fd2 #8ad0e6 #c3cbf6 #4f6cc8 #9a8fe0`;星空 `#22339a #2f4fb8 #5c86dc #8fb6ee #1b2a78 #3c6bd0`;地板 `#c0573c #a8453a #d7774a #8e3b30 #5f8f6a #c96a52 #e08a5c`。
- 猫身上 7 圈橘/浅橘螺旋纹(clip 到身体,0.6rad/s 转)——原片的「漩涡猫」。

## 坑
- 同一参数跑全图会糊成地毯:墙、地、其余必须分三遍。
- 小物件被大笔触打碎:一律拆成道具层。
- 只靠颜色抖动出来的是「同一个蓝的噪点」,梵高的感觉来自区域色板里十几种色相。

---

<a id="10_nouveau"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/10_nouveau.md

# 10_nouveau · 1896 新艺术运动(慕夏海报)

文件:`scenes/10_nouveau.js`(约 300 行)。性能:warm 平均 29ms、最大 37ms,首帧(建缓存)≈80ms;确定性通过(同一 lt 两次逐像素相同);lt 0.35→0.65 运动差分 13.1% 像素。片中停留 0.70s(T09 有机波浪转场 0.24s,从 (1330,320) = 少女光环长出来)。

## 管线
1. **底版全缓存 `nv_bg`**:灰绿→米绿→桃色三段竖渐变(`#b9cba0`→`#cfd3a6`→`#ecc9a2`,只铺内框 34..1886×32..907);圆点花纹 = 环 r10 + 心点 r2.6,行距 54、列距 62,奇数行错 31(菱形交错),色 `rgba(120,140,100,.38)`;240×135 的 fbm 小图放大 α0.5 叠石版斑驳(比全屏算噪声快几百倍);马赛克地砖带 20×24 一格、9 色循环 `(k*7+(k>>2))%9` 打散;绿横幅 `#8fac80`;标题 `Marcellus-400` 76px、letterSpacing 12、先 7px 深棕描边再填奶白;金框 = 外 6px 金 `#c9a24a` + 内外两条 2px 深棕。
2. **可变线宽路径 `ribbon(pts, w(q))`**:点列先 Catmull-Rom 加密(每段 4–10 点),每点沿法线两侧各偏 w/2,拼成闭合多边形 fill。所有「鞭线」都是它:茎、叶、铁艺桌腿、横幅卷草、头发、热气。`swellW(wmax)` = 两头尖中间粗(sin 包络),这就是慕夏线条的粗细呼吸。螺旋收尾 `spiral(cx,cy,r0,a0,turns,dir)`:半径线性收到 15%。
3. **慕夏式「外轮廓粗、内线细」——整体剪影错位法**:角色(猫+少女+头发+披帛)全部画进离屏层 L(RIG 的 both 模式,lw 2 → 内线按部件顺序遮挡正确);再复制 L 用 `source-in` 染成深棕 `#4e3320`,在主画布按 (-1.5,-1.5)、(3.5,4.5)、(2,2.5) 三个偏移垫在 L 下面。结果:剪影外缘一圈 1.5px,右下侧 4–5px 厚边;内部线保持 2px。只多 3 次全屏 drawImage。
4. 颗粒 `P.grain('nv', .05, 暖棕, .14)` 盖最上层,像石版印刷。

## 母题动画(0.7s 内都要看得见)
- **太阳升起**:按原片测量(509 帧 (583,400) → 530 帧 (576,299),≈-5px/帧)写成 `sy = 400 - (lt-0.267)·288`、`sx = 583 - (lt-0.267)·20`,lt=0 时在 477(藏在山后),lt=0.7 到 275。山丘色带画在太阳之后 = 天然遮挡「从山后升起」。
- **铅条光芒转动**:14 根放射铅条从日心 r92→r420,角度 `+lt·0.9·0.25` 慢转并带 ±0.04 摆动;铅条随太阳移动,所以整窗玻璃分割都在变——这是窗里最显眼的动。
- **彩色玻璃边带**:沿拱形内缘(直边+椭圆弧 rx219 ry130)每 17px 放一块 14×14 色片,按切线旋转,6 色循环。
- **罂粟/百合摇摆**:花头水平位移 `sin(7.5t+φ)·13 + sin(3.1t+2φ)·5`,茎是 ribbon 的三控制点曲线只推上段;左右两丛相位相反;叶片 0.3 倍幅度。
- **光环转动**:少女光环 R172,18 颗圆钉 `+0.9t` 转,内圈 32 片玫瑰窗花瓣 `-0.63t` 反转;猫光环 R106 八瓣橙花 `-1.1t` + 金色虚线环 lineDashOffset 走。
- **头发**:先一大块发团(16 点 smooth,外缘按 `sin(6t+y·0.035)·9` 波动),再 7 绺背后卷发 + 2 绺肩前卷发:每绺 12 点 S 曲线 `sin(7.4q+φ-7t)·(6+20q)`(行波往下传)、末端接 1.2 圈螺旋、宽 14–18 → 2.5 递减,奶黄高光芯 + 深金细线。头顶外缘 6 个小卷做体积。所有点跟随 `G.A.headC` 的偏移(喝水仰头时一起动,越往下跟得越少)。
- **S 形装饰热气**:3 条奶白 ribbon(宽 26/20/14)+ 1.8px 棕描边 + 中线,`sin(4q+φ-6t)·(18+70q)` 行波,横向间距随高度 ×(1+2.6q) 散开,末端 34px 螺旋;整体 `lean = -90 - 160·cup` 往左倒——**踩坑**:choreo 把杯子举到嘴边,热气如果竖直升会横穿少女的脸,必须随 cup 往窗那边倒。
- choreo:端杯、仰头、眨眼、甩尾、呼吸全用 RIG;碟子留在桌上(杯子被端走后桌面不空)。

## 色板
线 `#4e3320`;金 `#c9a24a`/`#9c7a2e`;奶白 `#f6eedb`;皮肤 `#f6dcc4`;金发 `#e8bf55`/高光 `#f6dc8a`/暗 `#b9862a`;裙 `#f4ecda`;粉披帛 `#e6aaa5`/褶 `#d48e8c`;罂粟 `#d9706a`/`#b4504b`、花心 `#3f6a4a`+金点;百合 `#f7f2e6`;铁艺 `#3d7763`;猫 `#e39a4c`/`#fbf3e3`/纹 `#c0672c`、眼 `#e6c040`;光环粉 `#ebb8b2`、青环 `#5f9a8a`、猫光环红 `#b8473a`。

## 踩坑
- **`drawGirl(mode:'line')` 叠在最上层会把被遮住的部件轮廓(远侧袖子)画穿躯干**(09 标杆也有)。改成在离屏层里用 both 模式按部件顺序画线,再整体做粗外轮廓。
- 头发最初是 7 条 34px 宽的长带,像香肠/面条;慕夏头发 = 一块发团打底 + 细绺 S 卷 + 螺旋收尾,宽度 ≤18。
- 自检差分别拿 lt<0.33 的帧:引擎在转场开始后 20 帧内有 1.03 倍「拍点冲击」缩放,差分会全屏发红。

## 仍可改进
- 猫仍是 RIG 的坐姿(白色直腿),设定稿是趴卧的毛茸茸橘猫;慕夏味主要靠光环和粗细线撑。
- 标题用 Marcellus,设定稿是更圆的手绘新艺术字形;可以手写一套字母路径。

---

<a id="11_cubism"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/11_cubism.md

# 11_cubism · 1912 分析立体主义(毕加索/布拉克)

文件:`scenes/11_cubism.js`(约 280 行)。性能:warm 平均 13ms、最大 19ms,首帧(建缓存)≈100ms;确定性通过;lt 0.34→0.46 运动差分 6.9% 像素。片中停留 0.47s(T10 碎片转场 0.24s)。

## 管线
1. **底版全缓存 `cb_bg`——「透明叠面」**:核心函数 `plane(g, pts, col, alpha, r)`:每块面一条线性渐变,起点取第 0 顶点、终点随机取另一顶点,三个色标 = 混 25% 米白 → 原色 → 混 40% 深棕,alpha 0.18–0.7。叠法:18 块手排大面(照原片构图位置)+ 桌下 9 片放射扇面(自 (1000,1090) 发出,亮暗交替 α0.3)+ 70 片随机 3/4 边形(避开右上年份区)。多层半透明渐变叠起来就出现分析立体主义那种「透明、互相穿插、每面一亮一暗」的空间。
   - 肌理面:4 块点画(9px 菱形格 r1.6)、4 块排线(7px 间距斜线)、左缘一页横线纸。
   - 布拉克短划砂纹:9000 个 3–8×1.5px 小划,55% 米白 α0.28 / 45% 深棕 α0.16——原片那种「砖纹」质感就靠它。
   - 46 条贯穿细直线(1.3px α0.55)= passage。
   - 仿木纹 `wood()`:沿长边画 S/6 条波浪线,过节疤位置加高斯鼓包 `14·exp(-(u-k)²/0.01)`,节疤 4 圈椭圆。用于桌面和右侧木板(布拉克的梳纹假木)。藤编椅背 = 10px 菱形孔点 + 双向斜线。
2. **窗格碎面滑动**:窗景单独缓存成 560×540 大图(55 片蓝灰切面 + 3 条斜光束 + 埃菲尔铁塔 + 海鸥弧),四格各自 clip 后以不同偏移取景 `dx = sin(9lt+1.7i)·18 + 10fps 抖动 ±3`、`dy = cos(7lt+i)·8`——同一窗景在四格里错位 = 多视角拼合;每格另有一片半透明三角以 260px/s 横向滑过。
3. **CAFÉ 模版字跳动换位**:`AlfaSlabOne-400` 104px 画进离屏小层,12fps 卡点(`st=floor(lt·12)`),顺序表 `CAFÉ/ACFÉ/CAÉF/CFAÉ` 轮换,每步每字 y ±13、旋转 ±0.11rad(hash 取);然后 `destination-out` 切出横竖断口 = 模版字(断口透出底下的叠面,比画纸色条真实)。
4. **报纸 JOU**:缓存 300×190 小图(LibreBaskerville-700 84px「JOU」+ 12px 标题「LA BATAILLE / S'EST ENGAGÉ UN CHAT」+ 三栏灰色假字),每帧以 8fps 微颤(旋转 ±0.0125rad、x ±1.5px),右上折角按 `sin(20lt)` 翻。
5. **角色 = 自写切面器 `facetize`**:RIG 平涂(fill 模式,无线)进离屏层 → 读回该包围盒像素 → 抖动三角网(每格随机选对角线)→ 每个三角在质心取色,`×(0.8+0.38·rand)` 明暗、再做一条从顶点 0 到顶点 2 的亮→暗渐变 → **三角不裁剪**直接画回去(质心 alpha<120 的跳过)。不裁剪是关键:剪影边缘被切成锯齿直边,有的三角还伸出轮廓外——就是立体派「平面溢出轮廓」的感觉。
   - 少女 cell 58(大面),发区再用 cell 26 细切一遍、只切「像金发的颜色」(`only: R>150 && B<130 && R-B>60`),猫 cell 26。
   - 顶点每 8fps 抖 ±8% cell、16–35% 的三角明暗跳 ±12%(boil)→ 角色在「微动」,原片 548–562 帧猫区域就是这样。
6. **切完再补毕加索式的结构**:脸重铺两块肤色明暗面(切面会把金发色带进脸)+ 前半张脸蓝灰面 α0.82 + 正面杏眼(侧脸上画正面眼)+ 螺旋耳 + 红唇;白领两块明暗三角 + 三颗扣;裙摆从腰部 8 条放射切线 + 亮暗交替楔面;外轮廓用直线段 `segs()`,每段两端各外伸 10–16px(线画出界)。猫:六边形直线头轮廓、`bodyPts` 直线身轮廓、黄色菱形眼 + 竖瞳、侧面三角鼻。
7. 最上层 5 片 α0.2 的叠面压在人和猫身上并以 `sin(6lt)·8` 错动——把角色「嵌」进空间,不像贴在背景上。

## 色板
纸 `#d6c8ac`、米白 `#ece3cf`、赭 `#b8975f`、棕 `#6e5538`、深棕 `#3a2c1e`、灰 `#a8a395`、蓝灰 `#8e9eab`、暗灰 `#5a5852`;窗景 `#c9d3da/#8fa3b3/#e4e6e2/#6f8597/#b4c1cb/#5f7385`;裙 `#6a7a8b`、袖 `#3c4857`(必须比裙深,否则端杯的手臂整个融进裙子切面里)、皮肤 `#e2cfae`、金发 `#c9a256`;猫 `#c8773a`/`#e8dfc9`。

## 踩坑(重要)
- **不确定性:第一帧和之后不一样。** 两个原因叠加,都只在第一帧出现:① 要 `getImageData` 的离屏层第一次画时走 GPU,读回后 Chrome 把它转成 CPU 光栅,抗锯齿不同 → 质心取色不同 → 三角颜色不同;② 更主要的:离屏层的 context 状态(facetize 里设的 `lineJoin='round'`、segs 的 `lineCap='round'`)会残留到下一帧,第一帧用的是默认 miter/butt。修法:自建层 `getContext('2d',{willReadFrequently:true})`,**每帧开头用 `g.reset()`(清像素 + 清状态)而不是 `clearRect`**。用 hash 对比「同一 lt 连渲三次」才查出来。
- 切面 cell 34 时满身小三角,像 low-poly 3D 模型而不是立体派;58 才有「大块明暗面」。
- 第二遍发区细切一开始用圆形 clip,把半张脸也切成了金色——加了按颜色过滤的 `only`。

## 仍可改进
- 少女整体轮廓仍是 RIG 的写实曲线,切面只改了边缘;更彻底的做法是把肩、肘、膝都换成折线骨架再切。
- 原片色调更暗、明暗对比更强(大块深褐面更多),我这版偏亮。

---

<a id="12_bauhaus"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/12_bauhaus.md

# 12_bauhaus · 1923 包豪斯海报

文件:`scenes/12_bauhaus.js`(约 210 行)。性能:warm 平均 5ms、最大 9.5ms,首帧≈85ms;确定性通过;lt 0.34→0.46 运动差分 4.9% 像素(黑杆、格窗、同心弧、猫、球、人偶都在动)。片中停留 0.47s(T11 蓝方块/红圆/黄三角/圆孔转场 0.20s,原点 (1330,590) ≈ 红圆圆心)。

## 管线
1. **底版全缓存 `bh_bg`**:米白旧纸 `#ebe3cf` + 320×180 fbm 小图放大 α0.5(做旧斑驳)+ 贯穿细斜线 (40,170)→(1900,840)(压在窗后)+ 左上黑横条 (60,61,256,13)、红竖条 (292,105,24,468) + 竖排 bauhaus(`Poppins-800` 210px,`rotate(-π/2)` 后水平缩放到正好 820px 长,原点 (262,1000) 自下而上读)+ 灰小方块 + 地线 (345,898)-(1860,915) + 黄直角三角 + katze(Poppins-800 150px,红 `#d3262b`)+ 右下两行 Poppins-600 31px + 黑面桌/镀铬管腿(三色线性渐变)+ 布劳耶悬臂椅(同一路径描 15px 深灰 / 10px 镀铬 / 3px 高光偏移 2px)+ 两层颗粒(暗点 0.02 密度 α0.35,旧印刷黑斑)。
2. 红圆单独缓存 520²:底色 + `source-atop` 叠 fbm 浅色斑 α0.55,模仿丝网/石版的不匀墨。
3. 角色、构成全是几何体:没有任何曲线描边,只有圆、方、三角、粗杆。

## 母题动画
- **斜长黑杆像指针转**:按原片逐帧量的角度(575–579 帧 28°,581 帧 33°,583 帧 37°,585 帧 42°,587 帧 46°,591 帧 49.5°)写成 `deg = 28 + 21.5·easeOut(clamp((lt-0.26)/0.22))`。转轴 = 毂心 (1125,195)(原片对比 576/590 帧确认:毂不动、下端扫下来),杆 27px 从 -432 到 +150,细平行线偏 30px,红短杆偏 -30px,毂内弧跟着转。
- **蒙德里安格窗轮换**:4×4 格(内框 366..794 × 126..561,格 100×101、缝 9.5),6 个格子参与轮换,13fps 卡点 `step=floor(lt·13)`,每格相位不同、`(step+2·sw)%9 < 6` 才换(不是每拍都换,节奏不机械);轮换色只用红黄蓝米浅蓝灰。图样格(9px 方格纸)、四分之一圆格保留。
- **同心弧**:红圆右侧 6 条弧,起点相位 `sin(9lt-0.7i)·0.05` 波动、半径 `±3` 呼吸、弧长在 0.4s 内从 55% 扫到 100%——像声波往外推。
- **杯上热气**:一根 2.2px 正弦细线(26 个周期/170px、`-18t` 行波),线性渐变淡出。
- **猫拨球滚一下**:右前爪 `tap = sin(clamp((lt-0.05)/0.16)·π)` 往前伸 36px 再收;蓝球 r31 在 `lt 0.13→0.47` 以 easeOut 从 x712 滚到 816,**转角 = 位移/半径**(白直径线+白点看得出在滚),滚动中身后两条速度线。尾巴 = 26px 粗橙弧 + 同宽虚线深橙条纹,角度跟 `choreo.tail·0.5`。

## 角色的几何化(锚点全来自 RIG)
- **施莱默人偶**:头 = 圆 r70(`G.A.headC + (14,-18)`),金色几何发片 = 后半个头的扇形(-1.95→1.15rad)+ 额前三角 + 发髻圆 r34 + 背后半圆发片(`G.A.back`);脸 = 黑竖条眼(眨眼变横条)、红方腮、短黑口。头部整组绕 `G.A.neck` 按 `G.tilt` 转(喝时仰头)。躯干 = 蓝梯形 + 后半黑梯形(随 breathe 起伏);裙 = 黑扇面 r178 + 蓝梯形;四肢 = 粗黑圆头杆,关节 = 米白圆盘 + 5px 黑圈 + 黑心点。近侧手臂直接用 `G.A.shoulder/elbow/hand`(RIG 的 IK 端杯),远侧手臂平放桌上(复现原片那只伸向桌面的手)。
- **猫**:身体圆 r100(`K.box` 推算的 (536,805),随 breathe 缩放)+ 左侧 4 条深橙横条(clip 在圆里)+ 右下米白扇面(橙白块面);头 = 104 方块(`K.headC + (14,48)`,随尾巴相位微转 ±0.08rad)+ 黄三角耳 + 米白下半脸 + 深橙额带;眼 = 白圆 + 黑竖条瞳。

## 色板
纸 `#ebe3cf`;黑 `#161514`;红 `#d3262b`;蓝 `#2a58b4`;黄 `#efc12f`;浅蓝 `#b9cee0`/`#a6c0da`;灰 `#c6c3bb`;米 `#f2ecdf`;橙 `#ee8a2a`/`#c25a14`;镀铬 `#c9c9c6`。

## 踩坑
- 第一版格子按 107px 算,右侧溢出黑框 16px——格窗尺寸要从「内框宽 - 3 缝」反推。
- 轮换色里放了黑色,换到黑格时整窗突然变重、像坏格子,删掉。
- 人偶嘴原本照原片画成伸出头外的长黑杠,放在少女脸上像叼烟,改成头内短横。

## 仍可改进
- 猫头/身体的位置相对 RIG 骨架做了下移(为了方头压在圆身上),转场时与前后时代的猫头位置差约 50px。

---

<a id="13_pop"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/13_pop.md

# 13_pop · 1962 波普(利希滕斯坦漫画格+沃霍尔四宫格)

文件:`scenes/13_pop.js`(约 230 行)。性能:warm 平均 6ms、最大 9ms,首帧≈45ms;确定性通过;lt 0.34→0.46 运动差分 11.6% 像素。片中停留 0.47s(T12 黄闪电网点化转场 0.16s)。

## 管线
1. **本戴点 = `createPattern`,零成本**:一个 pitch×pitch 的小 tile 画 4 角 + 中心 5 个圆 = 45° 网格(对角间距 pitch/√2)。墙:pitch 24、r5.6、蓝 `#2f5cc8` 底白(对角 17px,与原片 FFT 量的 17px 周期一致);皮肤:pitch 13、r3.3、红 `#e2483c` 底肤色 `#fae0cc`;黄地:pitch 14 r2.2 α0.18 隐约印刷点。皮肤用 `fillStyle = pattern; fill(path)`,比 `PAINT.halftone`(逐点 getImageData)快两个数量级,而且图案对齐屏幕坐标、不会随角色移动「游泳」。
2. **底版全缓存 `pop_bg`**:漫画格外框 6px 黑;白踢脚线 754–792(上下 6px 黑线);黄地 796→990/1003(地平线略斜);红带;MEANWHILE...(`Bangers-400` 46px,黄底黑框 5px);沃霍尔白画框+窗台蓝线;蓝椅;纸面颗粒。
3. **所有角色都是「粗黑描边 5px + 平涂」**,`ink(c, path, fill, lw)` 一个函数到底;高光用白色粗短线;阴影用 `hatch()`:椭圆 clip 内画 10px 间距、3.5px 宽的黑斜线。

## 母题动画
- **沃霍尔四格换配色**:4 套配色(底/脸/下半脸/眼影/口红),`step = floor(lt·11)`(≈每 5.5 帧换一次,原片 601、605/606、612 帧换),格 i 用第 `(i+step)%4` 套。猫脸 = RIG.smooth 的 9 点头型 + 下半脸椭圆 + 右侧黑块(丝网错版的黑影)+ 眼影/口红/鼻/胡须;右上格两道白色玻璃反光。
- **思考泡泡三点依次闪**:原片「点1 612–615、点2 614–617、点3 616–618 帧」→ 每 12 帧一循环,点 k 在 `((f-2k) mod 12) < 4` 时亮(r20、上跳 6px),否则 r12。泡泡 = 10 个圆先统一描 11px 黑再统一填白(并集轮廓的最省写法)。
- **WIGGLE WIGGLE 爆炸框抖**:30fps 卡点 hash 抖动 ±8px/±6px/±0.03rad;外层白爆炸(14 尖,半径 128/178 带随机)+ 内层黄爆炸 + 两行 `Bangers-400` 82px 红字(12px 黑描边 + 4px 黑投影);外围 10 根黑三角动作线长度 `0.85+0.25·sin(40lt+2i)` 脉动。
- **猫扭屁股准备扑**:用 RIG.cat 的锚点做时代化变形——趴低:身体用 10 点自定轮廓(以 `K.box` 为原点),头 `K.headC + (22,104)` 压低贴身,前爪白椭圆往前伸;扭:`wig = sin(lt·2π·6)·16`(6Hz,0.47s 里 ~3 次),点的权重 `clamp((560-x)/140)` → 越靠屁股位移越大,并同时上翘 `|wig|·0.6`;条纹、尾巴跟同一变形走;屁股旁三道弧形动作线跟着 wig 移动。
- **少女端杯**:RIG IK 端杯;杯 = 白杯 + 蓝斜条纹 + 咖啡;热气两条 14Hz 抖动的黑波浪线。

## 少女(利希滕斯坦)
- 金色大波浪:发团(19 点 smooth,后缘 `sin(2.1i+4t)·14` 鼓包)+ 7 个卷团圆(r30–48,沿后缘排),**先全部描 10px 黑、再全部填黄 = 并集轮廓**;每个卷团里一道 4.5px 黑 C 形弧 + 一道深金 `#d9a514` 弧 = 利希滕斯坦那种雕塑感卷发;5 条黑色 S 发丝、2 道白高光。
- 皮肤(脸、颈、手、腿)全部红本戴点;红裙(截到膝,裙摆 clip 用曲线不是矩形)+ 白高光条;两条点点腿 + 红高跟(7 点多边形);大眼(白眼 12×8.5、蓝虹膜 r7、高光点)+ 3 根粗睫毛 + 眉毛上移 5px;红唇放大。

## 色板
黑 `#141414`;纸 `#f3eedb`;蓝 `#2f5cc8`;黄 `#f7d52c`;红 `#d8232a`/`#a8161c`;白 `#fbf8ee`;皮 `#fae0cc` + 点 `#e2483c`;金发 `#f8d62c`/`#d9a514`;猫 `#f39a2c`/`#c4561a`;沃霍尔底色 `#9ccf3a/#e0359a/#2fc0b0/#f08a2a`。

## 踩坑
- 猫头按 RIG 原位置画会悬在趴低的身体上方(空一截),趴姿下头要下移 ~100px 压进身体。
- 头发第一版只是一整片带轻微波浪的黄色,远看像披了块布;利希滕斯坦的金发辨识度来自「卷团 + 黑色 C 弧」。

## 仍可改进
- 原片少女有泪珠和白领子(经典利希滕斯坦哭泣女孩),设定稿去掉了,我也没加;想更「漫画」可以加一个对白框。

---

<a id="14_8bit"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/14_8bit.md

# 14_8bit · 1985 8-bit 像素游戏

## 管线
1. **整幅在 240×135 低分辨率画布上画**(1 低像素 = 8 屏幕像素,原片实测像素块就是 8px),最后 `imageSmoothingEnabled=false` 一次性 `drawImage` 放大 8 倍。
2. **背景逐像素 `fillRect`**(缓存 `8b_bg`):十字点纹墙=6px 网格、隔行错 3px 的 3×3 十字;木地板条 y=106–113,每 24px 一道黑缝;砖块 16×6+1px 缝,隔行错 8,上沿和左沿一行米色高光(`#fbe2a6`)。窗里天空用 3 档蓝(`#0856ef / #47c4f8 / #aae9fb`),交界 ±0.05 的带子做 `(x+y)%2` 棋盘抖动——这是 NES 做渐变的唯一办法。
3. **角色=RIG 路径缩到低分辨率填色 → spriteize**:每个部件单独一层(远侧手臂 / 身体腿 / 头发 / 脸 / 刘海 / 近侧手臂;猫身 / 猫头),每层:
   - `getImageData` → alpha < 110 直接透明(去抗锯齿)→ 其余量化到 14 色角色调色板(最近色);
   - 外轮廓描 1px 黑边(透明像素的 4 邻域里有不透明像素就涂黑)。
   **分层描边是关键**:只描一次整体外轮廓时,头发/脸/手臂糊成一块;每个部件单独描边才有 NES 精灵那种内轮廓。
4. **五官全部逐像素点**(眼 1×2 黑+眉,猫眼 2×2 黑+左上 1 白高光,粉鼻 1px,腮红 2×1),用 RIG 锚点 `/8` 取整定位。
5. **马克杯不用 RIG.drawCup**:AA 路径缩到 6px 宽会糊,直接在低分辨率上画 6×5 白杯+两道红条+3px 把手,跟着 `G.cup` 走。
6. **HUD 在全分辨率画**:`PressStart2P` 48px(字体 1 像素 = 6 屏幕像素,64px 太宽会让 WORLD 1-1 撞上苹果图标),8px 黑投影;猫头/心/苹果图标是字符串位图,每格 8×8。

## 牛仔裤
RIG.girl 是长裙,8-bit 版用两段 `RIG.taper`(髋 `G.hipSeat`→膝 (1222,724)→踝 (1214,872),宽 92/76/56)画蓝裤,远侧腿深一档 `#0838a8` 错后 26px;白球鞋+一道红条。

## 小循环(片中只停约 0.23s ≈ 11 可见帧,全部做成步进动画)
- 猫尾:15fps 四姿态循环 `[-0.55, 0, 0.55, 0]`(RIG.cat 的 tail 参数),像素动画的「几张图交替」。
- HUD 心闪:lt 0.16–0.23(≈ 630 帧)每 2 帧一换:满心变白、空心变满红。
- 盆栽抖:同一窗口里叶子整像素 `[0,1,0,-1]` 偏移。
- 问号块顶出金币:lt 0.06–0.22 半正弦上 9px 再落回。
- 窗外云 2 帧左移 1px;像素热气三列 1×2 点、30fps 每帧上移 1px、6px 循环。

## 踩到的坑
- RIG 猫头顶到 y≈535,会压住窗台(窗到 y=590)。这是共用骨架的位置,没挪;8-bit 黑描边让重叠更显眼,但转场依赖标准构图,保留。
- `spriteize` 读的是非预乘 RGBA,别再除 alpha。
- 性能:热帧 2.5–6ms,冷启动 11ms。

---

<a id="15_raytrace"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/15_raytrace.md

# 15_raytrace · 1993 早期光线追踪 CGI

不用 3D 引擎,靠 2D Canvas 的「着色约定」假装是渲染器出图。

## 塑料着色(每个部件都过一遍)
`plastic(c, path, base, hx, hy, R)`:
1. 底色填充;
2. 以高光点 (hx,hy) 为心、半径 R 的径向渐变:0→白 .55,0.28→白 .06,0.62→透明,1→深紫 `rgba(10,0,30,.42)`(边缘压暗=体积);
3. 环境反光:`lighter` 叠一圈 `rgba(70,150,150,.28)` 的描边,宽 0.18R,向左偏 0.04R——墙是青绿色,反光就是青绿色;
4. 一颗硬边白色椭圆镜面高光(0.16R × 0.09R,透明度 .85)。这一笔最像 90 年代 Phong。

肢体用 `cyl()`:渐变横跨肢体法线方向(暗 .25 → 白 .5 窄带在 22% 处 → 暗 .45),再沿 20%–75% 画一道白色细高光线。
少女用 RIG.girl 的 Path2D(长发),裙子换成蓝色塑料圆柱腿+膝盖球关节,肩膀加球关节——就是「玩具人偶」的关节感。
RIG 的猫身是折线,塑料感会露出棱角:先 `RIG.smooth(K.bodyPts)` 再着色。虎斑用 `filter: blur(2px)` 画成「印在塑料下面」的软条纹。

## 场景
- 墙:径向渐变 `#7dbcb9 → #64a6a6 → #3f8285`,光源在窗的位置;窗的投影 `blur(10px)` 偏右下。
- 窗外:粉紫渐变天(`#a24cc4 → #df62ae → #f5a08a → #f8c070`),两层山,山体上叠 28×26 的粉色线框网格(早期 CG 的 wireframe 地形),雪顶是锯齿三角。
- **地面**:逐像素透视棋盘,消失点 (960,480),`X=(x-960)/dy, Z=1/dy`,格子 TX=0.27、TZ=0.00029,2×2 超采样抗锯齿,近墙 140px 内加 35% 雾。缓存,冷启动整场 53ms。
- **反射**:物体层(椅/桌/少女/猫)画在离屏层,`translate(0, 2*906); scale(1,-1)` 镜像、`globalAlpha .34` 画进地面裁剪区;道具各按自己的接地线镜像(锥 780、紫环 846、铬球 800),并**先画到独立层再整体半透明**——否则紫环的 140 颗小球各自 .34 叠加会变成不透明。
- 玻璃桌:半透明绿椭圆+厚边+白描边,一条斜向反光每秒滑 260px。

## 小循环(0.23s 内要看得见)
- 紫环:140 颗球沿圆环排布,绕竖轴以 7 rad/s 自转、倾斜 0.35,按深度排序画(先一层暗紫底让球连成管,再逐颗径向高光)。0.23s 转 1.6 rad,从正面转到侧面,非常明显。
- 铬球:每帧逐像素环境映射(反射向量向下→棋盘,向上→粉紫天+一条窗光),棋盘 u 坐标随 `t*4.5` 平移=在转;菲涅尔边缘提亮。直径 104px,每帧 <2ms。
- 镜头光晕(`lighter`):日芯辉光 170px 以 23 rad/s 脉动 ±8%;12 道星芒以 1.6 rad/s 旋转;水平长条光 960px;5 个鬼影(圆+六边形)沿「太阳→画面中心」直线排布、随 `sin(t*5)*0.03` 滑动。
- 猫眼绿光:`lighter` 径向渐变半径 46px,以 18 rad/s 脉动 ±25%。
- 端杯(choreo.cup)、甩尾、眨眼、热气照常。

## 坑
- 转场 wireframe 用新画面第一次出现时的帧算边缘并缓存(`once('edges')`),所以 lt≈0 那一帧要完整——别在 lt=0 留空白或淡入。
- 性能:热帧 23ms,冷启动 53ms。

---

<a id="16_2026"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/16_2026.md

# 16_2026 · 2026 扁平矢量插画 + 全片笑点收尾

所有表演用**全片帧号 `F = t*60`** 写,关键数字逐条照抄 `../拆解/分镜表.md` §4,方便和原片逐帧对表。
对照接触表(左原片|右复刻):`../渲染/16_2026/cmp_E1…E4_*.jpg`,片段 `clip_2026.mp4`(10.8–15.06s)。

## 画风(Dribbble 扁平+颗粒)
- 纯色块、无描边;体块只靠「同色系深一档的色块」分(毛衣亮面斜块 `#f08b7d`、猫大腿 `#f3ad4c`+一道深色弧边)。
- **颗粒点彩 `stipple()`**:在形状里撒 2px 方点,密度是位置函数——粉圆 `0.12 + 0.75·clamp((y-cy+120)/420)`(越往下越密),淡紫块往右下密,太阳往右下密。静态部分全进缓存 `fl_bg`。
- 角色层画完后用一张静态颗粒纹理 `source-atop` 叠上(5% 暗点 α70、3.5% 亮点 α90),颗粒只落在角色身上。
- 光锥:26000 个点、宽度随 y 线性 56→150、透明度随 y 衰减、靠中心更密,缓存成 340×420 贴图,跟吊灯一起绕 (1010,0) 摆。

## 少女(RIG 基础上自写姿势)
- 躯干/颈锚点:`RIG.girl({s:1.12})`;头部再调一次 `RIG.girl({s:1.344, dy:43.7})`——相当于头部围绕颈点放大 1.2 倍,扁平插画的大头比例。脸、刘海、后发、丸子、眼/唇/耳锚点都取自它。
- 手臂:`RIG.ik2(肩, 目标, 150, 140, -1)`,三套目标点按进度混合:打字(两手在键盘上以 22 rad/s 交替起落 7px)→ 摸猫(688–704,近手在猫背上画小圆)→ 惊呼(791–798,`ease.outBack` 举到下巴前,手指张开)。
- 表情:闭眼弧+上扬嘴(<686)→ 圆点眼+高光、小 o 嘴(686 起,o 用 outBack 弹出)→ 大眼+大张嘴+舌头(791 起)→ 838 帧后改成挤眼「<」(原片终帧也是闭眼)。
- 紧张线:3 道,从头顶前上方放射,长度 outBack 弹出;颜色 793 淡粉 → 796 全红(RGB 插值);830–888 每 2 帧随机抖 ±2.5px,头部同步抖 ±2px。
- 裤腿/袜/鞋自画(RIG 是长裙)。

## 猫(姿势库 + 插值)
每个姿势是一组局部关键点(朝右、原点=质心):身体 10 点、白胸 6 点、大腿椭圆、背纹 3 段、头、两前腿、后腿、尾巴 4 个贝塞尔点、gy(脚底到质心)。
姿势:`SIT_F`(地上坐,从原片 10.95s 量)、`SIT_T`(桌上坐,原片朝左实测后镜像成朝右存)、`LEAP`(水平拉长)、`LAND`(前爪向下)。`mixPose` 逐数值 lerp。
变换:`translate(质心) → [绕脚底 或 绕质心] rotate → scale(dir·sx, sy)`,挤压拉伸都绕脚底,所以蹲下时脚不离地。

| 帧 | 表演 | 做法 |
|---|---|---|
| 657–661 | 预备下蹲 | sy 1→0.86、sx 1→1.07,头低 8px |
| 661–664 | 蹬地 | 切到「绕质心」、rot→-0.75、sy→1.12(拉长),姿势混 45% LEAP |
| 662–684 | 弧线 | 质心用分镜表 12 个实测点 Catmull-Rom;rot = 切线角×0.8,679 起逐渐放平;670–676 sx→1.12 / sy→0.9 |
| 664–672 | 起跳烟尘 | 4 团米色圆往外扩、变淡 |
| 684–690 | 落桌挤压 | 混 LAND,sy 0.86→0.70,sx→1.18,脚底钉在 y=628(笔记本面) |
| 690 | 翻面 | 压到最扁的那一帧 dir 从 +1 跳 -1(限帧动画的 snap,比 2–3 帧的「纸片翻转」干净) |
| 690–698 | 坐起 | 混到 SIT_T;sy 0.96→1.07(694 过冲)→1.0 |
| 685–689 | 笔记本盖被压上 | 屏幕绕铰链转 -1.91→0.02 rad;「•••」输入气泡缩没 |
| 724–812 | 盯杯子 | 身体绕脚底前倾 0.08 rad,瞳孔左移 4px |
| 744/766/786 | 三次拍杯 | 每次:预备 7 帧(爪抬到胸前)→ 击出 4 帧 → 停 4 帧 → 收 8 帧;前倾量 = 0.1+0.28·clamp(肩到杯沿距离),越远越趴 |
| 835– | 得意 | 闭眼弧+大腮红;856–875、886–892 换 ∩∩ 开心眼 |

**拍杯对准的关键**:先按世界距离算前倾、施加前倾变换,再用 `c.getTransform().invertSelf().transformPoint(杯沿)` 把杯子右沿换回局部坐标当爪子目标。直接按未前倾的坐标算,前倾 0.38 rad 后爪子会往下偏 60px 戳进桌面。

## 杯子与碎裂
- 杯子 x:分镜表 16 个实测点线性插值(744:981 … 796:801);790–796 开始外倾 -0.12。
- 坠落 796–815:9 个实测中心点 Catmull-Rom(实测重力≈1.75px/帧²),旋转 `-0.12 - 2.3·q^1.3`;身后 6 颗咖啡滴取杯子过去 1.3 帧间隔的位置、越早越小。
- 815 落地:7 道冲击放射线 8 帧淡出;两块大碎片用分镜表三点(818/824/834)拉格朗日抛物线,834 落地后停住;9 颗小碎屑抛物线、各自落地高度 893–911 停住;咖啡渍宽 818:140 → 822:220 → 826:235(ease.out);两圈灰涟漪扩到 560/460 宽、838 前淡出;把手半圆+茶包标签留在地上。
- 拍杯动线:杯子右侧 3 道短线,击中后 12 帧外扩淡出。

## 环境二次动作
- 吊灯:`damped(F, 686, 0.055rad, 周期26帧, 衰减22帧) + damped(F, 830, 0.045, 22, 20)`,光锥一起摆。
- 植物:`damped(F, 697, 0.035, 22, 18)`(晃)+ `damped(F, 821, 0.05, 9, 26)`(抖,周期短);龟背竹每片叶再加一点相位不同的自摆。
- 云 15px/s 左移(0.25px/帧);小飞机 177px/s 拖虚线尾迹(12.0s 在 x≈440、13.75s 在 x≈750,对上原片);太阳光芒 0.35 rad/s 转;17 个装饰符号 4fps 沸腾(±1.5px、±0.09rad)。

## 签名
`window.SIGNATURE || 'Opus 5.5'`,Caveat-600 64px 缩放到宽 236px,起点 (1614,1032) 微倾 -0.03;书写前沿 x 用分镜表 842:1606 → 870:1868 逐帧插值,`clip` 揭示;下划线 24 段、线宽 3.4→1.4 渐细,同一个前沿一起画出。

## 性能
热帧 5–12ms,转场首帧(含缓存构建)31–64ms。

---

<a id="17_ink"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/17_ink.md

# 17_ink · 中国水墨写意(八大山人/齐白石)

> 来源:迁移测试 A(只读 skill 的独立 agent 实做,2026-10-04)。场景代码由整合后移植到 `scripts/engine/scenes/17_ink.js`。

实验时的文件名 `scenes/01_ink.js`(313 行)。帧差 0.45↔0.9s 为 3.3%(阈值 24),相邻帧中位 0.62%,没有静止帧对。

**管线**(和 09 标杆相反:纸是底,墨只加不铺)。开场 `lt += 0.12`,第 0 帧已经落下前几笔,不是一张白纸(审片指出白纸首帧不能当封面)。
宣纸(缓存)→ 晕染层:淡墨远山、朱日 → 雾带(纸色模糊椭圆横移)→ 掠过的小鸟 → 静态笔触:窗、案、地线,写完缓存 → 竹枝(个字叶)→ 挂轴里的齐白石虾 → 猫:赭石晕染+焦墨 → 少女:花青晕染+白描+衣纹 → 热气游丝 → 钤印。

**宣纸**
`P.texture('#efe6d0', scale .0025, amt 9, grain 7)`。上面叠 2600 根纸纤维短弧:一半褐色 α.05–.13,一半亮色 α.12–.27。再加径向暗角,到边缘 α.22。

**毛笔 `brush(c, pts, {w, tone, dry, reveal, bristles, head, tail})`**
- 点列先 Catmull-Rom 加密,再按 4px 等弧长重采样(`KIT.resample`)。不重采样的话,飞白噪声的频率会随笔画长短变化。
- 笔压:`prof(q) = smoothstep(0,head,q) · (1−0.7·smoothstep(1−tail,1,q)) · (0.85+0.15·noise)`。
- 湿笔芯:整笔都用 ribbon 填,宽度 `w·prof·(1−0.85·dry·q^0.8)`,α 为 tone×0.72。越往后越细,表示墨在用完。
- 笔毛:每根一条**连续**折线,横向偏移 ±0.475w·prof。噪声 `noise(k·1.9, i·0.09)` 低于 `dry·q^1.2·0.95+0.05` 时断开,露出的纸就是飞白。
- 坑:第一版按「每一小段单独 stroke+round cap」画笔毛,接头处叠出一节节深点,看起来像竹节或麻绳。必须改成每根笔毛一条连续 path、butt cap。
- 参数:窗框 w14–18、dry .45–.6;案面 w22;衣纹 w4–6、dry .3–.4、tone .78;地线 w5、dry .85、tone .35。

**晕染层 `washLayer`**
- 形状先画在 scratch 上,再用 multiply 合到纸上,分两遍。
- 外晕:`blur(halo·(0.4+grow))`,α 为 haloA·grow。
- 本体:`blur(blur·(1.6−0.6grow))`。
- grow 按 lt 从 0 走到 1:开场是从无到有洇开,之后外晕继续慢慢变宽,这就是「墨在纸上晕开」。
- 少女 halo 12、α.6;猫 halo 9、α.78;远山 halo 14。

**留白**
- 猫的白色部分(口鼻、胸、爪)用 `destination-out` 从赭石层里挖掉,露出纸色。这比画白色更有水墨味。
- 少女的交领内衫也这样挖掉。
- 面部用纸色填,再用 1.8px 焦墨白描勾。

**色**
- 墨 `[16,14,12]`,用 tone 分出五色(焦 .9/浓 .8/重 .6/淡 .35/清 .15)。
- 赭石(猫)`#c47a3c`;花青(衣)`#6f8aa0`、广袖 `#7d97ab`;藤黄(金发)`rgba(226,170,52,.75)` multiply。
- 胭脂红只点三处:腰带、发簪珠、点唇,用 `[190,40,40]`。另有朱日 `#d8553f`、钤印 `#c4281e`。

**母题动画**
- **开场写出**:lt 0→0.45,每笔 `reveal = ss(d, d+l, lt/0.45)`,按窗、案、竹、猫、人的顺序依次写出。
- 竹:分节淡墨主枝,绕 (835,70) 摆 `sin(2.9t)·0.11`,越往枝梢越大。5 组个字叶各 3 片(L110、w15),翻动 `sin(7t+g)·0.2`。
- 雾带:4 条纸色椭圆,blur 14、α.72,以 150–270px/s 横移,远山时隐时现。
- 八大式小鸟:从窗右侧以 420px/s 掠过,翅膀两笔,每秒约扇 8 次(`sin(52·lt)`)。
- 齐白石虾(挂轴里两只,1.45 倍):6 节淡墨节+头胸甲中间一笔焦墨,两长两短须做行波,三节长钳,身体弯曲 `sin(7t)·0.12`,沿曲线游动。
- 八大白眼:猫的瞳点顶到眼眶上方,「白眼向天」。
- 钤印:lt 0.3–0.4 从 1.5 倍压到 1 倍,multiply 盖上;白文「白石」。

**坑**
- 静态笔触在写出期间实时画,写完一次性缓存成 `ink_static`,否则每帧要画几千根笔毛。
- 小鸟第一版的路径穿过竹叶丛,看不见,改到雾带上方 y≈470 才读得出来。
- 晕染用的是 multiply,透明,所以窗台墨线会透过猫的耳朵,桌腿会透过裙子,审片读成「层级错了」。修法是在猫和衣裙的剪影里先补一层纸色(clip 后 drawImage 纸),再上晕染。这等于在纸上「先留出这块地方」。

---

<a id="18_klimt"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/18_klimt.md

# 18_klimt · 克里姆特金色时期(1907)

> 来源:迁移测试 A(只读 skill 的独立 agent 实做,2026-10-04)。场景代码由整合后移植到 `scripts/engine/scenes/18_klimt.js`。

实验时的文件名 `scenes/02_klimt.js`(223 行)。0.45↔0.9s 为 32.9%(主要来自流光),相邻帧中位 0.40%,但 48 对里有 14 对几乎静止(见 ②-2)。

**管线**
金箔墙(缓存)→ 金粉四角星闪烁(lighter)→ 窗《白桦林》点彩 → 黑白方格金框 → 花毯地 → 霍夫曼黑白方格桌 → 斜向流光(在角色之前画,角色自然挡住)→ 猫 → 少女金袍(纹样层按剪影 source-in)→ 写实的脸与手 → 花冠 → 金袖、金杯 → 金色热气。

**金箔**
- 逐像素:`f = 0.5 + fbm(x·.004)·0.55 + noise(x·.003, y·.08)·0.5 ± 0.05`,在 `[120,78,18]→[196,148,52]→[246,216,128]` 之间插值。
- 每 96px 画一条极淡的方块接缝,表示一片片贴上去的金箔。
- 墙:金箔 × 480×270 小 fbm 图放大后 multiply(褐金斑驳,像《吻》的底),再撒 9000 颗金粉、暗粉。

**纹样(金袍)**
- 150 个随机点,分四类:
  - 同心圆三色(30%):红白蓝、蓝金红、紫白金;
  - 深褐底金螺旋(32%),每个按 ±3rad/s 转;
  - 荷鲁斯式眼形纹(22%),轮流眨:`sin(2.2t+φ)>0.86` 时闭上;
  - 白点簇+红心(16%)。
- 下摆另有 60 块黑白竖长方块,金描边,这是《吻》里男子长袍的语言。
- **平面装饰对写实脸**:脸、手用径向渐变表现体积(高光 `#fbe8da` → `#f0cfb8` → `#d8a88c` → 边缘 `#b88068`),模糊的腮红和眼窝阴影,只有 1.2px 淡轮廓。金袍有 3px 深色描边。这个对比就是克里姆特。

**其它**
- 窗《白桦林》:2600 个秋叶色椭圆点,6 根白桦树干带黑斑;落叶 14 片翻面下落。
- 花毯:260 朵同心圆花,越近越大(6→20px),点头 `sin(4.2t+φ)·0.18r`。
- 流光:520px 宽、α.24 的亮带,`transform(1,0,−0.45,1)` 斜切,lighter,在 1.15 秒内**匀速**从 −200 扫到 2300。
- 金粉:420 颗,`sin(t·sp+φ)>0.55` 时出四角星。第一版星太大,像圣诞装饰,后来半径从 `s·(1+2.2a)` 改为 `s·(0.6+1.1a)`。

**坑**
- 逐个纹样 `source-in` 会把彼此清掉,见 ②-7。
- 流光 α 到 .38 时像镜头眩光,压到 .24。
- 第一版相邻帧有静止段:眨眼是间歇的,流光是软渐变。加了三样之后,静止帧对从 20/36 降到 0/36:
  - 34 片金箔碎片翻面飘落(150px/s,方片和圆片,金色渐变);
  - 金粉以 26px/s 上浮;
  - 花点头幅度从 0.18 加到 0.35。
- 猫身上的金螺旋第一版连脸上也有,审片说「像起了疹子」,改成只在身体上、数量减到 46 个。

---

<a id="19_munch"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/风格配方/19_munch.md

# 19_munch · 蒙克《呐喊》式表现主义(1893)

> 来源:迁移测试 A(只读 skill 的独立 agent 实做,2026-10-04)。场景代码由整合后移植到 `scripts/engine/scenes/19_munch.js`。

实验时的文件名 `scenes/03_munch.js`(约 160 行)。终版相邻帧中位 2.27%,单帧 JS 侧大约 90–140ms。

**流线渲染器 `flowLines`(新)**
- 种子:24px 抖动网格,约 3600 个。每个种子判定区域(天、峡湾、山、墙、地板)。
- 沿「随时间扭动的方向场」积分,每区参数 [steps, step, width, α]:
  - 终版:天 [32,7,10,.78]、峡湾 [26,6,9,.78]、墙 [42,7,13,.5]、地 [32,8,12,.55],每根另加 0–8 步随机。
  - 一根笔走 200–300px。
  - 历程:第二版是 [26,6,7,.85],独立审片仍判「第一眼是梵高」,只好再拉长、加宽、减透明度。
- 越出本区就停,所以区域边界是干净的。
- **不描边、半透明叠色**:蒙克是薄涂长笔。第一版照搬梵高的「深色描边」,墙面成了一节节毛毛虫短笔,一眼就是梵高。去掉描边、步数从 10 加到 26 以后才对。
- 底下先铺同色系平涂(墙从 `#a8401e` 渐变到 `#5a1a14`),笔缝里露出来的是同色,不是黑。

**方向场**
- 天:`0.55·sin(x·.011 + y·.018 − 2.4t)`;
- 峡湾:绕 (620,470) 的切线;
- 墙:竖向 ±0.5 正弦扭;
- 地:指向消失点 (1000,640)。

**血色天空**
- 种子按「波浪化的 y」决定色带:`yy = y + 22·sin(x·.014 − 2.2t)`,带宽 28px。
- 7 色循环:`#e2541c #f08a24 #f4c03a #c8301e #e8743a #f6a63a #b82a1e`。
- 色带本身也在扭,这就是「天空在流」。

**整个世界在流动**
最后把整幅画按行位移 `9·sin(y·.012 + 4.2t) + 4·sin(y·.031 − 6t)`,再按列位移 `6·sin(x·.009 − 3.6t)`,带宽 4px,用 `KIT.warpRows / warpCols`。人、猫、桌都会一起晃,比单独画摇晃的线便宜得多。

**母题**
- 窗里:桥面斜纹、栏杆三条(随世界扭)、两个戴帽远人。
- 尖叫者:骷髅脸、双手捂颊、嘴张合 `7+2sin(9t)`,身体摆 `sin(3.2t)·0.12`。
- 桌、椅腿是抖动的波浪线。
- 少女:1890 年代挪威深色长裙+白领,黄绿脸影(blur 8 的 `rgba(120,150,70,.4)`),9 绺长金发做行波 `sin(9q − 7t)`。
- 猫嘴微张,像被画外的尖叫传染了。

**角标**:文字画进离屏,再按行正弦扭。字体不要用 Kalam 这类漫画手写体(审片说出戏),改用 IMFellEnglish。

**坑**
- 整幅行列位移以后,左右边缘会露出暗色缺口。`KIT.warpRows/warpCols` 加了 margin 参数:每行多拉伸 2×margin 像素,margin 要大于等于最大位移。
- 线稿模式下举杯的手臂会被躯干线穿过,用 `KIT.nearArm` 重盖(见 ②-16)。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall