Godot光线追踪基础设施详解:RenderRaytracing类与Vulkan RT着色器全解析

原创2026-11-05 17:00:261,904 阅读

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/ 目录中的分工。即使你没有图形学背景,也能通过本文建立清晰的认知框架。

Godot引擎启动画面,展示跨平台2D/3D游戏引擎的整体形象

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):

  1. 静态网格缓存:按 RID 分块(每块 256 槽)的稀疏缓存,未变化网格直接复用旧 BLAS;
  2. MultiMesh 合并 BLAS 缓存(RTMergedMMEntry):用计算着色器(multimesh_merge.glsl)把数百个实例的顶点一次性烘焙进单个大 BLAS,避免每个实例单独建树,三角形数上限由项目参数 rendering/pathtracing/multimesh_merged_blas_max_triangles 控制;
  3. 变形网格缓存(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. 如何启用并调整路径追踪参数

  1. 硬件前提:GPU 需支持 Vulkan 光线追踪(NVIDIA RTX 20 系及以上、AMD RX 6000 系等),引擎启动时通过 RD::SUPPORTS_RAYTRACING_PIPELINE 特性检测(render_forward_clustered_pt.cpp#L498-L518),不支持时自动回退 Forward+ 并打印警告;
  2. 环境设置:在 Environment 资源中启用 Path Tracing(pathtracing_enabled),相关字段见 environment.h#L194-L198,可调整每像素采样数(pathtracing_samples_per_pixel)、最大反弹数(pathtracing_max_bounces,默认 3)、降噪器(默认 DLSS Ray Reconstruction)与调试模式;
  3. 项目参数:在 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 着色器负责最终的光线旅程。理解了这三层的分工,你既能在项目里调好路径追踪画质,也有能力深入源码做二次开发。

登录后查看全文
godot