DLSS

NVIDIA RTX DLSS SDK 的公开仓库。 DLSS 示例应用程序仅包含在发布版本中。

NVIDIA 图像缩放 SDK

NVIDIA 图像缩放 SDK 提供了一种跨平台支持的空间缩放和锐化算法。它包含可与 DirectX 11、DirectX 12 和 Vulkan 集成的计算着色器。更多信息请访问 https://github.com/NVIDIAGameWorks/NVIDIAImageScaling。

要获取 NVIDIA 图像缩放 SDK 子模块，请使用以下命令：

$ git clone --recurse-submodules https://github.com/NVIDIA/DLSS.git

或者，如果您已经克隆了 DLSS 仓库但未使用 --recurse-submodules 参数：

git submodule update --init --recursive

NVIDIA DLSS SDK 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows 10/11 (64-bit) 或 Linux。
• 显卡硬件：NVIDIA GeForce RTX 系列显卡（支持 DLSS 功能）。
• 图形 API：DirectX 11, DirectX 12 或 Vulkan。
• 开发工具：
  • Git（用于代码克隆）。
  • 支持上述图形 API 的编译器（如 Visual Studio 2019/2022 或 GCC/Clang）。
  • NVIDIA Image Scaling (NIS) SDK 作为子模块包含在内，无需单独下载。

注意：DLSS 示例应用程序（Sample App）仅包含在官方发布的 Release 包中，源码仓库主要提供 SDK 集成所需的核心文件。

安装步骤

推荐使用以下命令克隆仓库并自动初始化子模块（包含 NVIDIA Image Scaling SDK）。

方式一：全新克隆（推荐）

使用 --recurse-submodules 参数一次性完成克隆和子模块初始化：

git clone --recurse-submodules https://github.com/NVIDIA/DLSS.git

国内加速建议：如果直接连接 GitHub 速度较慢，可使用国内镜像源（如 Gitee 镜像，若有）或配置 Git 代理。若使用标准 GitHub 地址受阻，可尝试：

git clone --recurse-submodules https://gitee.com/mirror/NVIDIA-DLSS.git

(注：请根据实际可用的最新镜像地址替换上述 URL)

方式二：已有仓库补充子模块

如果您已经克隆了仓库但未加载子模块，请在项目根目录下执行：

git submodule update --init --recursive

基本使用

DLSS SDK 主要通过集成 Compute Shaders 到您的渲染管线中使用。以下是集成的核心逻辑简述：

1. 引入头文件：在您的 C++ 项目中包含 DLSS SDK 提供的头文件。
2. 初始化：创建 DX11、DX12 或 Vulkan 设备上下文，并调用 SDK 初始化函数。
3. 着色器集成：将提供的 Compute Shaders 编译并链接到您的图形管线中。

简易集成示例（伪代码逻辑）：

// 1. 包含 SDK 头文件
#include "nvdlss.h" 

// 2. 初始化描述符 (以 DX12 为例)
NV_DLSS_Descriptor desc = {};
desc.device = pDevice; // 您的 ID3D12Device 指针
desc.width = renderWidth;
desc.height = renderHeight;
desc.outputWidth = targetWidth;
desc.outputHeight = targetHeight;

// 3. 创建实例
NV_DLSS_Handle handle;
NV_DLSS_Create(&desc, &handle);

// 4. 在渲染循环中执行缩放与锐化
// 绑定对应的 Compute Shader 并分发线程组
// NV_DLSS_Dispatch(handle, commandList, ...);

对于 NVIDIA Image Scaling (NIS) 的具体实现细节和完整 Shader 代码，请参考克隆后目录中的 NVIDIAImageScaling 子模块内容，或访问官方文档：https://github.com/NVIDIAGameWorks/NVIDIAImageScaling。