Postprocessing 是配合 Three.js 使用的后处理库,通过 Pass 和 Effect 扩展常规渲染流程,加入全屏图像处理工具。资料强调:几何与光照正确的渲染若没有收尾处理,仍会显得平淡和“未完成”;但收尾应克制、轻量,过重的泛光或过度调色比不做更糟。
用途与核心理念 资料把一套“有品味的收尾”分为三部分:环境光遮蔽,用接触阴影让物体落地;适度泛光,让自发光和亮部产生辉光;色调映射加轻微调色,设定氛围。建议在场景本身已经正确呈现后再添加,并保持克制。
主要能力与使用方式
- 渲染器配置:用于后处理的 WebGLRenderer 无需屏上深度或模板缓冲,偏好独立 GPU;抗锯齿关闭,因为由管线内部处理。示例参数为 powerPreference: 'high-performance'、antialias: false、stencil: false、depth: false。
- 合成器:EffectComposer 管理与运行各个 Pass;第一个 Pass 使用 RenderPass 清空缓冲并渲染场景,之后通过 EffectPass 执行全屏图像效果。单个 EffectPass 会把多个效果合并成一个着色器,应把收尾效果集中在一个 Pass 中,而非每个效果单独串联一个 Pass。
- 环境光遮蔽:SSAOEffect 需要场景法线,必须添加 NormalPass 并把其 .texture 传入 SSAOEffect;只写 new SSAOEffect(camera) 而没有法线缓冲会什么都渲染不出,这是常见错误。示例给出 worldDistanceThreshold: 20、worldDistanceFalloff: 5、radius: 0.1、intensity: 2。
- 泛光与色调映射:BloomEffect 示例参数为 intensity: 0.4、luminanceThreshold: 0.85,强调要“subtle”。色调映射放在最后;同一 EffectPass 内效果按数组顺序应用,所以 ToneMappingEffect(模式示例 ACES_FILMIC)是最后一个参数。
- 调色:可在同一 EffectPass 中、色调映射之前加入 BrightnessContrastEffect、HueSaturationEffect 或用于胶片 LUT 的 LUT3DEffect;调色幅度要小,几个点的对比度或饱和度,而不是厚厚一层。
- 渲染循环:renderer.setAnimationLoop(() => composer.render())。
- 其他效果:库还包含景深、暗角、描边(用于选中/高亮)、神光、色差、故障、像素化、冲击波等;添加方式相同——构造效果后放进 EffectPass。资料建议查看包导出以确认当前可用效果与参数,而不要猜测名称。
HDR 与色彩空间前提 采用线性色彩管理工作流;将 WebGLRenderer.outputColorSpace 设为 SRGBColorSpace,postprocessing 会自动跟随。默认中间结果使用 UnsignedByteType 的 sRGB 帧缓冲,低精度下颜色钳制在 [0,1],暗部信息损失会造成可见色带;线性高精度 HalfFloatType 缓冲没有这些问题,是桌面 HDR 类工作流的首选。在构造 composer 时通过 { frameBufferType: HalfFloatType } 启用。使用 postprocessing 时,渲染器 toneMapping 必须设为 NoToneMapping(默认),且须启用高精度帧缓冲,否则颜色在管线最前端就被映射到 [0,1],色调映射无从发挥作用;色调映射通过管线末尾的 ToneMappingEffect 完成。资料还指出:单独使用渲染器时,清屏色不经过着色器,因此不参与色调映射;postprocessing 作用于完整输入图像,会对清屏色背景统一应用色调映射,后者才是正确做法。
已知故障与处理方式
- SSAO 与透明物体:NormalPass 会以覆盖材质把整个场景(含透明物体)渲染进法线缓冲,但加法混合的枪口闪光、粒子、曳光、光束、UI 面片等透明 VFX 设置 depthWrite: false,不进入 SSAO 采样的深度缓冲;SSAO 于是找到没有对应深度的法线,在它们周围刻出暗色四边形光晕,射击时最明显。一般可靠的修复是在仅该 Pass 期间隐藏所有透明物体,事后再恢复:用两个空操作 Pass 夹住 NormalPass。示例 TransparentToggle 继承 Pass 并设 this.needsSwap = false;隐藏分支遍历场景,把可见的透明对象压入 hidden 并设为不可见,恢复分支重新可见并清空 hidden。这样不透明的 AO 表面不受影响,仍提供接触阴影。
- 经泛光扩散的着色器 NaN(全屏白闪):一个写入 NaN(或 Inf)的片元进入 HDR 缓冲后,泛光的 mipmap 降采样会把它平均进每一级更粗的 mip,单个坏像素扩散到整张泛光纹理,再叠加到整帧。特征很独特:去掉后处理白闪就消失(无泛光时坏值只留在少数源像素上,通常不可见);白闪是硬边、完全不透明、看不到背景;且只出现在某些相机角度或位置,因为源头与视角相关。常见来源是 GLSL pow() 的底数在数学上非负但浮点舍入略低于零;pow(x, y) 在 x < 0 时未定义,有的驱动返回 NaN,有的返回 0,所以白闪依赖 GPU/驱动,可能无法本地复现。菲涅尔/边缘光是典型情况:正对表面时两个归一化向量的 abs(dot(...)) 会舍入到约 1.0000001,底数变负。资料给出不安全写法 pow(1.0 - abs(dot(normalize(n), normalize(v))), 1.4),以及安全写法:先用 clamp(abs(dot(...)), 0.0, 1.0) 钳制再取 pow。建议用 max(0.0, base) 或 clamp 保护每个 pow 底数,并保护输入可能为零向量的 normalize();非 NaN 的溢出同样会扩散:超过 HalfFloat 最大值(约 65504)的值在合成器缓冲中变成 Inf,因此自发光/加法输出要保持有界。难以本地复现时,可把场景渲染到 FloatType 渲染目标,用 readRenderTargetPixels 扫描 NaN/Inf/超大值;怀疑某材质时,把一个 NaN 写入其颜色 uniform,验证是否整屏泛白。
性能与适用场景 EffectPass 会自动组织并合并任意效果组合为单个着色器,减少渲染操作,使组合多效果时不必承受传统 Pass 串联的性能代价;每个效果可自选混合函数。全屏渲染操作使用单个覆盖屏幕的三角形,相比四边形更契合现代 GPU 光栅化模式,并消除屏幕对角线上的多余片元计算,对 GPGPU Pass 和复杂片元着色器效果尤其有利。适用范围是 Three.js 3D 游戏/实时场景的画面收尾;限制包括需要正确的 HDR 线性工作流、须注意透明 VFX 与 SSAO 的配合、须防范 NaN/Inf 扩散,以及应保持效果克制。