RayTracedGL1 项目常见问题解决方案

RayTracedGL1 项目常见问题解决方案

RayTracedGL1 项目地址: https://gitcode.com/gh_mirrors/ra/RayTracedGL1

1. 项目基础介绍和主要编程语言

RayTracedGL1 是一个开源项目，旨在简化3D应用程序向实时路径追踪的移植过程。它通过硬件加速的光线追踪、去噪算法（A-SVGF）和采样算法（ReSTIR GI）来提高图像质量，同时重用时空数据。该项目的主要编程语言是 C++，并且使用了 Vulkan SDK 进行图形渲染。

2. 新手常见问题及解决步骤

问题一：如何配置和构建项目？

问题描述： 新手在使用 RayTracedGL1 时，不知道如何正确配置和构建项目。

解决步骤：

1. 确保你的开发环境已安装以下依赖项：

   • 64位CPU
   • 支持光线追踪的GPU
   • Git
   • CMake
   • Vulkan SDK
   • Python 3（用于构建着色器）

2. 克隆仓库：

   git clone https://github.com/sultim-t/RayTracedGL1.git
   

3. 使用 CMake 配置项目。如果你使用的是 Windows 和 Visual Studio，可以直接打开文件夹作为 CMake 项目。否则，需要在 CMake 中指定窗口系统，通过启用一些 CMake 选项来构建库，例如：

   mkdir Build
   cd Build
   cmake
   

4. 构建项目：

   cmake --build
   

问题二：如何解决启动时缺少蓝色噪声图像的问题？

问题描述： 项目启动时提示缺少蓝色噪声图像。

解决步骤：

1. 在项目目录中找到 Tools/BlueNoise_LDR_RGBA_128.ktx2 文件。

2. 将该文件路径传递给 RgInstanceCreateInfo::pBlueNoiseFilePath。

问题三：如何进行着色器热重载？

问题描述： 新手不知道如何在运行时进行着色器热重载。

解决步骤：

1. 设置 RgStartFrameInfo::requestShaderReload=true 以请求在运行时重载着色器。

2. 为了简化着色器的构建过程，可以安装 Visual Studio Code 和 Script Runner 扩展。

3. 打开 Sources/Shaders 文件夹，在 VS Code 的 settings.json 文件中添加以下配置：

   "script-runner-definitions": [
     {
       "commands": [
         {
           "identifier": "shaderBuild",
           "description": "Build shaders",
           "command": "cls python GenerateShaders.py -ps",
           "working_directory": "${workspaceFolder}"
         },
         {
           "identifier": "shaderGenAndBuild",
           "description": "Build shaders with generating common files",
           "command": "cls python GenerateShaders.py -ps -g",
           "working_directory": "${workspaceFolder}"
         }
       ]
     }
   ]
   

4. 在 VS Code 中为 shaderBuild 和 shaderGenAndBuild 命令分配快捷键。

通过以上步骤，新手可以更顺利地开始使用 RayTracedGL1 项目，并解决在配置和使用过程中可能遇到的问题。

RayTracedGL1 项目地址: https://gitcode.com/gh_mirrors/ra/RayTracedGL1