LinearAbilityCastingThreeJS渲染管线拆解:深度预通道、Bloom与ACES色调映射完整流程
LinearAbilityCastingThreeJS渲染管线拆解:深度预通道、Bloom与ACES色调映射完整流程
LinearAbilityCastingThreeJS 是一个基于 Three.js + Vite + 手写 GLSL 的技能弹道(skillshot)特效沙盒。它的电影感画质并非来自贴图堆料,而来自一条精心设计的渲染管线:深度预通道(depth prepass)、畸变缓冲、Bloom 辉光与 ACES 色调映射四段环环相扣。本文将用最小代码量,把这条管线逐段拆解清楚,让你知道每一帧画面是如何从线性 HDR 缓冲区一步步走到最终屏幕的。
一帧之内发生了什么:渲染管线全景
整条管线定义在 src/postprocessing/PostProcessing.js 的类注释里,每帧依次执行三步:
- 深度预通道(depth prepass):把不透明的 WORLD 图层渲染进一个半分辨率的打包深度缓冲区,供所有特效 Shader 采样,实现"软交叠"(soft intersection)。
- 畸变通道(distortion pass):DISTORTION 图层往第二个半分辨率缓冲区写入屏幕空间 UV 偏移,是热浪/折射效果的挂载点。
- Composer 主流程:场景 → 折射变形 → Bloom 辉光 → ACES 色调映射 → 分级调色,最终输出到屏幕。
为什么 1、2 两步用半分辨率?因为这两个缓冲区只会被当作平滑的低频数据采样,全分辨率纯属浪费填充率——这是本文最重要的性能思想之一。
深度预通道步骤:软交叠是怎么做到的
"软交叠"解决的问题是:透明特效(冰雾、碎屑、闪粉)与不透明物体(水晶、地面)相交时,不该出现生硬的切割线。
具体做法见 _renderDepth():
- 用一个
MeshDepthMaterial(RGBADepthPacking打包模式)把只属于 WORLD 图层的场景重渲一次,写入半分辨率的depthTarget; - 清空颜色用纯白
0xffffff,代表"无穷远",这样没被遮挡的像素深度就是最大值; - 渲染期间临时把场景背景置空,避免天空盒污染深度。
所有自定义材质都通过 src/core/FrameUniforms.js 共享同一个 uSceneDepth 纹理 uniform。写 uniform 时只写一次,几十个 VFX 材质同时更新——这是该项目保持低 CPU 开销的关键技巧。图层划分定义在 src/core/Layers.js:WORLD 走预通道,VFX 走主通道,互不干扰。
看上面冰霜技能图就能体会到效果:雾气掠过水晶群时边缘是渐隐的,而不是被一刀切断。
畸变通道:为热浪与折射预留的管线挂载点
_renderDistortion() 把 DISTORTION 图层渲染进一个 HalfFloat 的半分辨率缓冲区。编码约定很巧妙:颜色通道以 0.5 为"零偏移"基准,B 通道存强度,A 通道存覆盖遮罩(见 DistortionShader.js)。
当前构建里没有物体真正写入该缓冲区,通道保留是为折射类效果预留的接口——想加热浪、水面折射,只需要让一个代理网格进入 DISTORTION 图层即可,管线本身零改动。
Composer 主流程:从线性 HDR 到屏幕的五个 Pass
PostProcessing.js 中 composer 的装配顺序就是渲染管线的"宪法":
| 顺序 | Pass | 职责 |
|---|---|---|
| 1 | RenderPass |
把场景渲染进 composer 目标(此时是线性 HDR) |
| 2 | DistortionShader |
按畸变缓冲区做屏幕空间折射 |
| 3 | UnrealBloomPass |
提取高亮区域扩散辉光 |
| 4 | OutputPass |
ACES 色调映射 + sRGB 转换,一切从此进入显示空间 |
| 5 | GradeShader |
暗角、色散、颗粒、冲击闪白等最终调色 |
注意第 4 步的位置:Bloom 必须在色调映射之前跑,因为辉光需要在线性 HDR 空间判断"哪些像素真正过亮";而 OutputPass 会自动读取渲染器上的 toneMapping 与 toneMappingExposure 属性(见 src/core/Renderer.js),three.js 在渲染进 composer 目标时会自动关闭材质内置的色调映射,避免双重映射。
UnrealBloomPass 三参数调优:strength、radius、threshold
Bloom 的三个核心参数都在 src/config/settings.js 的 post 块里,且全部是实时滑杆:
- strength(0.03):辉光强度。项目默认值刻意接近零——注释写得很直白:"水晶的轮廓本身就承载了视觉信息,Bloom 正在吃掉它"。想要光晕感再往上推;
- radius(0.6):辉光扩散半径,控制光晕的"毛边"范围;
- threshold(0.88):亮度阈值。它被刻意设在水晶受亮值之上,结果是只有边缘光、晶体闪光点与命中爆点会发光,而不是整个冰原都在喷光。
这条经验对所有做 Three.js 后处理的人通用:threshold 定"谁发光",strength 定"发多亮",radius 定"光晕多大",三者的组合决定画面是"通透"还是"糊成一团"。
ACESFilmicToneMapping:为什么色调映射必须是倒数第二步
Renderer.js 中一行代码定调了整条管线的色彩走向:
this.gl.toneMapping = ACESFilmicToneMapping;
this.gl.toneMappingExposure = settings.post.exposure; // 默认 1.05
this.gl.outputColorSpace = SRGBColorSpace;
ACESFilmic 曲线模拟胶片的高光压缩:超亮的激光核心、熔岩缝隙不会直接削顶成死白,而是保有渐变地滚向白色。exposure(曝光,默认 1.05)由编辑器实时驱动,每帧经 syncSettings() 写入渲染器——相当于给整条管线装了一个快门。
紧跟其后的 GradeShader.js 把七种"廉价但高收益"的操作折叠进一次重采样:径向色散(最强在四角)、对比度、lift/gain、饱和度、色温、暗角与胶片颗粒,最后叠加技能命中时的全屏闪白。所有分级参数同样在 settings.post 中可调。
性能与画质权衡的三个关键决策
- 像素比封顶 1.75:targetPixelRatio() 认为 4K + 大量半透明特效不值得那点填充率,
devicePixelRatio一律Math.min截断; - 阴影每帧只更新一次:一帧内场景被渲染多次(预通道、畸变、主通道),若开启
shadowMap.autoUpdate,级联阴影图会被反复重建。项目在 Renderer.js 关闭自动更新,由 App.js 每帧手动置一次needsUpdate; - 4096² 单灯阴影相机跟随角色:见 src/world/Environment.js,正交阴影相机每帧以角色为中心对准约 52 米范围,纹理精度约 1.3 厘米/像素,配合
PCFSoftShadowMap得到柔和日光阴影。角色脚下还有一层 256² 的接触阴影(从下方捕获角色深度、模糊两次后投影到地面),见 src/world/ContactShadows.js。
本地跑起来,亲手拨弄这条管线
git clone https://gitcode.com/gh_mirrors/li/LinearAbiltyCastingThreeJS
cd LinearAbiltyCastingThreeJS
npm install
npm run dev
打开 Vite 打印的地址(默认 http://127.0.0.1:5173),按 G 呼出编辑器,进入 Post processing 文件夹:拖动 bloomStrength、bloomThreshold、exposure、vignette,就能实时看到本节拆解的每一个环节如何改变画面。再按 P 暂停模拟——编辑器依然生效,你可以冻结在技能爆发的瞬间,对着静态画面精调管线参数。
核心文件速查
| 模块 | 路径 |
|---|---|
| 管线总装(预通道/畸变/composer) | src/postprocessing/PostProcessing.js |
| ACES 与 sRGB 配置 | src/core/Renderer.js |
| 最终调色 Pass | src/postprocessing/GradeShader.js |
| 折射 Pass | src/postprocessing/DistortionShader.js |
| 共享帧 uniform(含 uSceneDepth) | src/core/FrameUniforms.js |
| 图层划分 | src/core/Layers.js |
| 后处理全部参数 | src/config/settings.js |
| 每帧主循环与阴影更新 | src/core/App.js |
一句话总结这条管线的设计哲学:在便宜的地方花小钱(半分辨率辅助缓冲、单次阴影更新、像素比封顶),把预算省给贵的地方(HDR 辉光、ACES 映射、程序化特效)——这也是它能在浏览器里稳定跑满整套技能特效的原因。


