# 硬件光追与实验性近场路径追踪 插件在游戏显卡上创建 D3D12 设备,构建真实三角形 BLAS/TLAS,运行 DXR 1.1 inline ray query。近场路径追踪在引擎 `MyGBufferResolver.ConsumeWork` 完成后、透明绘制前,对覆盖的不透明表面重新积分自发光、直接光、环境光和 BSDF 多次反弹,写回原生 HDR 光照缓冲;透明绘制完成后单独处理玻璃。原有混合模式仍在场景绘制后执行。真实几何首命中受光栅深度校验,未覆盖对象、天空和远景保留原版。玻璃继续使用混合透明模型。这不是完整 DX12 引擎迁移或全场景路径追踪。 游戏内进入 **选项 → 图形选项(画质)→ 光追 / 路径追踪**。使用原版 GUI 控件,选择关闭、混合光追、路径追踪(近场实验),再按“应用并保存”。“取消”或关闭面板不修改配置;保存后重启恢复。菜单支持射线分辨率、每帧采样、反弹次数、去噪、玻璃、体素精度及混合光照参数。路径模式下不适用的混合 AO/接触阴影/GI 强度会禁用。 ## 本版支持 - 刚性舰体、功能方块及子部件的局部反射、环境遮蔽、太阳接触阴影;GGX 金属/粗糙度反射,最多八次路径反弹。近场路径模式每帧 1–8 个样本,首表面使用 G-buffer 法线/光滑度和真实几何材质,采用直接光采样、BSDF 采样和俄罗斯轮盘终止;覆盖校验失败保留原版,不用黑色填补未知几何。 - 路径模式直接读取原生 G-buffer 的基色、金属度、光滑度和发光量;粗糙度按 `1 - gloss` 转换,只在 GGX 内平方一次。采用可见法线 GGX 采样,按菲涅耳反射与漫反射能量分配支路概率;纯金属不再浪费固定四分之一的样本去采样漫反射方向。环境光与 BSDF 使用多重重要性采样;存在后续反弹的近镜面纯反射材质只通过 BSDF 采样环境,同时移除对应 MIS 竞争项,避免偶然的天空采样击中极窄高光而产生亮点。引擎实时 `FarCubemapOriginal` 在 GPU 上转换为 256×128 HDR 经纬图,每帧按亮度与立体角生成分布,不回读 CPU。未命中的路径读取实际环境辐射;环境源不可用时保留原生光照,不能用黑色代替。极光滑的纯金属(粗糙度 ≤ 0.06)用镜面方向解析次级反射,避免靠几条随机射线决定反射边缘。环境覆盖限于引擎探针。 - `MESH` 材质的自发光贴图参与次级光路;扩展贴图按线性数据读取,缺失时使用无发光回退。第一人称驾驶舱采集实际内部模型,LCD 从引擎当前纹理直接在 GPU 上复制到共享纹理,屏幕内容、颜色、发光强度及可见性用于玻璃和其他表面的反射。最多 32 块屏幕、64 米范围;绑定与元数据约 10 Hz 刷新,已绑定纹理的像素每个渲染帧复制;当前驾驶舱优先。单块纹理不超过 2048×2048,总共享纹理预算 128 MiB。屏幕空间 HUD 不进入几何反射。 - 实际 `GLASS` 材质进入加速结构,窗框仍按不透明材质处理,不再根据模型文件名把整扇窗跳过。按顺序追踪玻璃层,计算菲涅耳反射、透射颜色和斜入射吸收;阴影能穿过玻璃。次级路径使用薄平行板折射,主视图通过折射后的真实命中位置、深度校验及原生 HDR 取样实现近场折射偏移。原有玻璃污渍和背景着色保留,不重复乘透射颜色。 - 相机周围 320 米内的小行星/星球体素等值面参与射线。使用本机引擎的线程独立等值面生成器和 storage pin,默认 LOD 0(1 米体素采样),后台最多四个生成任务,按距离顺序发布结果。材质取实际体素索引,以三个方向投影贴图并混合顶点材质。分块有边界采样及唯一三角形归属;体素内容/材质事件会作废旧快照并重新生成,未改写任何体素。主射线最远 256 米;不再用光栅深度加 10 厘米截断体素查询。接近光栅表面的体素命中提供次级射线起点和几何法线,避免独立 LOD 深度失配;前景遮挡的玻璃仍被拒绝。 - 最多 64 个附近灯具的点光源/聚光灯参与光照。从实际位置和材质估计贡献,确定性计算贡献最大的灯具;像素只受两个灯具影响时,分别计算各自的可见性。其余灯用 RIS 采样。主表面和清玻璃首个反射表面的确定性光照保留在当前帧锐利分量,保留灯光边界和法线贴图。 - 不透明表面记录辐射的一、二阶矩。先用同一几何表面的 5×5 当前采样估计间接光及不确定度,结合上一帧方差识别真实变化,避免稀疏高光一次采样未命中就清空历史。随后执行四轮 à-trous 空间过滤(混合模式三轮)。高光表面的空间半径还受反射方向夹角约束。过滤前分离基色因子,太阳、确定性灯光和发光量在当前帧合成。只将最小步长的过滤结果反馈到历史。 - 透视主射线由原生像素中心反投影。玻璃、体素和不透明光照共用首次几何命中,避免重复查询以及 FP16 位置量化推动射线跨越细边。历史通过实例上一帧变换重投影,并逐点检查位置、平面、法线、光滑度和材质。路径模式不复制未经滤波的确定性光照纹理。 路径模式和混合模式的随机光照均有当前帧同表面邻域约束:几何历史有效但阴影/间接光已改变时,限制旧辐射,明显不一致时首帧弃用旧值。光滑表面的历史长度还由观察方向变化与粗糙度决定,避免相机平移时把已经移走的高光留在接收面上;粗糙表面仍可积累降噪。追踪和历史处理通过独立计算调度及 UAV 屏障分开,邻域读取不会与历史写入竞争。原生射线分辨率不再重复执行 25 点双边上采样,半分辨率仍保留该步骤。 清玻璃反射中的自发光纹理和确定性太阳直射光使用当前帧独立缓冲,不参加时间积累及空间模糊。穿过第二层玻璃时,主导反射/透射支路确定性求值,次要支路的随机照明另行过滤,避免一次随机菲涅耳选择让整块反射 LCD 闪灭。随机间接光先移除命中材质因子,再以虚像位置、几何法线、粗糙度和视角变化指导五轮空间过滤,之后恢复材质因子并合成清晰层。乒乓缓冲在最后复制最终结果;另外仅保留第一轮一步长结果作为下一帧颜色历史,避免原始孤立样本反复形成移动的斑块。 玻璃虚像位置使用 FP32,引导法线使用 FP16;旧帧校验基于像素足迹,不再以厘米级量化容差接受已经错位的表面。历史混合最多约 8 帧,并根据视角变化和粗糙度进一步缩短;另以不可变的当前帧随机反射、5×5 几何匹配邻域和颜色统计校验旧光照。两块镜面的主导反射组合为虚像变换,透过第二层玻璃的命中也提供引导。主导支路射向环境时,次要支路仍需降噪:用最后一层玻璃提供保守的空间引导和有限粗糙度,禁用这类不完整光路的历史,避免零粗糙度把空间权重压成零。粗糙/多层薄板仍是有界近似,不等于完整介质路径重建。 驾驶舱第三人称/第一人称切换只更新该舱及其子部件的几何放置,不清空周围舰体、体素或正在进行的分片收集。屏幕模型的内外变体复用槽位并驻留 BLAS,非当前模型没有 TLAS 实例。当前驾驶舱优先保留内部屏幕槽位,即使最初处于第三人称也不会被附近 LCD 占满。切换时立即发布新快照并重置相机历史,不再等全场景收集完成。 透明材质优先按实际 MWM 材质名称解析,再尝试旧 `GlassCCW`/`GlassCW` 字段。当前战斗机驾驶舱的两个旧字段均为空,忽略名称会错误使用粗糙度回退并让本应清晰的玻璃反射随机抖动。`inspect.glassMaterials` 可核查实际名称、粗糙度、IOR 和假定厚度;清玻璃不再随机扰动首反射方向,粗糙玻璃仍采样。 ## 构建与使用 需要 Windows、DXR 1.1 显卡及驱动、Visual C++ x64 工具链、带 FXC/DXC 的 Windows SDK,以及项目原有 .NET 依赖。实测为 RTX 5090、Space Engineers 1.211.017。 ```powershell ./build.ps1 -RayTracing -GameBin64 'D:\SteamLibrary\steamapps\common\SpaceEngineers\Bin64' ./build.ps1 -TestRayTracing $cli='./src/XFE.SeAgent.Cli/bin/Release/net10.0/xfe-se.exe' & $cli call graphics.rayTracing.configure --params '{"enabled":true,"glass":true,"voxels":true,"bounces":3,"voxelLod":0,"persist":true}' & $cli call graphics.rayTracing.status & $cli call graphics.rayTracing.configure --params '{"enabled":false,"persist":true}' ``` 多实例时加实际 `--pid`。原生模块嵌入插件,按 SHA-256 解压并校验;仅分发自行编写的代码,游戏程序集、模型、贴图和反编译资料不进入仓库。通过 XFE 自研加载器加载,不覆盖 Steam 程序集。 初始默认关闭。`persist:true` 写入 `%LOCALAPPDATA%/XFE/SpaceEngineersAgent/raytracing.json`,普通离线世界也可启用,不修改存档。旧设置中的反射/间接光强度会保留,不被新默认值偷偷覆盖。诊断模式不持久化。 | 参数 | 范围/默认 | 含义 | | --- | --- | --- | | `enabled` | bool/false | 开关 | | `pathTracing` | bool/false | 近场不透明表面路径积分;false 为原有混合光追 | | `fullResolution` | bool/false | 射线使用原生分辨率,关闭时使用半分辨率;不修改游戏主画面分辨率 | | `samples` | 整数 1–8/1 | 路径模式每帧每像素样本数;混合模式不使用此项 | | `denoise` | bool/true | 时域积累与空间去噪;关闭可查看原始采样噪声 | | `radius` | 0.25–12/3 | AO 距离,米 | | `strength` | 0–1/0.3 | AO 混合强度 | | `shadowStrength` | 0–0.5/0.15 | 接触阴影混合强度 | | `reflections` | 0–1/0.8 | 反射混合强度 | | `indirect` | 0–1/0.6 | 间接光强度 | | `bounces` | 整数 1–8/3 | 不透明表面路径长度上限;路径模式包含首表面,混合模式从次级命中开始计数;玻璃穿越另有步数上限 | | `glass` | bool/true | 玻璃反射/透射/薄板折射;关闭时射线忽略玻璃,保留原版透明显示 | | `voxels` | bool/true | 收集附近体素 | | `voxelLod` | 整数 0–2/0 | 体素采样间隔 1/2/4 米;不改变原版体素显示质量 | | `diagnostic` | 整数 0–10/0 | 0 正常;1 AO;2 阴影;3 反射;4 间接光;5 玻璃透射;6 体素覆盖;7 路径历史长度(除以 32);8 玻璃清晰层;9 去材质因子的随机反射;10 玻璃引导覆盖(绿:有,红:无) | | `persist` | bool/false | 显式保存正常画面设置 | `enabled:true` 不代表已经生效:准备完成后 `render.state` 才为 `active`。初次收集、体素编辑或大幅移动相机后的重建阶段保留原版画面。错误、预算超限或能力不足会停用效果并报告 `failure`,不会通过降低游戏分辨率掩盖问题。 ## 线程、缓存与诊断 游戏线程按时间片收集装甲 render cell、功能方块和当前变换;后台仅合并复制的装甲数据、读取纹理或执行引擎支持的体素存储读取/等值面任务,不在工作线程遍历可变游戏实体。体素任务最多四个并行、四格前瞻,世代变化后拒绝旧结果;捕获时的材质定义读取和数组转换仍在游戏线程。时间片不能抢占一次引擎调用。 周期性场景刷新从上次收集完成后等待 15 秒;一次大型舰队收集超时不会立即触发下一轮。拓扑失效事件仍可提前重建,移动实例的变换快照继续独立更新。 约 10 Hz 的不可变快照使用三个可复用缓冲和读取租约,负责几何与材质发现。每个渲染帧在渲染线程读取对应 `MyActor.WorldMatrix`,将刚性实例同步到当前光栅姿态;同一 actor 的矩阵只读取一次,目标数组复用,不跨线程读取可变游戏实体。没有 actor 的对象保留捕获姿态,体素保留其存储原点。`render.currentRenderPoseInstances` 表示本帧同步实例数。模型和 BLAS 缓存复用,变化时增量上传并回收过期几何;仅累计空洞过大时压缩。相机移动超过 64 米立即重建收集范围,通常拓扑周期 15 秒。方块/体素变更通过世代号拒绝过期结果;卸载世界释放缓存和本机图形资源。 DX11/DX12 同适配器共享纹理,以 GPU fence 同步,临时隔离并恢复 DX11 context state。射线和去噪支持半分辨率或原生分辨率:原生 4K 分别对应 1920×1080 或 3840×2160 射线缓冲,合成在曝光、Bloom、色调映射和 HUD 之前。切换模式/尺寸/参数会重置历史。主画面与 HUD 不降分辨率。 透明结束阶段沿用同一 DX11 immediate context 已排入的 GPU fence 等待,不再额外让 CPU 等待同一 DX12 通道完成。分配器/上传缓冲复用和资源释放仍保留 CPU 等待。硬件测试先用独立 fence 阻塞 GPU,确认透明提交可以返回,再释放队列并检查回读结果及状态恢复;这项改动不移除跨 API 的 GPU 同步。 `graphics.rayTracing.status` 返回实际 DXR 层级、几何/纹理/玻璃/体素/灯具数量、缓存年龄和错误。`render.environmentProbe` 表示实际环境源是否绑定,`render.lightingStage` 表示执行阶段。`render.gpuTraceDenoiseMs` 由 D3D12 timestamp query 测量上一帧环境分布生成、射线、历史复制和去噪,**不包含**几何构建、DX11 pack/合成及整个游戏 GPU 开销;`cpuSubmitMs` 还可能包含同步等待,不能冒充 GPU 时间。 `screens` 区分成功复制的纹理、不可用纹理与隐藏屏幕,逐项列出材质、渲染对象和源纹理名称。`refreshHz:10` 表示绑定发现/元数据更新;`textureRefresh:"per-render-frame"` 表示原生端每帧读取已绑定纹理的新像素,即使引擎在原 SRV 上就地更新内容也不会等下一次发现。`graphics.rayTracing.inspect` 的 `interiorCockpit` 可核对当前第一人称内部模型及屏幕网格。超出屏幕数量/纹理预算时保留原材质回退,不宣称已覆盖全部 LCD。 `graphics.rayTracing.inspect` 可按 `model` 子串查看最多 32 个玻璃放置对象、实际三角形表面中心/法线,以及最近 64 个体素根实体的范围。它是读接口,信息取自当前快照,场景未准备好时可能为空。`debug.camera` 可在授权副本中设置固定观察镜头,或用 `look` 改变真实第一人称驾驶舱的转头角度。第一人称玻璃测试必须确认 MyCockpit 控制器及内部模型,不能以观察者镜头的结果替代,详见 [API](API.md)。 ## 公开技术依据及边界 [Cyberpunk 2077 的 SIGGRAPH 分享](https://intro-to-restir.cwyman.org/presentations/2023ReSTIR_Course_Cyberpunk_2077_Integration.pdf)建议先建立并验证 Monte Carlo 光照/BRDF 采样,再逐步接入 RIS 和时空复用。本版落实了有限反弹路径、GGX 采样、初始灯光 RIS 和几何引导的时空去噪;**没有集成 RTXDI/ReSTIR GI、NRD 或 DLSS Ray Reconstruction**,不宣称与 Overdrive 等价。[NVIDIA RTXPT 的公开设计](https://github.com/NVIDIA-RTX/RTXPT/blob/main/Docs/Design.md)还强调了路径与去噪引导数据的完整集成,不能用一个开关代替。 本次运动修复依据上述分享中的天空光采样、有效性验证和新露出区域处理思路,补齐实际环境输入和重投影。[Heitz 的可见 GGX 法线论文](https://jcgt.org/published/0007/04/01/paper.pdf)用于降低 BSDF 采样方差;[NRD 的集成说明](https://github.com/NVIDIA-RTX/NRD/blob/master/README.md)用于核对材质分离和运动引导数据需求。[SVGF 原论文](https://research.nvidia.com/sites/default/files/pubs/2017-07_Spatiotemporal-Variance-Guided-Filtering%3A/svgf_preprint.pdf)提供了首轮小尺度滤波反馈和方差引导的依据;本实现只反馈首轮随机光照,不循环累积最终大范围模糊。这里实现的是自己的有限积分与过滤代码,没有将论文思路等同于已集成这些产品。 [Keen 的 VRAGE3 介绍](https://www.keenswh.com/VRAGE/)公开了动态体素、多材质地形、PBR、光追和动态全局光照方向。本版据此补充可更新的真实体素几何和材质;Keen 并未在该页面公开完整实现,仓库不包含 SE2/VRAGE3 的引擎代码。 VRAGE3 不能作为本插件的可替换 DLL 后端直接装入 SE1。[官方架构说明](https://2.spaceengineersgame.com/space-engineers-2-alpha-revealed/)解释了架构、25 cm 统一网格及文件/数据结构的重大变化,旧网格和存档不能直接移植。完整迁移需要可用的引擎开发授权、底层接口及游戏逻辑、物理、资产和存档转换工程;目前没有在本项目中完成或承诺这种迁移。官网的公开源码链接位于 VRAGE1 章节,不是 VRAGE3 源码。 目前仍有以下限制: - 只处理近场刚性模型和有限范围体素。未处理蒙皮装甲、alpha cutout、完整行星远景几何、形变运动及次级法线贴图。未找到渲染 actor 的对象仍使用捕获姿态;快速移入范围的新几何在发现完成前可能保留原生着色。体素采样 LOD 和原版地形 LOD 可能有差别。 - 玻璃是薄板模型;IOR 1.52、厚度 10 mm 是明确的默认假设,不是引擎提供的物理参数。没有封闭介质体积、焦散或完整双面材质模型。主视图折射需要有效的屏幕内背景命中,失配时保留原版背景;次级路径使用几何折射。原版透明着色仍保留,不能称为完整替换。 - 混合模式的接触阴影是对已有光照的近似混合,环境反射在未命中时保留原版;该模式的次级光照保留小幅近似环境项。路径模式读取实际 HDR 环境并做重要性采样,但引擎探针分辨率、局部遮挡与更新都有边界,两种模式都不是物理校准的全场景参考积分器。灯具候选上限 64,尚未覆盖所有粒子、武器、自发光面光源及完整反射器纹理。 - LCD 与静态发光网格能被射线命中,但没有对自发光表面做专门的重要性采样;小文字的间接照明仍可能噪声较大。非 LCD 材质的所有运行时颜色/开关变化、alpha cutout 发光贴花尚未完整覆盖。半分辨率射线及去噪会使玻璃反射中的细小文字偏软,主画面和原屏幕仍为原生分辨率。 - 半精度近场数据、有限样本、短历史和较少反弹仍可能产生噪声、闪烁、细边误差或运动拖影。次级高亮有限幅,不是生产级重建。 - 路径模式没有发光面重要性采样或完整材质模型。没有局部灯的封闭舱内可能比原版环境照明更暗,小面积屏幕的间接照明仍会有噪声。不能将这个有界近场积分器称为 Cyberpunk Overdrive 或 RTXPT 的完整集成。 - 光追增加 CPU/GPU 工作,不解决原有大型舰船模拟瓶颈,不保证 FPS 提升。关闭开关可恢复原版渲染。 ## 验证 GPU 回读测试覆盖不透明遮挡、天空/远景保留、纹理和 GGX 屏幕外反射、时域稳定、缓存回收/压缩、DX11 状态恢复,以及玻璃透光阴影、天空背景的玻璃、主视图折射、双灯玻璃反射方差、体素三向材质、实际点光源和一次/三次反弹的差异。它不能代替游戏画面验收。 第一版数据保留在 [初版实测记录](raytracing-2026-11-17.md);玻璃/体素版的场景、性能和未确认项见 [本版实测记录](raytracing-glass-voxels-2026-11-17.md)。 方差去噪、体素覆盖与 CPU 线程对照见 [后续实测](performance-raytracing-2026-11-17-v3.md)。 驾驶舱内部屏幕、自发光文字和玻璃反射见 [LCD 修复实测](raytracing-emissive-lcd-2026-11-17.md)。 路径积分、原生画质菜单及保存重启验证见 [路径追踪与设置实测](path-tracing-menu-2026-11-17.md)。 不透明光照阶段接入、HDR 环境、稳定实例历史、运动去噪及寰宇号原生 4K 实测见 [运动修复记录](path-tracing-motion-2026-11-17.md)。实例范围筛选造成序号变化时,按稳定标识匹配上一变换,只有新实例拒绝历史,不清空其他表面。 玻璃虚像历史、清玻璃材质绑定、反射文字、原生分辨率合成及渲染 CPU 等待修复见 [后续画质与 CPU 实测](glass-history-cpu-2026-11-17.md)。 镜面横移的旧高光、玻璃光照突变及同一 LCD 纹理内容滞留的复现、修复和持续运动验收见 [残影修复实测](reflection-ghosting-2026-11-18.md)。