Godot光线追踪基础设施详解:RenderRaytracing类与Vulkan RT着色器全解析
Godot光线追踪基础设施详解:RenderRaytracing类与Vulkan RT着色器全解析
本文面向想了解 Godot 光线追踪(Raytracing / Path Tracing)内部实现的开发者与进阶用户,完整解析 RenderRaytracing 类如何管理 BLAS/TLAS 加速结构、SceneShaderRaytracing 如何驱动着色器变体,以及 Vulkan RT 的 GLSL 着色器(raygen、miss、closest_hit 等)在 servers/rendering/renderer_rd/shaders/raytracing/ 目录中的分工。即使你没有图形学背景,也能通过本文建立清晰的认知框架。
1. 一分钟理解:这套基础设施是做什么的?
Godot 的 Forward+ 渲染管线原本依赖屏幕空间技术(SSAO、SSR、SSIL)来近似光照效果。本仓库(NVIDIA fork)新增了一条基于硬件光线追踪的路径追踪(Path Tracing)渲染路径:当 GPU 支持 Vulkan Ray Tracing 时,每个像素会发射真实的光线在场景中多次反弹,替代屏幕空间近似,获得电影级的全局光照、软阴影与反射。
整个功能由三层组成:
| 层级 | 核心文件 | 职责 |
|---|---|---|
| CPU 基础设施 | render_raytracing.cpp | 构建 BLAS/TLAS、缓存几何与材质数据、组装每帧 Uniform |
| 着色器管理 | scene_shader_raytracing.cpp | 管理 RT 管线变体、自定义 Hit Group、异步 SPIR-V 编译 |
| GPU 着色器 | scene_raytracing_raygen.glsl | raygen/miss/closest_hit 等 RT 阶段着色器,执行真实路径积分 |
调用入口在 render_forward_clustered_pt.cpp:RenderForwardClusteredPT::_render_scene 检测到环境的 Path Tracing 开启且 RD::SUPPORTS_RAYTRACING_PIPELINE 特性可用时,切换到 RT 渲染路径,否则回退到普通 Forward+ 管线。
2. RenderRaytracing 类深度解析(CPU 侧)
头文件 render_raytracing.h 定义了 RenderRaytracing 类(约 495 行),它是光线追踪的"数据总指挥",对外暴露四个关键入口:
build_tlas():收集场景中所有可见实例,为每个面片(surface)取得或构建 BLAS(底层加速结构),再组装成该视口的 TLAS(顶层加速结构);gather_lights():把场景中的全向光、方向光、聚光灯打包成 80 字节的RT_LightData(最多 64 盏,其中 48 盏用于视锥内 NEE 采样);update_uniform_set():把几何、材质、灯光、运动数据写入 GPU 缓冲区并生成 Uniform Set;copy_output_texture()/rt_ensure_textures():管理路径追踪输出纹理与 DLSS Ray Reconstruction 引导缓冲区。
2.1 CPU 与 GPU 严格对齐的数据结构
一个容易踩坑的设计是:CPU 端结构体必须与 GLSL 端 std430 布局逐字节对齐,代码用 static_assert 强制校验:
RT_GeometryData:固定 1280 字节 render_raytracing.h#L61-L89,描述顶点/索引缓冲区地址、法线与切线布局、AABB 压缩参数等;RT_MaterialData:固定 96 字节,包含 albedo/normal/ORM/emission 四张纹理的 bindless 索引、金属度、粗糙度、自发光强度等 PBR 参数;RT_LightData:固定 80 字节,支持全向光、方向光、聚光灯三种类型。
对应的 GLSL 侧结构体定义在 raytracing_data_inc.glsl,两侧注释明确标注 "Must match",这是阅读该模块时最重要的线索。
2.2 多级缓存:为什么场景动起来不掉帧?
重建 BLAS 非常昂贵,RenderRaytracing 因此设计了分层缓存(render_raytracing.h#L222-L291):
- 静态网格缓存:按 RID 分块(每块 256 槽)的稀疏缓存,未变化网格直接复用旧 BLAS;
- MultiMesh 合并 BLAS 缓存(
RTMergedMMEntry):用计算着色器(multimesh_merge.glsl)把数百个实例的顶点一次性烘焙进单个大 BLAS,避免每个实例单独建树,三角形数上限由项目参数rendering/pathtracing/multimesh_merged_blas_max_triangles控制; - 变形网格缓存(
RTDeformedCacheEntry):针对蒙皮动画等每帧顶点变化的网格,维护"当前帧 + 上一帧"两份位置缓冲区——前者用于重建/重拟合 BLAS,后者用于生成运动矢量(motion vector),支撑 TAA 与超分。
所有缓存均受 TTL(存活帧数)约束,相关参数集中在 rendering_server.cpp 中定义,例如 deformed_mesh_cache_ttl_frames 默认 60 帧、multimesh_blas_cache_ttl_frames 默认 3600 帧。
2.3 视口隔离:一个隐蔽但关键的修复
每个视口(Viewport)拥有独立的可见性集合(视锥体、LOD、可见距离),因此 RTViewportState 按视口隔离 TLAS 与实例 SSBO 内容。源码注释记录了一个真实事故:早期视口间共享 TLAS 时,gl_InstanceCustomIndexEXT 会解析到错误的几何条目,解引用过期 BDA 导致 GPU 崩溃。这个设计对多视口、VR 场景尤其重要。
3. Vulkan RT 着色器全解析(GPU 侧)
GLSL 着色器位于 servers/rendering/renderer_rd/shaders/raytracing/,共 13 个文件、近 9000 行,按 Vulkan RT 的六个阶段分工:
| 文件 | 阶段/作用 | 规模 |
|---|---|---|
| scene_raytracing_raygen.glsl | #[raygen] 主光线发射 + #[miss] 未命中处理 |
701 行 |
| raytracing_hit_inc.glsl | #[closest_hit] 最近命中、材质求值 |
275 行 |
| raytracing_closest_hit_common_inc.glsl | 命中公共逻辑、NEE 阴影射线 | 593 行 |
| raytracing_material_eval_inc.glsl | PBR 材质评估 | 25 行 |
| brdf_inc.glsl | Cook-Torrance BRDF 函数库 | 1184 行 |
| raytracing_inc.glsl | Path Payload、随机数、射线偏移 | 195 行 |
| raytracing_lights_inc.glsl | 灯光缓冲区、NEE 采样 | 395 行 |
| raytracing_custom_fragment_inc.glsl | 用户自定义片段着色注入点 | 91 行 |
3.1 Raygen:路径积分的主循环
raygen 阶段(scene_raytracing_raygen.glsl#L29-L102)对每个像素执行两级循环:每像素多样本(SPP)循环 × 最大反弹次数循环。每发一条主光线,就通过 traceRayEXT(tlas, ...) 或 SER 模式的 hitObjectTraceRayEXT 在 TLAS 上求交,命中后由 closest_hit 写出下一个反弹方向与 radiance。
若启用了 SER(Shader Execution Reordering,GL_EXT_shader_invocation_reorder),引擎会用实例 ID 作为连贯性提示调用 reorderThreadEXT,把访问相同 BLAS 的线程调度到一起,大幅提升 TLAS 缓存命中率——由 rendering/pathtracing/use_shader_execution_reordering 参数控制。
3.2 32 字节的 PathPayload:极致压缩的跨阶段数据
光线在多个 RT 阶段间传递状态,Vulkan 对 payload 大小敏感。Godot 的设计(raytracing_inc.glsl#L38-L45)值得学习:
- radiance 与 throughput 用 fp16 交错打包进 3 个 uint;
- 法线与下一射线方向用 16-bit 八面体编码(角误差 <0.001°,低于 8-bit 法线量化噪声);
- 反弹次数、随机数状态、命中距离
hit_t各自占位; - 通过
packed_bounces_flags的位标记实现早期路径终止(含MAX_DIFFUSE_BOUNCES 2的漫反射限深,配合降噪器使用)。
此外,防自交采用 Wachter-Binder 法:直接对浮点数的整数位表示做偏移,位移量随坐标量级自然缩放,比固定 epsilon 更稳健。
4. 着色器变体与特化常量:一份代码,多种管线
Vulkan 管线创建昂贵,Godot 用**特化常量(Specialization Constants)**把"采样数、反弹数、功能开关"打进一个 32 位 rt_flags,避免为每种组合编译独立管线(scene_shader_raytracing.h#L75-L115):
- 位 0-20(功能标志):
RT_FLAG_DEBUG_VIS_ENABLED(调试可视化)、RT_FLAG_DLSS_RR_ENABLED(DLSS 光线重建降噪)、RT_FLAG_FOG_ENABLED(雾效)、RT_FLAG_SER_ENABLED(执行重排序)、RT_FLAG_RAY_QUERY_SHADOWS_ENABLED; - 位 21-28:每像素采样数(SPP);
- 位 29-31:最大反弹次数(编码值 0 表示 1 次反弹,7 表示 8 次)。
SceneShaderRaytracing 按 rt_flags 缓存 PipelineBundle(管线 + Hit SBT + 基础着色器),并用单车道工作线程异步编译 SPIR-V(async_shader_compilation 参数控制),主线程只负责 SBT 组装与热替换,避免编译卡顿。
5. 自定义着色器与程序化几何
除了内建 PBR 材质,用户可以为材质编写自定义 RT 片段着色(顶点/片段/intersection 三段式),由 SceneShaderRaytracing 的 Hit Group 槽位系统管理(scene_shader_raytracing.h#L385-L440):
- 按 128-bit 源码哈希去重,相同源码共享槽位;
- 槽位状态机:
Empty → Pending → Ready → Failed,编译失败只影响该槽位,管线其余部分照常工作; - 支持程序化几何(
is_procedural):用 intersection 着色器求交 SDF 类形状,而非三角形 BLAS(对应RT_GEOM_FLAG_PROCEDURAL标志); - 纹理 Uniform 统一打包成 bindless 索引写入 UBO,与 bindless 描述符块协同。
6. 如何启用并调整路径追踪参数
- 硬件前提:GPU 需支持 Vulkan 光线追踪(NVIDIA RTX 20 系及以上、AMD RX 6000 系等),引擎启动时通过
RD::SUPPORTS_RAYTRACING_PIPELINE特性检测(render_forward_clustered_pt.cpp#L498-L518),不支持时自动回退 Forward+ 并打印警告; - 环境设置:在 Environment 资源中启用 Path Tracing(
pathtracing_enabled),相关字段见 environment.h#L194-L198,可调整每像素采样数(pathtracing_samples_per_pixel)、最大反弹数(pathtracing_max_bounces,默认 3)、降噪器(默认 DLSS Ray Reconstruction)与调试模式; - 项目参数:在 Project Settings 的
rendering/pathtracing/*下微调 SER、异步编译、各类缓存 TTL,定义位置见 rendering_server.cpp#L3829-L3834。
💡 性能小贴士:反弹数与 SPP 是画质/帧率的第一权衡项;场景实例数多时优先调高 MultiMesh 合并阈值,减少 BLAS 数量。
7. 关键文件速查清单
| 相对路径 | 说明 |
|---|---|
| render_raytracing.h | RenderRaytracing 类与所有 CPU 数据结构定义 |
| render_raytracing.cpp | BLAS/TLAS 构建、缓存、缓冲区组装实现(3353 行) |
| scene_shader_raytracing.h | RT 着色器变体、Hit Group、异步编译框架 |
| scene_raytracing_raygen.glsl | raygen/miss 阶段,路径积分主循环 |
| raytracing_inc.glsl | PathPayload、PCG 随机数、射线偏移工具 |
| render_forward_clustered_pt.cpp | 路径追踪渲染入口与回退逻辑 |
| rendering_server.cpp | rendering/pathtracing/* 项目参数注册 |
总结:Godot 这套光线追踪基础设施以"CPU 精确缓存 + GPU 极致压缩 + 特化常量变体"三大支柱,把硬件 RT 的高门槛转化为可维护的模块化系统——RenderRaytracing 负责场景数据的一生,SceneShaderRaytracing 负责管线的高效生成,Vulkan RT 着色器负责最终的光线旅程。理解了这三层的分工,你既能在项目里调好路径追踪画质,也有能力深入源码做二次开发。
