1. 项目概述从光栅化到光线追踪的跨越如果你和我一样是从D3D11甚至更早的固定管线时代一路摸爬滚打过来的图形程序员那么第一次接触D3D12的DirectX Ray TracingDXR时那种既兴奋又头疼的感觉一定不陌生。兴奋在于我们终于能在消费级硬件上以相对可接受的性能开销实现电影级渲染管线中的核心——光线追踪。头疼则在于DXR的API设计、管线状态对象PSO的复杂性以及那一堆全新的概念如加速结构Acceleration Structure、着色器表Shader Table、光线生成着色器Ray Generation Shader等足以让任何一个习惯了光栅化流水线的人感到一阵眩晕。“GRSDXRSamples”这个项目正是微软官方为缓解这种“眩晕”而开出的良方。它不是某个单一的应用而是微软DirectX-Graphics-Samples仓库中一个专门用于教学DXR的示例集合。这个教程的价值在于它没有一上来就扔给你一个庞大、复杂、集成了各种高级特效的渲染器而是像一位耐心的导师从最基础的“Hello World”画一个三角形开始一步步引导你搭建起整个DXR渲染管线。每个示例都聚焦于引入一两个核心概念代码结构清晰注释详尽是理解DXR底层运作机制不可多得的实战材料。对于谁适合学习这个教程我认为有三类人首先是希望将光线追踪技术引入自己引擎或项目的资深图形开发者你需要理解DXR的每一环是如何咬合的其次是学习计算机图形学并希望接触前沿实时渲染技术的学生或研究者这是最好的入门实践最后即便是对D3D12光栅化渲染已经比较熟悉的开发者通过DXR的学习你也能反过来加深对GPU并行计算、着色器模型和现代图形API设计的理解。接下来我将结合我踩过的坑和积累的经验为你深度拆解这个教程的精髓。2. 环境准备与核心依赖解析在打开Visual Studio准备编译GRSDXRSamples之前有一系列比写代码更重要的“准备工作”。这些步骤直接决定了你是能顺利看到第一个光线追踪的三角形还是会在编译或运行时被各种错误信息轰炸。根据我的经验90%的入门挫折都发生在这个阶段。2.1 硬件与驱动DXR的入场券DXR不是一项“软”功能它严重依赖GPU硬件的支持。具体来说你的显卡必须支持DirectX 12 Ultimate特性等级。这通常意味着你需要一块基于NVIDIA Turing架构RTX 20系列及之后或AMD RDNA 2架构RX 6000系列及之后的显卡。Intel的Arc系列显卡也同样支持。你可以在DirectX诊断工具运行dxdiag的“显示”标签页中查看“功能级别”是否包含“Direct3D 12 Ultimate”。比显卡型号更棘手的是驱动程序。这里我必须强调一个无数人踩过的巨坑不要使用Windows Update自动安装的或显卡厂商官网提供的“标准”驱动。对于NVIDIA显卡你必须去NVIDIA开发者网站下载并安装“Game Ready Driver”或“Studio Driver”并且确保版本足够新。一个经典的错误信息就是“安装的NVIDIA图形驱动程序版本在D3D12中存在已知问题。请安装推荐的驱动程序版本或切换到不同的渲染API。” 这个错误通常就是因为驱动太旧或版本不对缺少对某些DXR扩展或功能的完整支持。我个人的习惯是在开始DXR项目前先去NVIDIA官网查看最新的Game Ready Driver发布说明确认其包含对DXR的改进或修复然后进行安装。对于AMD显卡同样需要去AMD官网下载最新的Adrenalin Edition驱动程序。驱动问题排查是DXR开发的第一课务必重视。2.2 开发环境搭建Visual Studio与Windows SDKGRSDXRSamples是一个标准的Visual Studio解决方案因此你需要安装Visual Studio 2019 或 2022并确保勾选了“使用C的桌面开发”工作负载以及其中的“Windows 10/11 SDK”。教程本身可能对SDK版本有要求通常需要较新的版本如Windows 11 SDK 22000或更高因为DXR API本身也在不断更新。编译过程中最容易卡住的一环是HLSL编译器的配置。DXR大量使用了较新版本的HLSL语法和特性如Raytracing Shader Model 6.3及以上。项目通常配置为使用DirectX Shader Compiler (dxc.exe)来编译HLSL文件而不是传统的fxc.exe。dxc是一个独立的命令行工具但更常见的集成方式是使用DirectX Shader Compiler的NuGet包。当你打开解决方案并尝试编译时如果遇到“error MSB6006: ‘dxc.exe’ exited with code 1”或“The system cannot find the path specified. *.hlsl.h”这类错误几乎可以断定是dxc的路径或版本问题。实操心得最稳妥的解决方法是在Visual Studio中打开“工具”-“NuGet包管理器”-“管理解决方案的NuGet程序包”搜索并安装Microsoft.Direct3D.DXC这个官方包。安装后项目属性中的HLSL编译器路径会自动指向NuGet包内的dxc.exe从而避免因系统环境变量或本地路径不一致导致的编译失败。这是比手动下载dxc并配置路径更可靠的方法。2.3 项目结构与依赖库克隆或下载微软的DirectX-Graphics-Samples仓库后GRSDXRSamples通常位于一个独立的文件夹内。但请注意这些示例很可能依赖仓库根目录下的一些公共基础设施比如DXSampleHelper.h、d3dx12.h等头文件以及一些工具函数库。因此不要试图单独编译GRSDXRSamples文件夹而应该在仓库根目录打开总的解决方案文件如DirectX-Graphics-Samples.sln然后在解决方案资源管理器中找到对应的示例项目进行编译和运行。此外示例可能还依赖DirectX Tool Kit或DirectXTex等辅助库用于纹理加载和简单渲染。这些依赖通常已经以子模块Git Submodule或预编译库的形式包含在仓库中。如果编译时提示缺少某些lib文件请检查仓库的README确保你已经按照指引完成了所有子模块的初始化git submodule update --init --recursive。3. 核心概念与管线架构深度拆解理解了DXR本质上就是理解了它如何重新组织了GPU的工作方式。光栅化管线是“投射-三角形-像素”的固定流水线而DXR管线则是“发射光线-求交-着色”的可编程调度系统。GRSDXRSamples的教程顺序正是按照这个逻辑层层递进的。3.1 加速结构场景数据的GPU“索引”这是DXR区别于传统渲染最核心的数据结构。想象一下你要在包含数百万个三角形的场景中为每一条光线快速找到它击中的第一个三角形。暴力遍历是不可行的。加速结构Acceleration Structure, AS就是为解决这个问题而生的空间索引结构通常是包围体层次结构BVH。DXR将AS分为两级底层加速结构Bottom-Level Acceleration Structure, BLAS描述单个几何体如一个网格模型的三角形数据。一个BLAS可以包含多个几何体实例。顶层加速结构Top-Level Acceleration Structure, TLAS描述BLAS实例的集合。每个实例包含一个指向BLAS的引用、一个变换矩阵、一个实例掩码Instance Mask等。TLAS是光线追踪时实际查询的对象。创建AS是一个多步骤的异步过程// 1. 获取几何体描述例如三角形顶点、索引 D3D12_RAYTRACING_GEOMETRY_DESC geomDesc {}; geomDesc.Type D3D12_RAYTRACING_GEOMETRY_TYPE_TRIANGLES; geomDesc.Triangles.VertexBuffer.StartAddress vertexBuffer-GetGPUVirtualAddress(); // ... 配置其他参数 // 2. 获取构建AS所需的信息预计算大小 D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS inputs {}; inputs.Type D3D12_RAYTRACING_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL; inputs.DescsLayout D3D12_ELEMENTS_LAYOUT_ARRAY; inputs.pGeometryDescs geomDesc; inputs.NumDescs 1; D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO prebuildInfo {}; device-GetRaytracingAccelerationStructurePrebuildInfo(inputs, prebuildInfo); // 3. 分配GPU资源结果存储区和临时暂存区 // 4. 构建AS通过命令列表 cmdList-BuildRaytracingAccelerationStructure(buildDesc, 0, nullptr);注意事项BLAS通常在场景加载时或几何体静态时构建。对于动态物体每帧更新TLAS通过更新实例变换的性能开销远小于重建BLAS。因此合理的策略是静态几何体构建一次BLAS动态几何体每帧根据需要重建或更新其BLAS然后每帧重建TLAS。3.2 光线追踪管线状态对象着色器的集合在光栅化中我们有图形管线状态对象Graphics PSO。在DXR中对应的是光线追踪管线状态对象Raytracing Pipeline State Object, RTPSO。你可以把它理解为一个“着色器库”的容器和链接器。创建RTPSO的关键是定义一系列着色器并将它们分组光线生成着色器Ray Generation Shader入口点每个像素或样本启动一个线程组负责发射主光线。相交着色器Intersection Shader可编程的求交函数。对于三角形DXR有内置的求交对于自定义几何体如体素、解析曲面你需要自己实现。任意命中着色器Any Hit Shader在光线与几何体求交成功后、确定最近命中点之前被调用。常用于处理透明度alpha test或阴影。最近命中着色器Closest Hit Shader当确定光线击中了最近的几何体后调用负责计算该点的着色颜色、法线、材质等。未命中着色器Miss Shader当光线没有击中任何几何体时调用通常用于返回环境色或天空盒。这些着色器首先被编译成DXIL库.hlsl文件编译后然后通过子对象Subobject关联到RTPSO中并最终组织成命中组Hit Group。一个命中组可以绑定一个交集着色器、一个任意命中着色器和一个最近命中着色器。这种设计提供了极大的灵活性。3.3 着色器表管线与数据的桥梁这是DXR中最容易让人困惑但也最精妙的设计之一。着色器表Shader Table本质上是一块GPU可读的缓冲区它存储了每个着色器程序的入口点地址以及与之绑定的每实例或每几何体的参数如材质索引、纹理句柄、常量缓冲区地址等。当你在光线生成着色器中调用TraceRay()时GPU会使用射线的信息如实例掩码、射线类型去查询TLAS找到命中的几何体实例然后根据该实例在TLAS中的索引去着色器表中找到对应的命中组和其绑定的资源再执行相应的着色器。着色器表的布局需要开发者手动管理通常是一个结构体数组struct ShaderRecord { void* shaderIdentifier; // 由设备-GetShaderIdentifier()获取 ConstantBufferView materialCBV; // 该着色器实例独有的数据 // ... 其他资源 };你需要为每个光线生成着色器、每个命中组、每个未命中着色器都创建一条记录。着色器表的大小和对齐方式必须符合D3D12的要求通常是64字节对齐否则会导致难以排查的GPU执行错误或设备移除。核心技巧在“Hello World”示例中着色器表可能只包含一个三角形的一个命中组。但在“Procedural Geometry”示例中你会看到如何为一个几何体定义多个命中组例如为不同的射线类型主光线、阴影光线以及如何通过着色器表索引来区分它们。理解着色器表到命中组再到具体几何体实例的映射关系是掌握DXR编程模型的关键。4. 教程示例逐级精讲与实操要点GRSDXRSamples的教程示例是精心设计的阶梯。我们跳过简单的代码罗列重点分析每个示例引入的新概念和其中容易出错的实操细节。4.1 示例1Hello World - 绘制第一个光线追踪三角形这个示例的目标极其单纯不用顶点缓冲区不用光栅化只用DXR在屏幕中央画一个白色的三角形。核心实现步骤创建BLAS虽然只有一个三角形但仍需为其创建一个BLAS。这里的几何体描述D3D12_RAYTRACING_GEOMETRY_DESC中的顶点数据是直接在代码里硬编码的三个顶点坐标。创建TLAS创建一个只包含上述BLAS一个实例的TLAS。编译着色器只需要三个着色器RayGen为每个像素发射一条从摄像机出发、穿过该像素的射线。ClosestHit当射线击中三角形时返回固定颜色白色。Miss当射线未击中时返回黑色。创建RTPSO和着色器表将上述着色器关联起来并创建对应的着色器表记录。调度与执行在命令列表中设置根签名和描述符堆绑定TLAS作为着色器资源视图SRV然后调用DispatchRays()来启动光线追踪计算。避坑指南很多新手在这里遇到的第一个运行时黑屏问题往往是因为描述符堆Descriptor Heap没有正确绑定。DispatchRays()调用前后你需要确保用于绑定加速结构SRV和输出UAV的描述符堆已经通过SetDescriptorHeaps()设置好。此外传递给DispatchRays()的DispatchRaysDesc结构体中的Width和Height必须与你的光线生成着色器线程组大小匹配通常就是渲染目标的分辨率。4.2 示例2Simple Lighting - 引入动态与交互这个示例在“Hello World”的基础上增加了动态摄像机、一个立方体和一个动态点光源并计算简单的漫反射光照。关键进阶点每帧更新TLAS因为摄像机动态移动视图矩阵每帧变化所以从摄像机发射的射线方向每帧都不同。但更重要的是示例演示了如何每帧重建TLAS。虽然BLAS立方体本身没变但TLAS需要每帧用新的实例描述包含变换矩阵来重建。这是动态场景的基础。着色器中的资源访问在最近命中着色器中你需要访问顶点缓冲区、索引缓冲区来计算命中点的位置、法线和材质。这些资源通过全局根签名Global Root Signature或着色器表记录中的本地资源传递进来。示例展示了如何通过根参数绑定常量缓冲区存储摄像机、光源位置和结构化缓冲区存储顶点数据。多帧资源管理与同步由于TLAS每帧重建你必须小心处理GPU资源的生命周期。通常采用帧资源Frame Resource或环形缓冲区Ring Buffer的模式确保前一帧的渲染命令完成后再复用或释放用于构建AS的资源。4.3 示例3Procedural Geometry - 自定义求交与多射线类型这是理解DXR灵活性的关键示例。它不再渲染三角形网格而是渲染一个程序化几何体如无限平面、球体并引入了阴影射线。核心概念解析相交着色器Intersection Shader对于球体这种非三角形几何体DXR的内置三角形求交器无效。你需要编写自定义的相交着色器。在这个着色器中你接收射线的参数原点、方向根据球体的解析方程进行数学求交计算如果相交则通过ReportHit()函数报告交点的距离和命中属性。命中属性Hit Attribute在ReportHit()时你可以附带一些自定义数据如交点的法向量、纹理坐标。这些数据会被传递到后续的任意命中或最近命中着色器中。多射线类型Ray Type这是实现复杂效果如反射、折射、阴影的基石。示例中定义了两类射线RayType_Radiance主光线用于计算直接光照颜色。RayType_Shadow阴影光线从着色点射向光源仅用于判断可见性。 在着色器表中你需要为同一个几何体定义不同的命中组来对应不同的射线类型。例如对于RayType_Radiance命中组绑定计算颜色的最近命中着色器对于RayType_Shadow命中组可能绑定一个立即返回“被遮挡”的任意命中着色器。在着色器中发射新射线在最近命中着色器中你可以使用TraceRay()函数发射新的阴影射线。通过指定射线类型RayType_ShadowDXR会自动路由到对应的命中组。实操心得程序化几何体的性能可以非常高因为它避免了顶点数据的传输和存储开销。但编写正确的相交着色器需要扎实的数学功底。一个常见的错误是忽略射线的TMin和TMax参数导致报告了无效的在射线段之外的交点。另一个难点是命中属性的插值对于三角形DXR会自动插值顶点属性对于程序化几何体你需要自己在相交着色器中计算并传递。4.4 示例4 5 6高级特性初探后续示例引入了更高级的DXR特性虽然复杂但代表了性能优化和效果增强的方向。示例4Library Subobjects展示了如何将多个HLSL文件编译成不同的库Library然后在运行时通过“子对象”API动态组合成RTPSO。这提供了更大的灵活性允许你像搭积木一样组合着色器功能而无需重新编译整个大的着色器集合。示例5 6Shader Execution Reordering (SER)这是DXR 1.1引入的重要性能优化特性。光线追踪是高度不一致的工作负载——有些光线简单击中背景有些复杂击中玻璃产生多条次级射线。这会导致GPU线程束Warp内线程发散严重降低效率。SER允许GPU在运行时动态地对光线进行重新排序将行为相似例如都击中同一种材质的线程分组到一起执行从而显著提升着色器执行效率。示例5用一个极简场景演示了SER的API使用示例6则在一个复杂的樱花森林场景中展示了SER带来的巨大性能提升。5. 常见问题、调试技巧与性能优化即使你一步步跟着教程做也难免会遇到各种光怪陆离的问题。下面是我在开发和教学中总结的一些常见“坑点”和解决思路。5.1 编译与运行时错误排查表错误现象可能原因排查步骤与解决方案编译错误dxc.exeexited with code 1HLSL编译器路径错误或版本不兼容。1. 检查项目属性中HLSL编译器的命令行参数特别是-T着色器目标如lib_6_6和-E入口点是否正确。2. 安装Microsoft.Direct3D.DXCNuGet包让VS自动管理dxc。编译错误无法打开d3dx12.h等头文件项目依赖的公共头文件路径不正确。确保在正确的解决方案层级仓库根目录的sln打开项目并设置正确的附加包含目录。运行时崩溃设备移除Device RemovedGPU执行了非法操作原因多样。1.优先检查着色器表确保着色器表缓冲区的大小、对齐、内容完全正确特别是ShaderIdentifier的获取和拷贝。2. 使用PIX for Windows或Nsight Graphics进行GPU调试捕获一帧查看DispatchRays调用前后的资源状态和错误信息。3. 检查加速结构构建描述符的参数是否正确例如几何标志D3D12_RAYTRACING_GEOMETRY_FLAGS是否设置合理。运行时黑屏无输出光线追踪管线未正确执行。1. 检查DispatchRays()的调用参数尤其是Width/Height是否与渲染目标匹配。2. 检查根签名和描述符堆绑定是否在命令列表中正确设置。确保加速结构的SRV和输出纹理的UAV已绑定到正确的寄存器槽。3. 在PIX中验证RayGen着色器是否真的被调度执行。渲染结果错误如颜色不对、几何体缺失着色器逻辑错误或资源绑定错误。1. 使用printf调试HLSL的DebugPrintf扩展需要SM 6.6在着色器中输出中间值。2. 在PIX中检查传递给着色器的常量缓冲区、纹理等资源的内容是否正确。3. 对于几何体缺失检查加速结构特别是BLAS构建时使用的顶点/索引数据格式、偏移量是否正确。5.2 性能优化核心思路光线追踪性能开销巨大优化是永恒的主题。加速结构构建优化静态几何体尽可能使用D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BUILD_FLAG_PREFER_FAST_TRACE标志构建BLAS这会生成更优的BVH用于遍历Trace而非构建Build。动态几何体如果几何体只是变形如蒙皮动画考虑使用D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BUILD_FLAG_ALLOW_UPDATE标志然后使用UpdateRaytracingAccelerationStructure进行增量更新这比完全重建快得多。实例消隐Instance Culling在构建TLAS时通过实例掩码Instance Mask或设置实例的变换矩阵为全零可以在硬件层面剔除整个实例避免不必要的求交。着色器与管线优化减少射线深度和数量这是最直接的优化。限制反射/折射的反弹次数谨慎使用区域光源需要发射多条采样射线。利用着色器执行重排序SER如果硬件支持DXR 1.1积极使用SER对复杂材质或场景进行优化。简化任意命中着色器AnyHit着色器会严重打断GPU的并行性尽量保持其逻辑简单或考虑用AlphaToMask等光栅化技术替代透明度测试。内存与带宽优化压缩着色器表避免在着色器表中存储大量重复或冗余的数据。使用索引间接查找更大的常量缓冲区。纹理采样优化使用Mipmap和纹理压缩。对于光线追踪频繁采样的环境贴图等考虑使用重要性采样或预滤波的贴图。5.3 调试工具链推荐PIX for Windows微软官方的DirectX调试神器。对于DXR它可以捕获完整的GPU工作负载让你可视化每一条射线的路径、检查加速结构、单步调试着色器通过WARP设备、查看着色器表内容。是解决DXR问题的首选工具。Nsight Graphics (NVIDIA)/Radeon GPU Profiler (AMD)显卡厂商提供的深度性能分析工具。可以分析GPU利用率、查看BVH结构、进行着色器性能分析对优化至关重要。Visual Studio Graphics Debugger集成在VS中的调试工具可以捕获帧并进行基础分析但功能上不如PIX强大。D3D12 Debug Layer在创建设备时启用调试层D3D12_CREATE_DEVICE_FLAG_DEBUG它会在运行时输出大量的验证和错误信息帮助发现API使用不当的问题。走通GRSDXRSamples的每一个示例就像是完成了一次从徒步到驾驶的升级。你不再只是沿着光栅化这条固定公路前进而是获得了在三维空间任意“发射光线”探索的自由。这种自由带来的是更逼真的渲染效果可能性但同时也将管线控制的复杂性和性能优化的责任完全交给了开发者。理解加速结构、着色器表、射线类型这些核心概念并熟练使用PIX等调试工具是驾驭这份自由的基础。当你能够基于这些示例改造出自己的第一个动态光线追踪阴影或是为一个复杂模型加上反射效果时那种成就感是光栅化编程难以比拟的。这条路挑战重重但风景独好。
DXR光线追踪入门：从核心概念到实战，掌握DirectX Ray Tracing开发
1. 项目概述从光栅化到光线追踪的跨越如果你和我一样是从D3D11甚至更早的固定管线时代一路摸爬滚打过来的图形程序员那么第一次接触D3D12的DirectX Ray TracingDXR时那种既兴奋又头疼的感觉一定不陌生。兴奋在于我们终于能在消费级硬件上以相对可接受的性能开销实现电影级渲染管线中的核心——光线追踪。头疼则在于DXR的API设计、管线状态对象PSO的复杂性以及那一堆全新的概念如加速结构Acceleration Structure、着色器表Shader Table、光线生成着色器Ray Generation Shader等足以让任何一个习惯了光栅化流水线的人感到一阵眩晕。“GRSDXRSamples”这个项目正是微软官方为缓解这种“眩晕”而开出的良方。它不是某个单一的应用而是微软DirectX-Graphics-Samples仓库中一个专门用于教学DXR的示例集合。这个教程的价值在于它没有一上来就扔给你一个庞大、复杂、集成了各种高级特效的渲染器而是像一位耐心的导师从最基础的“Hello World”画一个三角形开始一步步引导你搭建起整个DXR渲染管线。每个示例都聚焦于引入一两个核心概念代码结构清晰注释详尽是理解DXR底层运作机制不可多得的实战材料。对于谁适合学习这个教程我认为有三类人首先是希望将光线追踪技术引入自己引擎或项目的资深图形开发者你需要理解DXR的每一环是如何咬合的其次是学习计算机图形学并希望接触前沿实时渲染技术的学生或研究者这是最好的入门实践最后即便是对D3D12光栅化渲染已经比较熟悉的开发者通过DXR的学习你也能反过来加深对GPU并行计算、着色器模型和现代图形API设计的理解。接下来我将结合我踩过的坑和积累的经验为你深度拆解这个教程的精髓。2. 环境准备与核心依赖解析在打开Visual Studio准备编译GRSDXRSamples之前有一系列比写代码更重要的“准备工作”。这些步骤直接决定了你是能顺利看到第一个光线追踪的三角形还是会在编译或运行时被各种错误信息轰炸。根据我的经验90%的入门挫折都发生在这个阶段。2.1 硬件与驱动DXR的入场券DXR不是一项“软”功能它严重依赖GPU硬件的支持。具体来说你的显卡必须支持DirectX 12 Ultimate特性等级。这通常意味着你需要一块基于NVIDIA Turing架构RTX 20系列及之后或AMD RDNA 2架构RX 6000系列及之后的显卡。Intel的Arc系列显卡也同样支持。你可以在DirectX诊断工具运行dxdiag的“显示”标签页中查看“功能级别”是否包含“Direct3D 12 Ultimate”。比显卡型号更棘手的是驱动程序。这里我必须强调一个无数人踩过的巨坑不要使用Windows Update自动安装的或显卡厂商官网提供的“标准”驱动。对于NVIDIA显卡你必须去NVIDIA开发者网站下载并安装“Game Ready Driver”或“Studio Driver”并且确保版本足够新。一个经典的错误信息就是“安装的NVIDIA图形驱动程序版本在D3D12中存在已知问题。请安装推荐的驱动程序版本或切换到不同的渲染API。” 这个错误通常就是因为驱动太旧或版本不对缺少对某些DXR扩展或功能的完整支持。我个人的习惯是在开始DXR项目前先去NVIDIA官网查看最新的Game Ready Driver发布说明确认其包含对DXR的改进或修复然后进行安装。对于AMD显卡同样需要去AMD官网下载最新的Adrenalin Edition驱动程序。驱动问题排查是DXR开发的第一课务必重视。2.2 开发环境搭建Visual Studio与Windows SDKGRSDXRSamples是一个标准的Visual Studio解决方案因此你需要安装Visual Studio 2019 或 2022并确保勾选了“使用C的桌面开发”工作负载以及其中的“Windows 10/11 SDK”。教程本身可能对SDK版本有要求通常需要较新的版本如Windows 11 SDK 22000或更高因为DXR API本身也在不断更新。编译过程中最容易卡住的一环是HLSL编译器的配置。DXR大量使用了较新版本的HLSL语法和特性如Raytracing Shader Model 6.3及以上。项目通常配置为使用DirectX Shader Compiler (dxc.exe)来编译HLSL文件而不是传统的fxc.exe。dxc是一个独立的命令行工具但更常见的集成方式是使用DirectX Shader Compiler的NuGet包。当你打开解决方案并尝试编译时如果遇到“error MSB6006: ‘dxc.exe’ exited with code 1”或“The system cannot find the path specified. *.hlsl.h”这类错误几乎可以断定是dxc的路径或版本问题。实操心得最稳妥的解决方法是在Visual Studio中打开“工具”-“NuGet包管理器”-“管理解决方案的NuGet程序包”搜索并安装Microsoft.Direct3D.DXC这个官方包。安装后项目属性中的HLSL编译器路径会自动指向NuGet包内的dxc.exe从而避免因系统环境变量或本地路径不一致导致的编译失败。这是比手动下载dxc并配置路径更可靠的方法。2.3 项目结构与依赖库克隆或下载微软的DirectX-Graphics-Samples仓库后GRSDXRSamples通常位于一个独立的文件夹内。但请注意这些示例很可能依赖仓库根目录下的一些公共基础设施比如DXSampleHelper.h、d3dx12.h等头文件以及一些工具函数库。因此不要试图单独编译GRSDXRSamples文件夹而应该在仓库根目录打开总的解决方案文件如DirectX-Graphics-Samples.sln然后在解决方案资源管理器中找到对应的示例项目进行编译和运行。此外示例可能还依赖DirectX Tool Kit或DirectXTex等辅助库用于纹理加载和简单渲染。这些依赖通常已经以子模块Git Submodule或预编译库的形式包含在仓库中。如果编译时提示缺少某些lib文件请检查仓库的README确保你已经按照指引完成了所有子模块的初始化git submodule update --init --recursive。3. 核心概念与管线架构深度拆解理解了DXR本质上就是理解了它如何重新组织了GPU的工作方式。光栅化管线是“投射-三角形-像素”的固定流水线而DXR管线则是“发射光线-求交-着色”的可编程调度系统。GRSDXRSamples的教程顺序正是按照这个逻辑层层递进的。3.1 加速结构场景数据的GPU“索引”这是DXR区别于传统渲染最核心的数据结构。想象一下你要在包含数百万个三角形的场景中为每一条光线快速找到它击中的第一个三角形。暴力遍历是不可行的。加速结构Acceleration Structure, AS就是为解决这个问题而生的空间索引结构通常是包围体层次结构BVH。DXR将AS分为两级底层加速结构Bottom-Level Acceleration Structure, BLAS描述单个几何体如一个网格模型的三角形数据。一个BLAS可以包含多个几何体实例。顶层加速结构Top-Level Acceleration Structure, TLAS描述BLAS实例的集合。每个实例包含一个指向BLAS的引用、一个变换矩阵、一个实例掩码Instance Mask等。TLAS是光线追踪时实际查询的对象。创建AS是一个多步骤的异步过程// 1. 获取几何体描述例如三角形顶点、索引 D3D12_RAYTRACING_GEOMETRY_DESC geomDesc {}; geomDesc.Type D3D12_RAYTRACING_GEOMETRY_TYPE_TRIANGLES; geomDesc.Triangles.VertexBuffer.StartAddress vertexBuffer-GetGPUVirtualAddress(); // ... 配置其他参数 // 2. 获取构建AS所需的信息预计算大小 D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS inputs {}; inputs.Type D3D12_RAYTRACING_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL; inputs.DescsLayout D3D12_ELEMENTS_LAYOUT_ARRAY; inputs.pGeometryDescs geomDesc; inputs.NumDescs 1; D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO prebuildInfo {}; device-GetRaytracingAccelerationStructurePrebuildInfo(inputs, prebuildInfo); // 3. 分配GPU资源结果存储区和临时暂存区 // 4. 构建AS通过命令列表 cmdList-BuildRaytracingAccelerationStructure(buildDesc, 0, nullptr);注意事项BLAS通常在场景加载时或几何体静态时构建。对于动态物体每帧更新TLAS通过更新实例变换的性能开销远小于重建BLAS。因此合理的策略是静态几何体构建一次BLAS动态几何体每帧根据需要重建或更新其BLAS然后每帧重建TLAS。3.2 光线追踪管线状态对象着色器的集合在光栅化中我们有图形管线状态对象Graphics PSO。在DXR中对应的是光线追踪管线状态对象Raytracing Pipeline State Object, RTPSO。你可以把它理解为一个“着色器库”的容器和链接器。创建RTPSO的关键是定义一系列着色器并将它们分组光线生成着色器Ray Generation Shader入口点每个像素或样本启动一个线程组负责发射主光线。相交着色器Intersection Shader可编程的求交函数。对于三角形DXR有内置的求交对于自定义几何体如体素、解析曲面你需要自己实现。任意命中着色器Any Hit Shader在光线与几何体求交成功后、确定最近命中点之前被调用。常用于处理透明度alpha test或阴影。最近命中着色器Closest Hit Shader当确定光线击中了最近的几何体后调用负责计算该点的着色颜色、法线、材质等。未命中着色器Miss Shader当光线没有击中任何几何体时调用通常用于返回环境色或天空盒。这些着色器首先被编译成DXIL库.hlsl文件编译后然后通过子对象Subobject关联到RTPSO中并最终组织成命中组Hit Group。一个命中组可以绑定一个交集着色器、一个任意命中着色器和一个最近命中着色器。这种设计提供了极大的灵活性。3.3 着色器表管线与数据的桥梁这是DXR中最容易让人困惑但也最精妙的设计之一。着色器表Shader Table本质上是一块GPU可读的缓冲区它存储了每个着色器程序的入口点地址以及与之绑定的每实例或每几何体的参数如材质索引、纹理句柄、常量缓冲区地址等。当你在光线生成着色器中调用TraceRay()时GPU会使用射线的信息如实例掩码、射线类型去查询TLAS找到命中的几何体实例然后根据该实例在TLAS中的索引去着色器表中找到对应的命中组和其绑定的资源再执行相应的着色器。着色器表的布局需要开发者手动管理通常是一个结构体数组struct ShaderRecord { void* shaderIdentifier; // 由设备-GetShaderIdentifier()获取 ConstantBufferView materialCBV; // 该着色器实例独有的数据 // ... 其他资源 };你需要为每个光线生成着色器、每个命中组、每个未命中着色器都创建一条记录。着色器表的大小和对齐方式必须符合D3D12的要求通常是64字节对齐否则会导致难以排查的GPU执行错误或设备移除。核心技巧在“Hello World”示例中着色器表可能只包含一个三角形的一个命中组。但在“Procedural Geometry”示例中你会看到如何为一个几何体定义多个命中组例如为不同的射线类型主光线、阴影光线以及如何通过着色器表索引来区分它们。理解着色器表到命中组再到具体几何体实例的映射关系是掌握DXR编程模型的关键。4. 教程示例逐级精讲与实操要点GRSDXRSamples的教程示例是精心设计的阶梯。我们跳过简单的代码罗列重点分析每个示例引入的新概念和其中容易出错的实操细节。4.1 示例1Hello World - 绘制第一个光线追踪三角形这个示例的目标极其单纯不用顶点缓冲区不用光栅化只用DXR在屏幕中央画一个白色的三角形。核心实现步骤创建BLAS虽然只有一个三角形但仍需为其创建一个BLAS。这里的几何体描述D3D12_RAYTRACING_GEOMETRY_DESC中的顶点数据是直接在代码里硬编码的三个顶点坐标。创建TLAS创建一个只包含上述BLAS一个实例的TLAS。编译着色器只需要三个着色器RayGen为每个像素发射一条从摄像机出发、穿过该像素的射线。ClosestHit当射线击中三角形时返回固定颜色白色。Miss当射线未击中时返回黑色。创建RTPSO和着色器表将上述着色器关联起来并创建对应的着色器表记录。调度与执行在命令列表中设置根签名和描述符堆绑定TLAS作为着色器资源视图SRV然后调用DispatchRays()来启动光线追踪计算。避坑指南很多新手在这里遇到的第一个运行时黑屏问题往往是因为描述符堆Descriptor Heap没有正确绑定。DispatchRays()调用前后你需要确保用于绑定加速结构SRV和输出UAV的描述符堆已经通过SetDescriptorHeaps()设置好。此外传递给DispatchRays()的DispatchRaysDesc结构体中的Width和Height必须与你的光线生成着色器线程组大小匹配通常就是渲染目标的分辨率。4.2 示例2Simple Lighting - 引入动态与交互这个示例在“Hello World”的基础上增加了动态摄像机、一个立方体和一个动态点光源并计算简单的漫反射光照。关键进阶点每帧更新TLAS因为摄像机动态移动视图矩阵每帧变化所以从摄像机发射的射线方向每帧都不同。但更重要的是示例演示了如何每帧重建TLAS。虽然BLAS立方体本身没变但TLAS需要每帧用新的实例描述包含变换矩阵来重建。这是动态场景的基础。着色器中的资源访问在最近命中着色器中你需要访问顶点缓冲区、索引缓冲区来计算命中点的位置、法线和材质。这些资源通过全局根签名Global Root Signature或着色器表记录中的本地资源传递进来。示例展示了如何通过根参数绑定常量缓冲区存储摄像机、光源位置和结构化缓冲区存储顶点数据。多帧资源管理与同步由于TLAS每帧重建你必须小心处理GPU资源的生命周期。通常采用帧资源Frame Resource或环形缓冲区Ring Buffer的模式确保前一帧的渲染命令完成后再复用或释放用于构建AS的资源。4.3 示例3Procedural Geometry - 自定义求交与多射线类型这是理解DXR灵活性的关键示例。它不再渲染三角形网格而是渲染一个程序化几何体如无限平面、球体并引入了阴影射线。核心概念解析相交着色器Intersection Shader对于球体这种非三角形几何体DXR的内置三角形求交器无效。你需要编写自定义的相交着色器。在这个着色器中你接收射线的参数原点、方向根据球体的解析方程进行数学求交计算如果相交则通过ReportHit()函数报告交点的距离和命中属性。命中属性Hit Attribute在ReportHit()时你可以附带一些自定义数据如交点的法向量、纹理坐标。这些数据会被传递到后续的任意命中或最近命中着色器中。多射线类型Ray Type这是实现复杂效果如反射、折射、阴影的基石。示例中定义了两类射线RayType_Radiance主光线用于计算直接光照颜色。RayType_Shadow阴影光线从着色点射向光源仅用于判断可见性。 在着色器表中你需要为同一个几何体定义不同的命中组来对应不同的射线类型。例如对于RayType_Radiance命中组绑定计算颜色的最近命中着色器对于RayType_Shadow命中组可能绑定一个立即返回“被遮挡”的任意命中着色器。在着色器中发射新射线在最近命中着色器中你可以使用TraceRay()函数发射新的阴影射线。通过指定射线类型RayType_ShadowDXR会自动路由到对应的命中组。实操心得程序化几何体的性能可以非常高因为它避免了顶点数据的传输和存储开销。但编写正确的相交着色器需要扎实的数学功底。一个常见的错误是忽略射线的TMin和TMax参数导致报告了无效的在射线段之外的交点。另一个难点是命中属性的插值对于三角形DXR会自动插值顶点属性对于程序化几何体你需要自己在相交着色器中计算并传递。4.4 示例4 5 6高级特性初探后续示例引入了更高级的DXR特性虽然复杂但代表了性能优化和效果增强的方向。示例4Library Subobjects展示了如何将多个HLSL文件编译成不同的库Library然后在运行时通过“子对象”API动态组合成RTPSO。这提供了更大的灵活性允许你像搭积木一样组合着色器功能而无需重新编译整个大的着色器集合。示例5 6Shader Execution Reordering (SER)这是DXR 1.1引入的重要性能优化特性。光线追踪是高度不一致的工作负载——有些光线简单击中背景有些复杂击中玻璃产生多条次级射线。这会导致GPU线程束Warp内线程发散严重降低效率。SER允许GPU在运行时动态地对光线进行重新排序将行为相似例如都击中同一种材质的线程分组到一起执行从而显著提升着色器执行效率。示例5用一个极简场景演示了SER的API使用示例6则在一个复杂的樱花森林场景中展示了SER带来的巨大性能提升。5. 常见问题、调试技巧与性能优化即使你一步步跟着教程做也难免会遇到各种光怪陆离的问题。下面是我在开发和教学中总结的一些常见“坑点”和解决思路。5.1 编译与运行时错误排查表错误现象可能原因排查步骤与解决方案编译错误dxc.exeexited with code 1HLSL编译器路径错误或版本不兼容。1. 检查项目属性中HLSL编译器的命令行参数特别是-T着色器目标如lib_6_6和-E入口点是否正确。2. 安装Microsoft.Direct3D.DXCNuGet包让VS自动管理dxc。编译错误无法打开d3dx12.h等头文件项目依赖的公共头文件路径不正确。确保在正确的解决方案层级仓库根目录的sln打开项目并设置正确的附加包含目录。运行时崩溃设备移除Device RemovedGPU执行了非法操作原因多样。1.优先检查着色器表确保着色器表缓冲区的大小、对齐、内容完全正确特别是ShaderIdentifier的获取和拷贝。2. 使用PIX for Windows或Nsight Graphics进行GPU调试捕获一帧查看DispatchRays调用前后的资源状态和错误信息。3. 检查加速结构构建描述符的参数是否正确例如几何标志D3D12_RAYTRACING_GEOMETRY_FLAGS是否设置合理。运行时黑屏无输出光线追踪管线未正确执行。1. 检查DispatchRays()的调用参数尤其是Width/Height是否与渲染目标匹配。2. 检查根签名和描述符堆绑定是否在命令列表中正确设置。确保加速结构的SRV和输出纹理的UAV已绑定到正确的寄存器槽。3. 在PIX中验证RayGen着色器是否真的被调度执行。渲染结果错误如颜色不对、几何体缺失着色器逻辑错误或资源绑定错误。1. 使用printf调试HLSL的DebugPrintf扩展需要SM 6.6在着色器中输出中间值。2. 在PIX中检查传递给着色器的常量缓冲区、纹理等资源的内容是否正确。3. 对于几何体缺失检查加速结构特别是BLAS构建时使用的顶点/索引数据格式、偏移量是否正确。5.2 性能优化核心思路光线追踪性能开销巨大优化是永恒的主题。加速结构构建优化静态几何体尽可能使用D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BUILD_FLAG_PREFER_FAST_TRACE标志构建BLAS这会生成更优的BVH用于遍历Trace而非构建Build。动态几何体如果几何体只是变形如蒙皮动画考虑使用D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BUILD_FLAG_ALLOW_UPDATE标志然后使用UpdateRaytracingAccelerationStructure进行增量更新这比完全重建快得多。实例消隐Instance Culling在构建TLAS时通过实例掩码Instance Mask或设置实例的变换矩阵为全零可以在硬件层面剔除整个实例避免不必要的求交。着色器与管线优化减少射线深度和数量这是最直接的优化。限制反射/折射的反弹次数谨慎使用区域光源需要发射多条采样射线。利用着色器执行重排序SER如果硬件支持DXR 1.1积极使用SER对复杂材质或场景进行优化。简化任意命中着色器AnyHit着色器会严重打断GPU的并行性尽量保持其逻辑简单或考虑用AlphaToMask等光栅化技术替代透明度测试。内存与带宽优化压缩着色器表避免在着色器表中存储大量重复或冗余的数据。使用索引间接查找更大的常量缓冲区。纹理采样优化使用Mipmap和纹理压缩。对于光线追踪频繁采样的环境贴图等考虑使用重要性采样或预滤波的贴图。5.3 调试工具链推荐PIX for Windows微软官方的DirectX调试神器。对于DXR它可以捕获完整的GPU工作负载让你可视化每一条射线的路径、检查加速结构、单步调试着色器通过WARP设备、查看着色器表内容。是解决DXR问题的首选工具。Nsight Graphics (NVIDIA)/Radeon GPU Profiler (AMD)显卡厂商提供的深度性能分析工具。可以分析GPU利用率、查看BVH结构、进行着色器性能分析对优化至关重要。Visual Studio Graphics Debugger集成在VS中的调试工具可以捕获帧并进行基础分析但功能上不如PIX强大。D3D12 Debug Layer在创建设备时启用调试层D3D12_CREATE_DEVICE_FLAG_DEBUG它会在运行时输出大量的验证和错误信息帮助发现API使用不当的问题。走通GRSDXRSamples的每一个示例就像是完成了一次从徒步到驾驶的升级。你不再只是沿着光栅化这条固定公路前进而是获得了在三维空间任意“发射光线”探索的自由。这种自由带来的是更逼真的渲染效果可能性但同时也将管线控制的复杂性和性能优化的责任完全交给了开发者。理解加速结构、着色器表、射线类型这些核心概念并熟练使用PIX等调试工具是驾驭这份自由的基础。当你能够基于这些示例改造出自己的第一个动态光线追踪阴影或是为一个复杂模型加上反射效果时那种成就感是光栅化编程难以比拟的。这条路挑战重重但风景独好。
