LinearAbilityCastingThreeJS渲染管线拆解:深度预通道、Bloom与ACES色调映射完整流程

原创2026-10-16 14:57:041,701 阅读

LinearAbilityCastingThreeJS渲染管线拆解:深度预通道、Bloom与ACES色调映射完整流程

LinearAbilityCastingThreeJS 是一个基于 Three.js + Vite + 手写 GLSL 的技能弹道(skillshot)特效沙盒。它的电影感画质并非来自贴图堆料,而来自一条精心设计的渲染管线:深度预通道(depth prepass)、畸变缓冲、Bloom 辉光与 ACES 色调映射四段环环相扣。本文将用最小代码量,把这条管线逐段拆解清楚,让你知道每一帧画面是如何从线性 HDR 缓冲区一步步走到最终屏幕的。

冰霜突刺技能画面:程序化水晶与雾气的柔和交叠来自深度预通道的软粒子效果

一帧之内发生了什么:渲染管线全景

整条管线定义在 src/postprocessing/PostProcessing.js 的类注释里,每帧依次执行三步:

  1. 深度预通道(depth prepass):把不透明的 WORLD 图层渲染进一个半分辨率的打包深度缓冲区,供所有特效 Shader 采样,实现"软交叠"(soft intersection)。
  2. 畸变通道(distortion pass):DISTORTION 图层往第二个半分辨率缓冲区写入屏幕空间 UV 偏移,是热浪/折射效果的挂载点。
  3. Composer 主流程:场景 → 折射变形 → Bloom 辉光 → ACES 色调映射 → 分级调色,最终输出到屏幕。

为什么 1、2 两步用半分辨率?因为这两个缓冲区只会被当作平滑的低频数据采样,全分辨率纯属浪费填充率——这是本文最重要的性能思想之一。

雷电技能画面:强发光线条与冲击爆点展示了 Bloom 辉光与高动态范围

深度预通道步骤:软交叠是怎么做到的

"软交叠"解决的问题是:透明特效(冰雾、碎屑、闪粉)与不透明物体(水晶、地面)相交时,不该出现生硬的切割线。

具体做法见 _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 图层即可,管线本身零改动。

地面使用的大理石 PBR 颜色贴图,深色石材基底承载了整套技能特效

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 映射、程序化特效)——这也是它能在浏览器里稳定跑满整套技能特效的原因。

登录后查看全文
LinearAbiltyCastingThreeJS