为什么SunshineClouds2 v2.0要用Compositor系统推倒重来:性能翻倍的架构设计思想
为什么SunshineClouds2 v2.0要用Compositor系统推倒重来:性能翻倍的架构设计思想
如果你正在给 Godot 4 项目寻找一套程序化体素云系统,那 SunshineClouds2 几乎是绕不开的选择——它支持全体积云、可在编辑器里手绘云层密度,还支持 MSAA 与低分辨率加速。而它最关键的转折点,正是 v2.0 那次推倒重来:全面改用 Godot 的 Compositor(合成器)系统。官方更新日志里只有短短一句:"Rebuilt from the ground up to use the compositor system, improving performance and visuals."(README.md)今天这篇文章就带你拆解:这次重构到底改了什么,为什么能让性能翻倍,以及新手如何几分钟上手这套云系统。
旧方案为什么撑不住了:v1.x 的三个天花板
在 v1.x 时代,体素云这类效果普遍走"屏幕空间后处理"路线:先拿到屏幕颜色和深度,再对整屏做光线步进(raymarching)算出云的密度。这条路有几个绕不开的问题:
- 必须跑在完整屏幕分辨率上:每个像素都要沿视线步进几十次,4K 下开销直接爆炸;
- 与场景渲染管线脱节:拿到的深度、相机矩阵往往是"复制品",MSAA 解析后的颜色还要额外处理一遍;
- 资源反复创建:每帧都在重复申请管线、纹理和采样器,CPU 与 GPU 来回打转。
SunshineClouds2 v2.0 的答案很干脆:不再自己造轮子,而是挂进 Godot 官方的 Compositor 回调里,直接消费引擎渲染好的 RenderSceneBuffers(解析后的颜色 + 深度)和 RenderSceneData(相机矩阵)。这样一来,云渲染不再是"独立的一次全屏特效",而是渲染管线中的一个原生环节。
Compositor 架构下的四段式渲染管线
打开核心脚本 SunshineClouds.gd(类 SunshineCloudsGD,继承自 CompositorEffect)的 _render_callback,可以看到每帧每个视角会按顺序派发 4 个 Pass,这正是 v2.0 架构的骨架:
| Pass | 源码 | 干什么 |
|---|---|---|
| ① Pre(前置计算) | SunshineCloudsPreCompute.glsl | 把全分辨率深度降采样成低分辨率保守深度图 |
| ② Compute(主体计算) | SunshineCloudsCompute.glsl | 在低分辨率网格上光线步进,算出云密度与光照 |
| ③ Post(后置计算) | SunshineCloudsPostCompute.glsl | 双三次上采样,并把云混合结果直接写回 MSAA 屏幕纹理 |
| ④ Display(显示) | SunshineCloudsDisplay.glsl | 全屏四边形一次绘制,把混合后的画面呈现出来 |
前置 Pass:用 1 个 Pass 省下 100 次深度查询
主计算需要"远处有没有遮挡物"来决定光线步进在哪终止。v2.0 让前置 Pass 以 8×8 线程组遍历全分辨率深度,对每个低分辨率像素取块内最远深度写入小图。后面主 Pass 直接读这张便宜的深度图,既不用逐像素反查场景几何,又能提前截断空区域的光线——这是一次典型的"用极小成本买大收益"的设计。
主 Compute Pass:低分辨率 + 时间积累是性能翻倍的核心
这是整个系统性价比最高的两板斧:
- 分辨率缩放:面板里的
resolution_scale可选 Native / Half / Quarter / Eighth。选 Eighth 时,体积云只在 1/8 宽度网格上步进——计算量直接降到 1/64,最后靠上采样补回观感。云本来就是一种"低频视觉信号",人眼对它的锯齿远比对地形宽容。 - 时间积累(Temporal Accumulation):主 Pass 的输出写入 ping-pong 交替的累积纹理(
accumulation_is_a每帧翻转),配合accumulation_decay参数对历史帧做衰减混合。换句话说,云的"厚度"是时间维上慢慢积出来的,每帧只需要做增量计算,而不是逐帧从头算满。
后置与显示 Pass:MSAA 场景下不加一分钱
开启 MSAA 时,v2.0 会切换到 .msaa 版本的后置/显示着色器:后置 Pass 直接以 Image2DMSAA 格式逐样本写回屏幕颜色附件,显示 Pass 再用 texelFetchMSAA 按样本读取。全程不需要额外的 resolve(解析)开销——这一点在官方日志里也被特别感谢了社区贡献者完成的 MSAA 改造。
性能翻倍背后的另外三个隐藏设计
- 直接调用 RenderingDevice,资源只建一次:管线、采样器、纹理、UniformSet 全部缓存,只有窗口尺寸或 MSAA 档位变化时才重建(见 SunshineClouds.gd 的
_render_callback)。每帧做的只是"绑定 + dispatch",杜绝了 v1 时代反复创建资源的浪费。 - 回调时机选得准:效果声明为
EFFECT_CALLBACK_TYPE_PRE_TRANSPARENT,并声明需要解析后的颜色与深度(SunshineClouds.gd),确保云正确地插在透明物体之前,与场景雾、天空盒自然融合。 - 驱动节点零配置接线:你不需要手动把云挂到合成器上。SunshineCloudsDriver.gd 中的
SunshineCloudsDriverGD节点会自动递归查找场景里的WorldEnvironment,创建Compositor并把云效果追加进compositor_effects数组——对新手来说就是"放个节点,点一下按钮"。
新手如何快速上手:3 次点击跑起来
按 README.md 的安装流程走一遍即可:
- 从资源库搜索 "Sunshine Clouds 2" 安装,或
git clone https://gitcode.com/gh_mirrors/su/SunshineClouds2后把addons/拷入项目; - 在 项目 → 项目设置 → 插件 中启用 SunshineClouds2;
- 场景中添加一个
SunshineCloudsDriverGD节点(确保场景里有WorldEnvironment); - 点击节点上的 Generate Clouds Resource 按钮;
- 把一盏 DirectionalLight3D 拖进 "Tracked Directional Lights" 数组;
- 运行——想看效果可以参考内置演示场景 ExampleScene.tscn。
关键文件导航:想深入架构时从这里看
| 想了解 | 看哪里 |
|---|---|
| Compositor 效果主体、四 Pass 派发 | SunshineClouds.gd |
| 深度降采样前置 Pass | SunshineCloudsPreCompute.glsl |
| 云密度/光照步进主着色器 | SunshineCloudsCompute.glsl |
| 驱动节点(自动挂 Compositor、风力/光照同步) | SunshineCloudsDriver.gd |
| 画笔编辑工具(绘制遮罩) | addons/SunshineClouds2/Dock/ |
| 噪声纹理资源(各尺度云噪声、蓝噪声抖动) | addons/SunshineClouds2/NoiseTextures/ |
小结:为什么这次"推倒重来"值了
SunshineClouds2 v2.0 的选择其实是给所有 Godot 4 特效开发者的一课:当引擎提供了 Compositor 这样的原生扩展点时,顺势接入永远好过自己维护一条平行管线。深度、相机、MSAA 附件由引擎直接喂到手里,剩下只需专注两件事——低分辨率计算 + 时间积累。前者把空间开销打下来,后者把时间开销摊平,性能翻倍的架构思想到这一步就非常清晰了。



