给2D像素加3D立体感:claude-pxl法线贴图bump与normals完全教程
给2D像素加3D立体感:claude-pxl法线贴图bump与normals完全教程
想让平面的 2D 像素画看起来"鼓起来"?claude-pxl 内置了像素级法线贴图(normal map):一行 bump() 就能让砖块长出倒角、让史莱姆像枕头一样鼓起,再配合 lamp 的低角度光,光影会在起伏表面上扫过,2D 画面立刻有了 3D 立体感。本文带你从零理解法线贴图原理,掌握 bump() 三种立体形状、normals() 手绘方向网格,以及如何把导出的法线贴图直接交给 Godot、Unity 使用。
一、什么是法线贴图?为什么像素画也需要它
真实游戏里的 3D 模型,靠"法线贴图"告诉引擎每个像素的表面朝向:哪个面迎着光就变亮,哪个面背着光就变暗。claude-pxl 的 lighting.md 提供了同样的机制:
- 每个像素可以携带一个表面方向(法线)
- 调用
lighting()后,引擎让朝向光源的一侧变亮、背向的一侧变暗 - 没有法线的像素完全保持原来的平涂效果——两者可以混用
实现核心在 src/core/normals.ts:法线按"单位向量 × 0.5 + 0.5"编码存储,并且跟随像素一起移动——stamp、翻转、旋转、镜像后法线依然正确。
二、安装与运行准备
只需 Node ≥ 22.18,无运行时依赖、无构建步骤:
git clone https://gitcode.com/gh_mirrors/cl/claude-pxl
cd claude-pxl
node bin/pxl.js serve examples/normals.px.js
打开 http://127.0.0.1:4321/ 就能在浏览器里实时观看逐笔画制过程——法线场景还会在最终画面前额外多一帧"normal map",直接看到法线贴图的编码结果,是学习本教程最好的老师。
三、bump() 三种立体形状:一行代码生成法线
bump(shape, opts) 作用于当前 sprite/layer 的不透明像素,把"形状"自动转换成高度图,再推导出法线。三种内置形状覆盖了绝大多数需求:
| 形状 | 高度来源 | 适合对象 |
|---|---|---|
"dome" |
每个连通色块整体鼓起,边缘陡、顶部平 | 石头、果实、史莱姆、木桶 |
"bevel" |
边缘向内斜降 w 像素(默认 2),中间平 |
砖块、面板、按钮、地砖 |
"luma" |
亮度即高度:越亮越高 | 已经手工画好明暗的像素画 |
常用参数:
depth:陡度。越大越"立体",dome常配 1.5,luma可开到 2on:只对指定调色板 key 生效,其余 key 当作边缘。例如砖墙的灰缝不涂on的 key,每块砖就各自独立凸起where:限制作用区域- 图片外边界本身也算边缘
完整演示在 examples/normals.px.js:
- 砖墙:
bump("bevel", { on: "b", w: 2 }),灰缝m充当每块砖的边缘(L23) - 史莱姆:
bump("dome", { depth: 1.5 }),像充气的枕头(L25-L26) - 岩石:先用经典手法涂出明暗,再用
bump("luma", { depth: 2 })把现有阴影直接变成浮雕(L49)
"luma" 是个隐藏神器:你不用重画任何东西,手绘的明暗渐变立刻变成光照可"攀爬"的地形。
四、normals() 手绘方向网格:数字键当笔
需要精确控制时,normals(x, y, grid) 让你用小键盘方向逐像素涂方向——数字就是小键盘布局:
| 方向 | 8 | 9 |
|---|---|---|
| 7 / 4 / 6 / 3 | 5 | |
| 1 | 2 |
8朝上、2朝下、4朝左、6朝右,7/9/1/3是四个斜角5= 表面正对观众(平面)q w e / a s d / z x c是同样的方向,但坡度更缓,适合过渡0清除法线,.跳过
examples/normals.px.js#L29-L46 里的手绘木箱就是范例:四周边框涂了 8/2/4/6 让木板"立"起来,内侧一圈斜角做圆角过渡。
五、灯光怎么"雕刻":lamp 的 z 与 lighting 的 relief
法线只是"地形",真正让它显现的是光:
lamp(x, y, { z }):z是光源相对画面的高度。低值(2–6)像斜射的晨光,光掠过浮雕,凹凸最明显;高值(20+)则像顶光,趋于平光。洞穴示例里所有灯都是z: 3~10(examples/cave.px.js#L61)lighting({ relief }):法线对光照的影响强度,relief: 0直接关闭立体感。examples/normals.px.js#L63-L65 的lit/flat两个场景就是同一盏灯开/关 relief 的对比——动起来的灯笼扫过砖墙,立体感一目了然lighting({ skyDir }):天光的入射方向,[1, -1]即"从左上方来"
✨ 小窍门:把 relief 开满、把 z 压低,再让灯动起来(anim + 每帧重定位 lamp),静态的 2D 场景会有"光影在浮雕上流动"的电影感。
六、导出法线贴图:直接喂给 Godot / Unity
pxl build 会为每个带法线的 sprite 或 scene 额外输出 <名字>_n.png,采用通用引擎编码:
- RGB = 法线 × 0.5 + 0.5,绿色通道朝上
- 无起伏的平坦区域 =
#8080ff
也就是说,你在像素画里调好的法线贴图,可以原样导入 Godot、Unity 等引擎,让引擎用自己的光照系统继续"点亮"它——像素画师和引擎侧各取所需。
七、实战场景:从洞穴到魔法小屋
发光洞穴(examples/cave.px.js):后墙的圆石用 bump("dome") 生成法线,洞顶岩石用 bump("bevel", { w: 3 }) 倒角(L97)。黑暗里这些浮雕不可见,只有萤光虫群和小灯飘过时,凹凸才被逐一扫亮——法线贴图的"动态揭示"效果拉满。
魔法之夜(examples/no_magic.px.js):lighting({ cell: 2, smooth: true, ambient: 0.42, emit: "zYQ" }) 平滑光照 + 发光像素 + glow() 光晕的组合,展示法线/灯光系统如何与整个夜景合成。
📌 一个关键区分:法线贴图是"光影上的立体",适合浮雕、砖墙、圆石这类表面起伏;而画面本身要出现侧立面和屋顶(真正的几何 3D),则是另一套手法——多边形几何。仓库里 moon_bakery_3d.px.js 和 neon_noodle_3d.px.js 分别用斜投影画出了正面 + 侧面 + 屋顶的 3/4 视角建筑,两者可以叠加使用:几何负责"形",法线负责"质感"。
八、速查表与延伸阅读
| 参数 / 函数 | 关键作用 |
|---|---|
bump("dome"/"bevel"/"luma") |
从形状自动推导法线,depth 控陡度,on 限定 key |
normals(x, y, grid) |
小键盘方向手绘法线,qweasdzxc 为缓坡 |
lamp(..., { z }) |
z 越低,掠射光越能凸显浮雕 |
lighting({ relief }) |
0 关、1 满,调节法线对光照的影响 |
lighting({ skyDir }) |
天光方向,配合法线塑造整体明暗 |
<name>_n.png |
build 自动导出的引擎通用法线贴图 |
想继续深入,推荐按这个顺序读:
- lighting.md —— 灯光系统与法线贴图官方文档
- examples/normals.px.js —— 本文全部技巧的最小完整示例
- src/core/normals.ts ——
bump()的高度场实现 - test/normals.test.ts —— 行为验证用例
一行 bump(),一张法线贴图,你的 2D 像素世界从此有了 3D 立体感。



