给2D像素加3D立体感:claude-pxl法线贴图bump与normals完全教程

原创2026-11-13 12:49:142,342 阅读

给2D像素加3D立体感:claude-pxl法线贴图bump与normals完全教程

想让平面的 2D 像素画看起来"鼓起来"?claude-pxl 内置了像素级法线贴图(normal map):一行 bump() 就能让砖块长出倒角、让史莱姆像枕头一样鼓起,再配合 lamp 的低角度光,光影会在起伏表面上扫过,2D 画面立刻有了 3D 立体感。本文带你从零理解法线贴图原理,掌握 bump() 三种立体形状、normals() 手绘方向网格,以及如何把导出的法线贴图直接交给 Godot、Unity 使用。

claude-pxl法线贴图演示:洞穴岩石表面带有bump浮雕,流动的光照亮凹凸起伏

一、什么是法线贴图?为什么像素画也需要它

真实游戏里的 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 可开到 2
  • on:只对指定调色板 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)。黑暗里这些浮雕不可见,只有萤光虫群和小灯飘过时,凹凸才被逐一扫亮——法线贴图的"动态揭示"效果拉满。

claude-pxl光照示例:魔法小屋夜景结合lighting灯光与法线贴图产生立体光影

魔法之夜(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 视角建筑,两者可以叠加使用:几何负责"形",法线负责"质感"。

claude-pxl像素3D建筑:月亮面包房用斜投影多边形呈现3/4视角立体结构

claude-pxl像素3D夜景:霓虹拉面馆的正面侧立面与屋顶几何结构

八、速查表与延伸阅读

参数 / 函数 关键作用
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 自动导出的引擎通用法线贴图

想继续深入,推荐按这个顺序读:

一行 bump(),一张法线贴图,你的 2D 像素世界从此有了 3D 立体感。

登录后查看全文
claude-pxl