huashu-art-motion 文艺复兴晕涂风格配方:用纯 Canvas 代码复刻 1503 达芬奇式油画
huashu-art-motion 文艺复兴晕涂风格配方:用纯 Canvas 代码复刻 1503 达芬奇式油画
本文基于风格配方文档 references/风格配方/06_renaissance.md 及其对应场景实现 scripts/engine/scenes/06_renaissance.js 写成,讲解 huashu-art-motion 这个「35 种艺术风格动画」skill 中 06 号风格——1503 年文艺复兴盛期油画——的完整渲染管线:整层轻模糊实现全画面晕涂(sfumato)、真投影透视棋盘地砖、空气透视窗景,以及龟裂纹/画布经纬/黄釉组成的「画布罩层」。读完后你可以完整复现这套 1920×1080 的纯代码油画管线,并理解该配方是如何用「静止段帧差」量化指标驱动 v2 返修的。
一、风格定位与四层渲染管线
在 风格总索引 中,06_renaissance 的定义是:核心渲染器「整层轻模糊+高不透明清晰层、龟裂纹/画布纹/黄釉」,母题动作「达芬奇扑翼机飞过、河面碎光、浮尘」,签名转场「窗口神光」,当前质量评级 ★★,已知短板是「猫偏卡通;整体偏静」——这正是配方文档 v2 返修一节要解决的问题。
场景文件头部注释给出了完整管线:
- 静态层
ren_static:先在原始 canvas 上画完房间,再整层用filter: blur(1.3px)画进缓存,相当于全画面做一遍 sfumato; - 每帧动态层:扑翼机扇翅飞过窗、飞鸟、河面碎光、光柱里的浮尘;
- 角色离屏层:角色画进离屏层(渐变体积+天鹅绒高光+写实毛发短线),整层 blur 1.6px 再叠 0.45 清晰层,得到晕涂柔边;
- 罩层
ren_over:龟裂纹+画布经纬+暗角+黄釉,缓存后每帧一次drawImage。
文档给出的性能口径是每帧 16–37ms、中位 16ms,属于 35 个风格里偏轻的实现——这是把「最贵的两样东西」(整幅房间的静态层、罩层)都做成一次性缓存的结果,下面会逐层拆解。
二、静态层 ren_static:先画完房间,再整层模糊
2.1 墙、拱窗与窗光晕
墙的底色用共享纹理库的逐像素噪声函数生成(paint.js 中的 P.texture:fbm 斑驳+细颗粒),参数为 #43321f → #22180e、scale: 0.0024、amt: 30、grain: 12、seed: 21(06_renaissance.js#L55)。之后叠加两层光:顶部压暗的线性渐变(rgba(12,7,3,.45) 起)和以窗心 (585, 360) 为中心的窗光晕径向渐变(L56-L58)。
拱窗由 archPath 构造:半圆弧+两条竖边的 Path2D,外框 archPath(360, 810, 335, 560)、内窗洞 archPath(422, 800, 330, 542)(L10-L11)。石框用三段横向渐变 #c6b08a → #a48c68 → #7c6a4e 表现左侧受光,再叠一条窗左缘的暖白高光;阴影参数 shadowBlur 30、偏移 (10, 14) 让石框整体向右下压出体积(L75-L79)。
2.2 真投影的透视棋盘地砖
配方文档强调地砖「按真投影算」,源码里就是一个单点透视投影函数(L51-L52):
const VP = { yh: 420, cx: 960, f: 1029, h: 5.75 };
const proj = (X, Z) => [VP.cx + VP.f * X / Z, VP.yh + VP.f * VP.h / Z];
对应配方中的公式 y = 420 + f·h/Z、x = 960 + f·X/Z,f=1029、h=5.75(视点高度)。地砖的 Z 从墙根 16 往前每块砖步进 1.4(for (let z = 16; z > 5; z -= 1.4)),X 方向每块宽 1.4、横排 −14 到 14(L62-L68)。把各行 Z 代回投影公式,行距序列为:
| Z | 16 | 14.6 | 13.2 | 11.8 | 10.4 |
|---|---|---|---|---|---|
| 该行 y | 790 | 825 | 868 | 922 | 989 |
与配方记录「第一行落在 y=790,往下依次 825/868/922/989,和原片的行距对得上」逐行吻合——这是用透视行距对齐参考片的做法。
每块砖按 (i + j) % 2 交替取 #a88c64 / #5c2418,描 1.2px 暗缝。铺完后叠加两层压暗:一层 soft-light 的窗光光池(以 (700, 950) 为中心的暖色径向渐变,即配方里「窗光照到的那块光池」),再加一条纵向压暗线性渐变和一层以 (760, 960) 为中心的四周压暗径向渐变(rgba(18,9,4,.3) → .75),保证「只留光池、四周压暗」(L69-L74)。
房间其余陈设同样全部程序化:方桌是四条木腿+横撑+白桌布(桌布渐变 #e8dcbc → #a8987a,clip 后画竖向布纹),梯背椅是 4 根横档+木色渐变(L87-L102)。
2.3 窗洞内的空气透视远景
远景画在 INNER 窗洞的 clip 内(landscape(),L15-L48),完全是「越远越蓝越淡」的空气透视:
- 三层山:基线 y 分别为 300/318/336,颜色
#9fb4b8 → #8aa1a6 → #7d9294,轮廓用P.fbm(x·f, seed, 4)生成(fbm 即 4 倍频 Perlin 噪声,paint.js#L23); - 天空与云:三段线性渐变(
#93b0b6 → #c8d4cc → #e4e2cf)+14 个压扁 0.32 倍的柔和径向团块; - 湖与河谷:湖面
#dfe3d6 → #c9d2c2;河谷由灰绿#93a08a过渡到暖赭#7c7048,再撒 40 个近大远小的深色斑块; - 蜿蜒的银白河:11 点折线
RIVER,两遍描边——先rgba(90,100,80,.6)宽边打底,再叠#eef0e8银白,线宽w = 3 + i·1.3随远近从 3px 增到约 15px; - 柏树与圆树:26 棵,比例系数
s = 0.4 + (y−380)/150实现近大远小,柏树画成深色竖椭圆;另有小桥一条。
2.4 整层 sfumato:一次 blur 1.3px
静态层的收尾就是全画面晕涂的本体(L104-L107):
const STATIC = () => P.cached('ren_static', W, H, (g) => {
const raw = P.canvas(), rg = raw.getContext('2d'); room(rg);
g.filter = 'blur(1.3px)'; g.drawImage(raw, 0, 0); g.filter = 'none';
});
房间先在临时画布上以全精度画完,再以 1.3px 高斯模糊整层画进 P.cached 缓存——P.cached(key, w, h, fn) 的实现是「同 key 只算一次,返回缓存 canvas」(paint.js#L11)。这一下模糊同时抹平了墙面斑驳、石框棱线和地砖缝隙,让整幅「房间」都获得油画般的柔焦,且每帧只付一次 drawImage 的代价。
三、罩层 ren_over:画布本身的质感
罩层同样是一次性缓存(L109-L123),从上到下叠五样东西,参数与配方文档完全一致:
| 质感 | 实现 | 参数 |
|---|---|---|
| 暗角 | 径向渐变 (820,520,300)→(900,560,1250) | 0.55 处 α0.3,边缘 α0.8 |
| 黄釉 | 全屏填色 | rgba(150,110,40,.07) |
| 画布经纬 | 每 3px 一条 1px 线 | 纬线 α0.03–0.07,经线 α0.015–0.045(带随机抖动) |
| 油彩笔触肌理 | 9000 笔随机方向短线 | 亮笔 rgba(255,235,200,.022) / 暗笔 rgba(20,10,0,.028),线宽 5–10,长度 10–26,lineCap: round |
| 龟裂纹 | P.craquelure('ren', 0.55) 叠两遍 |
暗层 α0.32;亮边见下 |
龟裂纹的生成在共享库(paint.js#L53-L60):种子 77,900 条随机游走细线(每步 6–14px,方向随机偏转 ±0.8rad,lineWidth 0.8,颜色 rgba(40,25,10,α))。配方文档里最关键的一句是「漆皮翘起的亮边」的实现(06_renaissance.js#L120-L122):
g.globalAlpha = 0.32; g.drawImage(P.craquelure('ren', 0.55), 0, 0);
g.globalAlpha = 0.16; g.globalCompositeOperation = 'lighter';
g.filter = 'brightness(0) invert(1)'; g.drawImage(P.craquelure('ren', 0.55), 1, 1);
先用 brightness(0) invert(1) 把暗色裂纹反相成白线,向右下错开 1px、以 lighter 混合叠 α0.16,就得到了「每条裂纹右下缘有一道高光的翘起漆皮」效果——两遍贴图复用同一缓存,成本几乎为零。
四、角色层晕涂:离屏两遍合成
4.1 两遍 drawImage 的柔边公式
角色不直接画在主画面,而是画进离屏层 renChars,只清 (320, 180, 1200, 780) 这一块角色区域,画完画回主画面时分成两遍(L327-L333):
g.clearRect(320, 180, 1200, 780);
/* ...cat(g, ...); girl(g, ...); 全部画进离屏层... */
c.filter = 'blur(1.6px)'; c.drawImage(L, 320, 180, 1200, 780, 320, 180, 1200, 780); c.filter = 'none';
c.globalAlpha = 0.82; c.drawImage(L, 320, 180, 1200, 780, 320, 180, 1200, 780); c.globalAlpha = 1;
先 1.6px 模糊全不透明地画一遍(边缘全软),再叠一张 α0.82 的清晰层(五官、轮廓仍可辨认)——这就是「软边保留,五官和轮廓清楚了」的 v2 配方。v1 曾用 blur 2.6px + 清晰层 α0.38,审片结论是「主角被模糊、窗外反而清晰,景深倒置」,于是把模糊半径降到 1.6、清晰层提到 α0.82。只处理 1200×780 子区域也保证了 blur 的每帧开销可控。
4.2 不描线:全靠渐变出体积
配方强调「角色不描线,全部靠渐变出体积」,源码里有三套对应手法:
- 裙褶:红天鹅绒长裙底色是
#b8302a → #7c1818 → #3e0808的对角渐变;clip 进裙形后画 5 条二次曲线褶——亮褶rgba(200,70,60,.3)(线宽 16–26),暗褶rgba(40,0,0,.45)(线宽 ×0.7)错位叠加(L207-L214); - 天鹅绒袖子:
sheen()辅助函数(L191)clip 进袖形后,沿肩→肘骨骼方向画一条rgba(170,200,140,.45)、宽 10px 的圆头光带——高光落在褶子顶上,这正是天鹅绒的视觉特征; - 脸:横向渐变
#f0d0b0 → #e6bf9c → #b88866表现左侧受光,clip 后加眼窝椭圆阴影rgba(120,70,40,.22)与腮红rgba(220,120,100,.28)(L224-L227)。
猫的体积处理是配方「坑」一节的产物:身体先铺奶白底 #f4ece0,再用两个径向渐变把橘色毛 #d88a3e 从背脊「晕」进来(渐变末端 α→0,没有硬边界),420 根亮暗各半的短线做毛流;最后沿身体轮廓内侧描 14px、rgba(90,50,15,.22) 的轻压暗——源码注释直接写着「太重会像玻璃罩」(L292),对应配方里 v1 用 26px/α0.45 翻车的记录。表情上,少女在编舞信号 ch.cup > 0.7(杯子快到嘴边)时闭眼啜饮,猫则全程眯眼微笑、尾巴摆动(L237)。
五、母题动画:扑翼机、光柱与共享编舞
5.1 达芬奇扑翼机
扑翼机的运动学(L126-L154):
- 航线:进度
q = clamp(lt/1.3)(0–1.3s 飞完全程),x = lerp(440, 790, q),y = 226 + sin(lt·5)·14 − q·24(上下浮动且越飞越下沉); - 俯仰:
rotate(−0.08 + sin(lt·5 + 1)·0.07),即 v2 的 ±0.07 俯仰幅度; - 扇翼:
up = 0.5 + 0.5·sin(t·12 + 相位),翼尖纵坐标在 −118 到 +24px 之间往复(tipY = (−118·up + 24·(1−up))·sc);远翼缩放 0.78 倍、颜色压暗、相位错开 0.5,与近翼形成纵深; - 翼的画法:前缘梁(加粗线)+6 根放射肋(
ribs = 5,k=0..5 共 6 条,首条即前缘梁)+扇贝形后缘膜(沿肋端点逐段quadraticCurveTo内凹);尾舵是扇形,后缘随sin(t·6)·4摆动; - 整组放大 1.6 倍(
scale(1.6),v2 决策:「窗里一眼看得到」),且c.clip(INNER)裁剪在窗洞内。
配方特别记录了造型翻车过程:「第一版是平面『纸飞机』,认不出是达芬奇的扑翼机,重画成现在的肋骨扇形翼后才认得出」——说明该风格的验收标准是「一眼认得出母题」。
5.2 光柱与浮尘
光柱是窗到地面的楔形多边形 <a href="https://link.gitcode.com/i/4dcf98d13e4f2432794beb8aa10b142e" target="_blank">[440,330],[790,360],[1000,1080],[400,1080]],一次性画进缓存并做 blur(28px)([L173-L177)——配方的坑记录说「第一版每帧直接填多边形,两条硬边很假」,大半径模糊才让光柱边缘化开。每帧以 screen 混合叠加,亮度随「云过日」变化:globalAlpha = 0.75 + 0.35·sin(t·2.3)(L178-L184),即配方中的 0.75±0.35。
浮尘用共享粒子器 P.particles(70, 17, t, {x0:440, x1:880, y0:1000, y1:430, speed:60, drift:18, life:6}):70 颗粒子在光柱范围内自下而上缓慢上浮(v1 为 46 颗),每颗用径向渐变画光斑并按 sin(t·6 + i·1.7) 闪烁。P.particles 是确定性粒子——位置完全由种子和时间推出,无需状态数组(paint.js#L194-L199)。
5.3 共享编舞 P.choreo
角色动作不自己写循环,而是取共享编舞(paint.js#L171-L180)再乘上本风格的幅度系数:
const ch = P.choreo(lt, t);
const K = RIG.cat({ tail: ch.tail * 2.2 + Math.sin(t * 2.6) * 0.35, breathe: ch.breathe * 3,
look: Math.sin(t * 2.5) * 1.6 });
const G = RIG.girl({ cup: ch.cup, sip: ch.sip * 1.6, hair: 'long', breathe: ch.breathe * 2.5 });
choreo 内部:端杯按全片时间走 2.4s 一轮的 cupCycle(0.9s 举起、停 0.7s 喝、0.8s 放回),cup 是本段 0.9s 的缓动抬升;猫尾 sin(t·5.2)·0.35 + sin(t·11)·0.08;眨眼 (t % 2.3) > 2.18;呼吸 sin(t·4)·0.012。本场景的放大系数对应配方 v2 清单:猫尾 ×2.2、呼吸 ×3、少女 sip ×1.6、发梢摆 sin(t·3)·11(±11px);猫头绕脖子歪蹭 rotate(0.16·sin(t·3.4) + 0.05·sin(t·8.1))、眯眼松紧 0.5+0.5·sin(t·4.5) 交替(L298-L311)。
窗景里还有两个小母题:河面 24 个碎光顺 RIVER 折线流动并闪烁(u = ((t·0.22 + k/24) % 1),lighter 混合);窗外 3 块云影椭圆以 70px/s 掠过河谷,与光柱亮度波动联动(L163-L171);飞鸟 14 只、随机 1–1.8 倍,两段二次曲线描出「八」字翼并按各自相位扇动。
六、坑与 v2 返修
配方文档最有价值的部分是「坑」与「v2 返修」两节,记录了从 v1 到 v2 的全部调参依据。
6.1 v1 的三个坑
- 油彩肌理参数越界:第一版用 26000 笔、α0.05、方向跟着 noise 走,结果「整面墙像梵高的漩涡(后印象派)」——方向场笔触正是后印象派的签名手法(同仓库 09_postimp 风格的核心渲染器),方向一有规律就读成别的风格了。降到 9000 笔、α0.025、方向随机后才回到古典油画的感觉;
- 猫轮廓压暗过重:26px、α0.45 的内侧压暗让奶白色身体「看起来像个玻璃罩」,改成 14px、α0.22,白色胸部改用径向渐变把橘色毛「晕」进来,不留硬边界;
- 地砖太亮对比太强:第一版地砖像矢量插画,必须压暗四周,只留下窗光照到的那块光池。
6.2 v2 返修清单
审片口径:静止段帧差 0.20,目标是 0.46(原片实测 0.43);且发现「主角被模糊、窗外反而清晰」的景深倒置。v2 的修复项与源码一一对应:
| 修复项 | v1 | v2(当前源码) |
|---|---|---|
| 晕涂模糊半径 | 2.6px | 1.6px |
| 清晰层不透明度 | α0.38 | α0.82 |
| 扑翼机 | 平面纸飞机、航程 470→740 | 肋骨扇形翼、×1.6 放大、航程 440→790、俯仰 ±0.07 |
| 飞鸟 | 少量 | 14 只、1–1.8 倍 |
| 猫 | 静态感强 | 头歪蹭 ±0.16rad、眯眼松紧交替、尾巴 ×2.2、呼吸 ×3、左右转头 |
| 少女 | 静态感强 | 发梢摆 ±11px、sip ×1.6 |
| 环境 | 固定亮度 | 窗外云影掠过河谷;光柱亮度 0.75±0.35;浮尘 46→70 颗 |
返修后静止段帧差 0.20(审片口径)/ 0.30(作者自测)→ 0.37,逼近原片 0.43。这套「帧差对标原片」的量化方法贯穿整个配方体系:帧差过低=画面偏静、动态量不足,是该 skill 审片的核心指标。
七、复现路径:注册、转场与验证
要跑起这个风格,涉及四个文件:
- 场景实现:scripts/engine/scenes/06_renaissance.js 向全局注册表挂
SCENES['06_renaissance'] = { init(), draw(c, lt, t) }。init()预生成STATIC()与OVER()两个缓存,draw()按「静态层 → 河光/飞鸟/扑翼机 → 角色离屏两遍 → 光柱浮尘 → 罩层」的顺序合成; - 段落注册:scripts/engine/eras.js#L29-L31 定义段落条目——
eighths: 4(片长以八拍计)、年份计数器year: 1503(CormorantGaramond-500 字体、字距 22)、标签HIGH RENAISSANCE(Cinzel-700),以及签名转场transition: { type: 'godRays', dur: 0.4, delay: 0, cx: 560, cy: 290 }; - 转场实现:scripts/engine/transitions.js 的
godRays(「窗口神光」):旧画面 A 垫底,新画面 B 在进度 5%–50% 淡入;同时以 (560, 290)(窗口位置)为中心叠加峰值 α0.85 的径向暖金光晕和 34 条缓慢旋转(rot = p·0.35)的金色光芒,lighter混合——「光芒里旧画渐隐、新画浮现」; - 加载与失败快检:scripts/engine/scenes/index.js 按
ERAS里的 id 用同步 XHR 逐个加载scenes/<id>.js,任何「文件缺失、语法错、没注册draw、转场名找不到」都会记入window.__bootErrors,引擎拒绝启动,render.py/qa.py直接报错退出(注释里记录了踩坑史:缺场景时曾画「待实现」占位照常渲染,只能靠 0.0% 的帧差事后才发现)。
验证与迭代口径同样来自配方体系:渲染后量静止段帧差对标原片,质量评级与短板记录回 风格总索引(当前 06 为 ★★,短板「猫偏卡通;整体偏静」即下一轮返修方向)。
八、关键参数速查
| 参数 | 取值 | 出处 |
|---|---|---|
| 画幅 | 1920×1080 | 06_renaissance.js#L7 |
| 静态层模糊 | blur(1.3px),一次性缓存 | L104-L107 |
| 透视投影 | x=960+1029·X/Z,y=420+1029·5.75/Z,砖 1.4,Z: 16→5 | L51-L62 |
| 地砖色 | #a88c64 / #5c2418 | L67 |
| 角色晕涂 | blur(1.6px) 全量 + α0.82 清晰层,区域 (320,180,1200,780) | L327-L333 |
| 油彩肌理 | 9000 笔,α0.022/0.028,宽 5–10,随机方向 | L117-L118 |
| 龟裂 | 900 条随机游走,暗 α0.32 + 反相亮边 α0.16 错 1px | paint.js#L53-L60、L120-L122 |
| 光柱 | 楔形 + blur(28px),screen,α=0.75+0.35·sin(t·2.3) | L173-L180 |
| 浮尘 | 70 颗粒子,x∈440,880],y 1000→430,speed 60,life 6s | [L181 |
| 扑翼机 | 0–1.3s,x 440→790,×1.6,俯仰 ±0.07,扇翼 sin(t·12) | L128-L129 |
| 帧差目标 | 静止段 0.46(原片 0.43),v2 实测 0.37 | 配方文档 v2 节 |
这套「06_renaissance」配方的方法论可以概括为三步:用最便宜的整层模糊拿到风格的最大特征(晕涂),用真投影和参数化远景保证构图可信,用「帧差对标原片」的量化审片驱动返修。同一管线结构(静态层缓存 → 每帧动态 → 罩层缓存)在仓库其余 34 个风格里被反复复用,差异只在渲染器与母题——这也是 风格总索引 能按「核心渲染器/母题动作/签名转场」三列管理 35 种风格的原因。