D3D12: Implement ISuperResolution using DirectSR

Author: MikhailGorobets

Graphics/Archiver/CMakeLists.txt

@@ -118,7 +118,7 @@ if(D3D11_SUPPORTED)
 endif()
 
 if(D3D12_SUPPORTED)
-    target_link_libraries(Diligent-Archiver-static PRIVATE Diligent-GraphicsEngineD3D12-static)
+    target_link_libraries(Diligent-Archiver-static PRIVATE Diligent-GraphicsEngineD3D12-static DirectSR-Headers)
     target_include_directories(Diligent-Archiver-static PRIVATE ../GraphicsEngineD3D12/include)
 endif()
 

Graphics/GraphicsEngineD3D12/CMakeLists.txt

@@ -2,6 +2,15 @@ cmake_minimum_required (VERSION 3.11)
 
 project(Diligent-GraphicsEngineD3D12 CXX)
 
+include(../../BuildTools/CMake/BuildUtils.cmake)
+
+# Fetch DirectSR headers and Agility SDK DLLs
+FetchContent_DeclareShallowGit(DirectSR-Headers
+    GIT_REPOSITORY https://github.com/MikhailGorobets/DirectSR-Headers.git
+    GIT_TAG        master
+)
+FetchContent_MakeAvailable(DirectSR-Headers)
+
 set(INCLUDE
     include/BottomLevelASD3D12Impl.hpp
     include/BufferD3D12Impl.hpp
@@ -44,6 +53,7 @@ set(INCLUDE
     include/ShaderResourceCacheD3D12.hpp
     include/ShaderResourcesD3D12.hpp
     include/ShaderVariableManagerD3D12.hpp
+    include/SuperResolutionD3D12Impl.hpp
     include/SwapChainD3D12Impl.hpp
     include/TextureD3D12Impl.hpp
     include/TextureViewD3D12Impl.hpp
@@ -108,6 +118,7 @@ set(SRC
     src/ShaderResourceCacheD3D12.cpp
     src/ShaderResourcesD3D12.cpp
     src/ShaderVariableManagerD3D12.cpp
+    src/SuperResolutionD3D12Impl.cpp
     src/SwapChainD3D12Impl.cpp
     src/TextureD3D12Impl.cpp
     src/TextureViewD3D12Impl.cpp
@@ -194,6 +205,7 @@ PRIVATE
     Diligent-GraphicsEngineNextGenBase
     Diligent-TargetPlatform
     Diligent-ShaderTools
+    DirectSR-Headers
     dxgi.lib
     d3dcompiler.lib
 PUBLIC

Graphics/GraphicsEngineD3D12/include/D3D12Loader.hpp

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2019-2022 Diligent Graphics LLC
+ *  Copyright 2019-2026 Diligent Graphics LLC
  *  Copyright 2015-2019 Egor Yusov
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
@@ -29,6 +29,7 @@
 
 #include <d3d12.h>
 
+
 namespace Diligent
 {
 
@@ -48,9 +49,15 @@ using D3D12SerializeRootSignatureProcType = HRESULT(WINAPI*)(
     _Out_ ID3DBlob**                                   ppBlob,
     _Always_(_Outptr_opt_result_maybenull_) ID3DBlob** ppErrorBlob);
 
+using D3D12GetInterfaceProcType = HRESULT(WINAPI*)(
+    _In_ REFCLSID           rclsid,
+    _In_ REFIID             riid,
+    _COM_Outptr_opt_ void** ppvDebug);
+
 extern D3D12CreateDeviceProcType           D3D12CreateDevice;
 extern D3D12GetDebugInterfaceProcType      D3D12GetDebugInterface;
 extern D3D12SerializeRootSignatureProcType D3D12SerializeRootSignature;
+extern D3D12GetInterfaceProcType           D3D12GetInterface;
 
 HMODULE LoadD3D12Dll(const char* DLLPath = "d3d12.dll");
 

Graphics/GraphicsEngineD3D12/include/D3D12TypeConversions.hpp

@@ -114,6 +114,8 @@ D3D12_COMMAND_LIST_TYPE      QueueIdToD3D12CommandListType(HardwareQueueIndex Qu
 COMMAND_QUEUE_TYPE           D3D12CommandListTypeToCmdQueueType(D3D12_COMMAND_LIST_TYPE ListType);
 D3D12_COMMAND_QUEUE_PRIORITY QueuePriorityToD3D12QueuePriority(QUEUE_PRIORITY Priority);
 
+DSR_SUPERRES_CREATE_ENGINE_FLAGS SuperResolutionCreateFlagsToDSRFlags(SUPER_RESOLUTION_CREATE_FLAGS Flags);
+
 static constexpr HardwareQueueIndex D3D12HWQueueIndex_Graphics{Uint8{0}};
 static constexpr HardwareQueueIndex D3D12HWQueueIndex_Compute{Uint8{1}};
 static constexpr HardwareQueueIndex D3D12HWQueueIndex_Copy{Uint8{2}};

Graphics/GraphicsEngineD3D12/include/RenderDeviceD3D12Impl.hpp

@@ -47,6 +47,8 @@
 #include "DXCompiler.hpp"
 #include "RootSignature.hpp"
 
+#include <directsr.h>
+
 
 // The macros below are only defined in Win SDK 19041+ and are missing in 17763
 #ifndef D3D12_RAYTRACING_MAX_RAY_GENERATION_SHADER_THREADS
@@ -223,6 +225,8 @@ class RenderDeviceD3D12Impl final : public RenderDeviceNextGenBase<RenderDeviceD
 
     RootSignatureCacheD3D12& GetRootSignatureCache() { return m_RootSignatureCache; }
 
+    IDSRDevice* GetDSRDevice() const { return m_pDSRDevice; }
+
     DescriptorHeapAllocation AllocateDescriptors(D3D12_DESCRIPTOR_HEAP_TYPE Type, UINT Count = 1);
     DescriptorHeapAllocation AllocateGPUDescriptors(D3D12_DESCRIPTOR_HEAP_TYPE Type, UINT Count = 1);
 
@@ -345,6 +349,8 @@ class RenderDeviceD3D12Impl final : public RenderDeviceNextGenBase<RenderDeviceD
 
     bool m_IsPSOCacheSupported = false;
 
+    CComPtr<IDSRDevice> m_pDSRDevice;
+
 #ifdef DILIGENT_DEVELOPMENT
     Uint32 m_MaxD3D12DeviceVersion = 0;
 #endif

Graphics/GraphicsEngineD3D12/include/SuperResolutionD3D12Impl.hpp

@@ -0,0 +1,70 @@
+/*
+ *  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
+
+/// \file
+/// Declaration of Diligent::SuperResolutionD3D12Impl class
+
+#include "EngineD3D12ImplTraits.hpp"
+#include "DeviceObjectBase.hpp"
+#include "SuperResolution.h"
+
+#include <vector>
+
+
+namespace Diligent
+{
+
+class DeviceContextD3D12Impl;
+
+/// Implementation of the ISuperResolution interface for Direct3D12 backend using DirectSR.
+class SuperResolutionD3D12Impl final : public DeviceObjectBase<ISuperResolution, RenderDeviceD3D12Impl, SuperResolutionDesc>
+{
+public:
+    using TSRUpscalerBase = DeviceObjectBase<ISuperResolution, RenderDeviceD3D12Impl, SuperResolutionDesc>;
+
+    SuperResolutionD3D12Impl(IReferenceCounters*        pRefCounters,
+                             RenderDeviceD3D12Impl*     pDevice,
+                             const SuperResolutionDesc& Desc);
+
+    ~SuperResolutionD3D12Impl();
+
+    IMPLEMENT_QUERY_INTERFACE_IN_PLACE(IID_SuperResolution, TSRUpscalerBase)
+
+    /// Implementation of ISuperResolution::GetOptimalJitterPattern().
+    virtual void DILIGENT_CALL_TYPE GetOptimalJitterPattern(Uint32 Index, float* pJitterX, float* pJitterY) const override final;
+
+    /// Encodes the upscaling operation.
+    void Execute(DeviceContextD3D12Impl& Ctx, const ExecuteSuperResolutionAttribs& Attribs);
+
+private:
+    CComPtr<IDSRSuperResEngine>   m_pDSREngine;
+    CComPtr<IDSRSuperResUpscaler> m_pDSRUpscaler;
+    std::vector<DSR_FLOAT2>       m_JitterPattern;
+};
+
+} // namespace Diligent

Graphics/GraphicsEngineD3D12/include/pch.h

@@ -34,6 +34,7 @@
 #include "WinHPreface.h"
 
 #include <d3d12.h>
+#include <directsr.h>
 #include <atlbase.h>
 
 #if USE_D3D12_LOADER

Graphics/GraphicsEngineD3D12/src/D3D12Loader.cpp

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2019-2025 Diligent Graphics LLC
+ *  Copyright 2019-2026 Diligent Graphics LLC
  *  Copyright 2015-2019 Egor Yusov
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
@@ -33,52 +33,48 @@
 #include <Windows.h>
 #include "WinHPostface.h"
 
+extern "C" const GUID CLSID_D3D12DSRDeviceFactory = {0xbb6dd27e, 0x94a9, 0x41a6, {0x9f, 0x1b, 0x13, 0x37, 0x72, 0x17, 0x24, 0x28}};
+
 namespace Diligent
 {
 
 D3D12CreateDeviceProcType           D3D12CreateDevice;
 D3D12GetDebugInterfaceProcType      D3D12GetDebugInterface;
 D3D12SerializeRootSignatureProcType D3D12SerializeRootSignature;
+D3D12GetInterfaceProcType           D3D12GetInterface;
+
+#if PLATFORM_WIN32
+#    define LOAD_D3D12_ENTRY_POINT(hModule, Func) \
+        Func = reinterpret_cast<Func##ProcType>(GetProcAddress(hModule, #Func))
+#elif PLATFORM_UNIVERSAL_WINDOWS
+#    define LOAD_D3D12_ENTRY_POINT(hModule, Func) Func = ::Func
+#else
+#    error Unexpected platform
+#endif
 
 HMODULE LoadD3D12Dll(const char* DLLPath)
 {
 #if PLATFORM_WIN32
     HMODULE hModule = LoadLibraryA(DLLPath);
-
     if (hModule == NULL)
-    {
         return NULL;
-    }
-
-    bool bAllEntriesLoaded = true;
-#    define LOAD_D3D12_ENTRY_POINT(Func)                                                             \
-        do                                                                                           \
-        {                                                                                            \
-            Func = (Func##ProcType)GetProcAddress(hModule, #Func);                                   \
-            if (Func == NULL)                                                                        \
-            {                                                                                        \
-                bAllEntriesLoaded = false;                                                           \
-                LOG_ERROR_MESSAGE("Failed to loader '" #Func "' function from '", DLLPath, "' dll"); \
-            }                                                                                        \
-        } while (false)
-#elif PLATFORM_UNIVERSAL_WINDOWS
-    HMODULE hModule = (HMODULE)-1;
-#    define LOAD_D3D12_ENTRY_POINT(Func) Func = ::Func
 #else
-#    error Unexpected platform
+    HMODULE hModule = (HMODULE)-1;
 #endif
 
-    LOAD_D3D12_ENTRY_POINT(D3D12CreateDevice);
-    LOAD_D3D12_ENTRY_POINT(D3D12GetDebugInterface);
-    LOAD_D3D12_ENTRY_POINT(D3D12SerializeRootSignature);
-#undef LOAD_D3D12_ENTRY_POINT
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12CreateDevice);
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12GetDebugInterface);
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12SerializeRootSignature);
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12GetInterface);
 
 #if PLATFORM_WIN32
-    if (!bAllEntriesLoaded)
+    if (!D3D12CreateDevice || !D3D12GetDebugInterface || !D3D12SerializeRootSignature || !D3D12GetInterface)
     {
+        LOG_ERROR_MESSAGE("Failed to load one or more entry points from '", DLLPath, "' dll");
         FreeLibrary(hModule);
         return NULL;
     }
+    // D3D12GetInterface is optional (available in newer SDK versions)
 #endif
 
     return hModule;

Graphics/GraphicsEngineD3D12/src/D3D12TypeConversions.cpp

@@ -1019,4 +1019,16 @@ D3D12_SHADING_RATE_COMBINER ShadingRateCombinerToD3D12ShadingRateCombiner(SHADIN
 #endif
 }
 
+DSR_SUPERRES_CREATE_ENGINE_FLAGS SuperResolutionCreateFlagsToDSRFlags(SUPER_RESOLUTION_CREATE_FLAGS Flags)
+{
+    DSR_SUPERRES_CREATE_ENGINE_FLAGS DSRFlags = DSR_SUPERRES_CREATE_ENGINE_FLAG_NONE;
+
+    if (Flags & SUPER_RESOLUTION_CREATE_FLAG_AUTO_EXPOSURE)
+        DSRFlags |= DSR_SUPERRES_CREATE_ENGINE_FLAG_AUTO_EXPOSURE;
+    if (Flags & SUPER_RESOLUTION_CREATE_FLAG_ENABLE_SHARPENING)
+        DSRFlags |= DSR_SUPERRES_CREATE_ENGINE_FLAG_ENABLE_SHARPENING;
+
+    return DSRFlags;
+}
+
 } // namespace Diligent

Graphics/GraphicsEngineD3D12/src/DeviceContextD3D12Impl.cpp

@@ -48,6 +48,7 @@
 #include "d3dx12_win.h"
 #include "D3D12DynamicHeap.hpp"
 #include "QueryManagerD3D12.hpp"
+#include "SuperResolutionD3D12Impl.hpp"
 #include "DXGITypeConversions.hpp"
 
 #include "D3D12TileMappingHelper.hpp"
@@ -3351,7 +3352,22 @@ void DeviceContextD3D12Impl::BindSparseResourceMemory(const BindSparseResourceMe
 void DeviceContextD3D12Impl::ExecuteSuperResolution(const ExecuteSuperResolutionAttribs& Attribs,
                                                     ISuperResolution*                    pUpscaler)
 {
-    UNSUPPORTED("ExecuteSuperResolution is not supported in DirectX 12");
+    DEV_CHECK_ERR(pUpscaler != nullptr, "pUpscaler must not be null");
+
+    auto* pUpscalerD3D12 = ClassPtrCast<SuperResolutionD3D12Impl>(pUpscaler);
+
+    // DirectSR submits its own command list(s) to the command queue
+    // (see IDSRSuperResUpscaler::Execute documentation).
+    // We must flush the current command list first so that all rendering
+    // work producing the input resources (color, depth, motion vectors)
+    // is submitted to the GPU before DirectSR reads them.
+
+    TransitionOrVerifyTextureState(GetCmdContext(), *ClassPtrCast<TextureD3D12Impl>(Attribs.pOutputTextureRTV->GetTexture()), RESOURCE_STATE_TRANSITION_MODE_TRANSITION, RESOURCE_STATE_UNORDERED_ACCESS, "OutputTexture before DirectSR");
+    Flush();
+
+    pUpscalerD3D12->Execute(*this, Attribs);
+
+    TransitionOrVerifyTextureState(GetCmdContext(), *ClassPtrCast<TextureD3D12Impl>(Attribs.pOutputTextureRTV->GetTexture()), RESOURCE_STATE_TRANSITION_MODE_TRANSITION, RESOURCE_STATE_SHADER_RESOURCE, "OutputTexture after DirectSR");
 }
 
 } // namespace Diligent