threejs-postprocessing

适用场景

用户提到以下内容时，始终使用此技能：

• EffectComposer、RenderPass、叠加多个通道、调整 composer 大小
• Bloom、SSAO、SSR、DOF、outline、glitch、film grain、TAA——addon 通道名称
• 使用 Addons Shaders 组中的 shader 模块的 ShaderPass

重要：后期处理、渲染器与 node-tsl 的区别

管线	技能
经典 composer + 通道	threejs-postprocessing
仅渲染器输出颜色／色调	threejs-renderers
Node/TSL 后期处理节点	threejs-node-tsl

触发短语包括：

• "EffectComposer", "RenderPass", "UnrealBloomPass", "SSAOPass", "后期"
• "泛光", "环境光遮蔽", "描边"

如何使用此技能

1. 串联：RenderPass → 效果通道 → 输出；确保尺寸与渲染器一致，并处理 DPR 变化。
2. 调整大小：在调整渲染器大小的工作流中，同时调用 composer.setSize。
3. 半浮点：许多通道需要合适的渲染目标类型——引用对应版本的文档。
4. 性能：每个通道都会产生开销——谨慎使用 renderer.info 进行性能分析。
5. Shader 模块：链接 Addons Shaders 列表，不要在 SKILL 中内联大量 GLSL。
6. 输出：最终通道应与渲染器的颜色管理保持一致（threejs-renderers）。
7. 区分：单独说明核心 PostProcessing 类，避免名称混淆。

参见 examples/workflow-composer-bloom.md。

文档索引（官方）

文档部分	代表性链接
后期处理	https://threejs.org/docs/EffectComposer.html
后期处理	https://threejs.org/docs/RenderPass.html
后期处理	https://threejs.org/docs/UnrealBloomPass.html
Shaders（addon 模块）	https://threejs.org/docs/module-CopyShader.html

范围

• 范围内： Addon 后期处理通道和 composer 连接；指向 shader 模块的链接。
• 范围外： three 文档之外的自定义全屏管线设计；引擎级帧图。

常见问题与最佳实践

• 忘记调整 composer 大小会导致效果模糊或分辨率过低。
• 通道顺序很重要——bloom 通常放在主场景通道之后，outline 可能需要遮罩。
• 某些通道需要深度信息——请根据通道文档确保深度缓冲区可用。

文档与版本

Addon 通道位于 three.js 文档中的 Postprocessing 和 Shaders 模块中。通道构造函数和所需缓冲区会随版本变化——请链接到具体通道页面（例如 UnrealBloomPass），不要猜测 uniform 名称。

Agent 回复检查清单

使用此技能回答时，优先采用以下做法：

1. 链接到 EffectComposer、RenderPass 或指定通道（SSAOPass，……）。
2. 用户混用术语时，说明 addon composer 堆栈与核心 PostProcessing + threejs-node-tsl 的区别。
3. threejs-renderers 调整大小时，要求对 composer 调用 setSize。
4. 指向 Shaders 组，查找 ShaderPass 使用的原始 shader 模块。
5. 叠加耗费较大的通道时，提醒注意 VR 帧耗时（threejs-webxr）。

参考资料

• https://threejs.org/docs/#Postprocessing
• https://threejs.org/docs/EffectComposer.html
• https://threejs.org/docs/RenderPass.html

关键词

English： effectcomposer, renderpass, bloom, ssao, ssr, outline, postprocessing, three.js

中文： 后期、EffectComposer、泛光、SSAO、SSR、屏幕空间、three.js