Add super-resolution support: DLSS (D3D11/D3D12/Vulkan), DirectSR (D3D12), MetalFX (Metal)

Author: MikhailGorobets

.github/workflows/msvc_analysis.yml

@@ -11,7 +11,7 @@ jobs:
             platform:        "Win32"
             toolset:         "x64"
             build_type:      "Debug"
-            cmake_args:      "-DDILIGENT_NO_GLSLANG=ON -DDILIGENT_NO_HLSL=ON"
+            cmake_args:      "-DDILIGENT_NO_GLSLANG=ON -DDILIGENT_NO_HLSL=ON -DDILIGENT_NO_DLSS=ON -DDILIGENT_NO_DSR=ON"
             cmake_generator: "Visual Studio 17 2022"
 
     runs-on: windows-2022

Graphics/SuperResolution/CMakeLists.txt

@@ -4,9 +4,50 @@ include(../../BuildTools/CMake/BuildUtils.cmake)
 
 project(Diligent-SuperResolution CXX)
 
+set(DILIGENT_DLSS_SUPPORTED FALSE CACHE INTERNAL "DLSS is not supported")
+set(DILIGENT_DSR_SUPPORTED  FALSE CACHE INTERNAL "DirectSR is not supported")
+
+if(PLATFORM_WIN32)
+    set(DILIGENT_DLSS_SUPPORTED TRUE CACHE INTERNAL "DLSS is supported on Win32 platform")
+    set(DILIGENT_DSR_SUPPORTED  TRUE CACHE INTERNAL "DirectSR is supported on Win32 platform")
+endif()
+
+if(${DILIGENT_NO_DLSS})
+    set(DILIGENT_DLSS_SUPPORTED FALSE CACHE INTERNAL "DLSS is forcibly disabled")
+endif()
+if(${DILIGENT_NO_DSR})
+    set(DILIGENT_DSR_SUPPORTED FALSE CACHE INTERNAL "DirectSR is forcibly disabled")
+endif()
+
+if(DILIGENT_DSR_SUPPORTED)
+    # Fetch DirectSR headers
+    FetchContent_DeclareShallowGit(DirectSR-Headers
+        GIT_REPOSITORY https://github.com/MikhailGorobets/DirectSR-Headers.git
+        GIT_TAG        master
+    )
+    FetchContent_MakeAvailable(DirectSR-Headers)
+    if(TARGET DirectSR-AgilitySDK)
+        set_target_properties(DirectSR-AgilitySDK PROPERTIES FOLDER DiligentCore/ThirdParty)
+    endif()
+endif()
+
+if(DILIGENT_DLSS_SUPPORTED)
+    # Fetch NVIDIA DLSS SDK headers
+    FetchContent_DeclareShallowGit(DLSS-Headers
+        GIT_REPOSITORY https://github.com/NVIDIA/DLSS.git
+        GIT_TAG        main
+    )
+    FetchContent_MakeAvailable(DLSS-Headers)
+endif()
+
 set(INCLUDE
     include/SuperResolutionBase.hpp
     include/SuperResolutionFactoryBase.hpp
+    include/SuperResolutionVariants.hpp
+    include/DLSSProviderD3D12.hpp
+    include/DLSSProviderD3D11.hpp
+    include/DLSSProviderVk.hpp
+    include/DSRProviderD3D12.hpp
 )
 
 set(INTERFACE
@@ -16,15 +57,22 @@ set(INTERFACE
 )
 
 set(SOURCE
+    src/SuperResolutionBase.cpp
     src/SuperResolutionFactoryBase.cpp
+    src/SuperResolutionFactory.cpp
+    src/SuperResolutionFactoryD3D12.cpp
+    src/SuperResolutionFactoryD3D11.cpp
+    src/SuperResolutionFactoryVk.cpp
+    src/SuperResolutionFactoryMtl.cpp
+    src/DLSSProviderD3D12.cpp
+    src/DLSSProviderD3D11.cpp
+    src/DLSSProviderVk.cpp
+    src/DSRProviderD3D12.cpp
 )
 
-if(D3D12_SUPPORTED)
-    list(APPEND
-    SOURCE
-        src/SuperResolutionD3D12.cpp
-        src/SuperResolutionFactoryD3D12.cpp
-    )
+if(DILIGENT_DLSS_SUPPORTED)
+    list(APPEND INCLUDE include/SuperResolutionDLSS.hpp)
+    list(APPEND SOURCE src/SuperResolutionDLSS.cpp)
 endif()
 
 set(DLL_SOURCE
@@ -57,6 +105,14 @@ PRIVATE
     ../GraphicsEngineNextGenBase/include
 )
 
+if(DILIGENT_DLSS_SUPPORTED)
+    target_compile_definitions(Diligent-SuperResolution-static PRIVATE DILIGENT_DLSS_SUPPORTED=1)
+endif()
+
+if(DILIGENT_DSR_SUPPORTED)
+    target_compile_definitions(Diligent-SuperResolution-static PRIVATE DILIGENT_DSR_SUPPORTED=1)
+endif()
+
 target_compile_definitions(Diligent-SuperResolution-shared PUBLIC DILIGENT_SUPER_RESOLUTION_SHARED=1)
 
 target_link_libraries(Diligent-SuperResolution-static
@@ -69,11 +125,35 @@ PRIVATE
     Diligent-ShaderTools
 )
 
-if(D3D12_SUPPORTED)
-    target_link_libraries(Diligent-SuperResolution-static PRIVATE Diligent-GraphicsEngineD3D12-static)
+if(DILIGENT_DSR_SUPPORTED)
+    target_link_libraries(Diligent-SuperResolution-static PRIVATE Diligent-GraphicsEngineD3D12-static DirectSR-Headers)
     target_include_directories(Diligent-SuperResolution-static PRIVATE ../GraphicsEngineD3D12/include)
 endif()
 
+if(DILIGENT_DLSS_SUPPORTED)
+    set(DLSS_SDK_DIR ${FETCHCONTENT_BASE_DIR}/dlss-headers-src)
+    target_include_directories(Diligent-SuperResolution-static PRIVATE ${DLSS_SDK_DIR}/include)
+
+    # Link NGX static library (dynamic CRT /MD variant)
+    target_link_libraries(Diligent-SuperResolution-static PRIVATE
+        debug     ${DLSS_SDK_DIR}/lib/Windows_x86_64/x64/nvsdk_ngx_d_dbg.lib
+        optimized ${DLSS_SDK_DIR}/lib/Windows_x86_64/x64/nvsdk_ngx_d.lib
+    )
+
+    if(D3D12_SUPPORTED)
+        target_link_libraries(Diligent-SuperResolution-static PRIVATE Diligent-GraphicsEngineD3D12-static)
+        target_include_directories(Diligent-SuperResolution-static PRIVATE ../GraphicsEngineD3D12/include)
+    endif()
+    if(D3D11_SUPPORTED)
+        target_link_libraries(Diligent-SuperResolution-static PRIVATE Diligent-GraphicsEngineD3D11-static)
+        target_include_directories(Diligent-SuperResolution-static PRIVATE ../GraphicsEngineD3D11/include)
+    endif()
+    if(VULKAN_SUPPORTED)
+        target_link_libraries(Diligent-SuperResolution-static PRIVATE Diligent-GraphicsEngineVk-static Vulkan::Headers)
+        target_include_directories(Diligent-SuperResolution-static PRIVATE ../GraphicsEngineVulkan/include)
+    endif()
+endif()
+
 target_link_libraries(Diligent-SuperResolution-shared
 PUBLIC
     Diligent-SuperResolutionInterface

Graphics/SuperResolution/include/DLSSProviderD3D11.hpp

@@ -0,0 +1,58 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#pragma once
+
+#include "SuperResolutionFactory.h"
+#include "SuperResolution.h"
+#include "RefCntAutoPtr.hpp"
+
+#include <vector>
+
+struct NVSDK_NGX_Parameter;
+
+namespace Diligent
+{
+
+class DLSSProviderD3D11 final
+{
+public:
+    DLSSProviderD3D11(IRenderDevice* pDevice);
+
+    ~DLSSProviderD3D11();
+
+    void EnumerateVariants(std::vector<SuperResolutionInfo>& Variants);
+
+    void GetSourceSettings(const SuperResolutionSourceSettingsAttribs& Attribs, SuperResolutionSourceSettings& Settings);
+
+    void CreateSuperResolution(const SuperResolutionDesc& Desc, ISuperResolution** ppUpscaler);
+
+private:
+    RefCntAutoPtr<IRenderDevice> m_pDevice;
+    NVSDK_NGX_Parameter*         m_pNGXParams = nullptr;
+};
+
+} // namespace Diligent

Graphics/SuperResolution/include/DLSSProviderD3D12.hpp

@@ -0,0 +1,58 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#pragma once
+
+#include "SuperResolutionFactory.h"
+#include "SuperResolution.h"
+#include "RefCntAutoPtr.hpp"
+
+#include <vector>
+
+struct NVSDK_NGX_Parameter;
+
+namespace Diligent
+{
+
+class DLSSProviderD3D12 final
+{
+public:
+    DLSSProviderD3D12(IRenderDevice* pDevice);
+
+    ~DLSSProviderD3D12();
+
+    void EnumerateVariants(std::vector<SuperResolutionInfo>& Variants);
+
+    void GetSourceSettings(const SuperResolutionSourceSettingsAttribs& Attribs, SuperResolutionSourceSettings& Settings);
+
+    void CreateSuperResolution(const SuperResolutionDesc& Desc, ISuperResolution** ppUpscaler);
+
+private:
+    RefCntAutoPtr<IRenderDevice> m_pDevice;
+    NVSDK_NGX_Parameter*         m_pNGXParams = nullptr;
+};
+
+} // namespace Diligent

Graphics/SuperResolution/include/DLSSProviderVk.hpp

@@ -0,0 +1,58 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#pragma once
+
+#include "SuperResolutionFactory.h"
+#include "SuperResolution.h"
+#include "RefCntAutoPtr.hpp"
+
+#include <vector>
+
+struct NVSDK_NGX_Parameter;
+
+namespace Diligent
+{
+
+class DLSSProviderVk final
+{
+public:
+    DLSSProviderVk(IRenderDevice* pDevice);
+
+    ~DLSSProviderVk();
+
+    void EnumerateVariants(std::vector<SuperResolutionInfo>& Variants);
+
+    void GetSourceSettings(const SuperResolutionSourceSettingsAttribs& Attribs, SuperResolutionSourceSettings& Settings);
+
+    void CreateSuperResolution(const SuperResolutionDesc& Desc, ISuperResolution** ppUpscaler);
+
+private:
+    RefCntAutoPtr<IRenderDevice> m_pDevice;
+    NVSDK_NGX_Parameter*         m_pNGXParams = nullptr;
+};
+
+} // namespace Diligent

Graphics/SuperResolution/include/DSRProviderD3D12.hpp

@@ -0,0 +1,60 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#pragma once
+
+#include "SuperResolutionFactory.h"
+#include "SuperResolution.h"
+#include "RefCntAutoPtr.hpp"
+
+#include <vector>
+
+struct IDSRDevice;
+
+namespace Diligent
+{
+
+class DSRProviderD3D12 final
+{
+public:
+    DSRProviderD3D12(IRenderDevice* pDevice);
+
+    ~DSRProviderD3D12();
+
+    void EnumerateVariants(std::vector<SuperResolutionInfo>& Variants);
+
+    void GetSourceSettings(const SuperResolutionSourceSettingsAttribs& Attribs,
+                           SuperResolutionSourceSettings&              Settings);
+
+    void CreateSuperResolution(const SuperResolutionDesc& Desc,
+                               ISuperResolution**         ppUpscaler);
+
+private:
+    RefCntAutoPtr<IRenderDevice> m_pDevice;
+    IDSRDevice*                  m_pDSRDevice = nullptr;
+};
+
+} // namespace Diligent