D3D12: Implement ISuperResolution using DirectSR

MikhailGorobets · MikhailGorobets · commit 87d3fbdcb5b6 · 2026-03-05T14:26:37.000+06:00
diff --git a/Graphics/GraphicsEngineD3D12/CMakeLists.txt b/Graphics/GraphicsEngineD3D12/CMakeLists.txt
@@ -44,6 +44,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 +109,7 @@ set(SRC
     src/ShaderResourceCacheD3D12.cpp
     src/ShaderResourcesD3D12.cpp
     src/ShaderVariableManagerD3D12.cpp
+    src/SuperResolutionD3D12Impl.cpp
     src/SwapChainD3D12Impl.cpp
     src/TextureD3D12Impl.cpp
     src/TextureViewD3D12Impl.cpp
diff --git a/Graphics/GraphicsEngineD3D12/include/D3D12Loader.hpp b/Graphics/GraphicsEngineD3D12/include/D3D12Loader.hpp
@@ -28,6 +28,7 @@
 #pragma once
 
 #include <d3d12.h>
+#include <directsr.h>
 
 namespace Diligent
 {
@@ -48,10 +49,16 @@ using D3D12SerializeRootSignatureProcType = HRESULT(WINAPI*)(
     _Out_ ID3DBlob**                                   ppBlob,
     _Always_(_Outptr_opt_result_maybenull_) ID3DBlob** ppErrorBlob);
 
+using DSRCreateDeviceFactoryProcType = HRESULT(WINAPI*)(
+    _In_ REFIID             riid,
+    _COM_Outptr_opt_ void** ppvFactory);
+
 extern D3D12CreateDeviceProcType           D3D12CreateDevice;
 extern D3D12GetDebugInterfaceProcType      D3D12GetDebugInterface;
 extern D3D12SerializeRootSignatureProcType D3D12SerializeRootSignature;
+extern DSRCreateDeviceFactoryProcType      DSRCreateDeviceFactory;
 
 HMODULE LoadD3D12Dll(const char* DLLPath = "d3d12.dll");
+HMODULE LoadDirectSRDll(const char* DLLPath = "DirectSR.dll");
 
 } // namespace Diligent
diff --git a/Graphics/GraphicsEngineD3D12/include/RenderDeviceD3D12Impl.hpp b/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
diff --git a/Graphics/GraphicsEngineD3D12/include/SuperResolutionD3D12Impl.hpp b/Graphics/GraphicsEngineD3D12/include/SuperResolutionD3D12Impl.hpp
@@ -0,0 +1,68 @@
+/*
+ *  Copyright 2019-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 <directsr.h>
+
+namespace Diligent
+{
+
+/// 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 into the given command list.
+    void Execute(ID3D12GraphicsCommandList* pd3d12CmdList,
+                 const ExecuteSuperResolutionAttribs& Attribs);
+
+private:
+    CComPtr<IDSRSuperResEngine> m_pDSREngine;
+};
+
+} // namespace Diligent
diff --git a/Graphics/GraphicsEngineD3D12/src/D3D12Loader.cpp b/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");
@@ -39,43 +39,59 @@ namespace Diligent
 D3D12CreateDeviceProcType           D3D12CreateDevice;
 D3D12GetDebugInterfaceProcType      D3D12GetDebugInterface;
 D3D12SerializeRootSignatureProcType D3D12SerializeRootSignature;
+DSRCreateDeviceFactoryProcType      DSRCreateDeviceFactory;
+
+#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;
+#else
+    HMODULE hModule = (HMODULE)-1;
+#endif
+
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12CreateDevice);
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12GetDebugInterface);
+    LOAD_D3D12_ENTRY_POINT(hModule, D3D12SerializeRootSignature);
+
+#if PLATFORM_WIN32
+    if (!D3D12CreateDevice || !D3D12GetDebugInterface || !D3D12SerializeRootSignature)
     {
+        LOG_ERROR_MESSAGE("Failed to load one or more entry points from '", DLLPath, "' dll");
+        FreeLibrary(hModule);
         return NULL;
     }
+#endif
 
-    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
+    return hModule;
+}
+
+HMODULE LoadDirectSRDll(const char* DLLPath)
+{
+#if PLATFORM_WIN32
+    HMODULE hModule = LoadLibraryA(DLLPath);
+    if (hModule == NULL)
+        return NULL;
 #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, DSRCreateDeviceFactory);
 
 #if PLATFORM_WIN32
-    if (!bAllEntriesLoaded)
+    if (!DSRCreateDeviceFactory)
     {
+        LOG_ERROR_MESSAGE("Failed to load 'DSRCreateDeviceFactory' function from '", DLLPath, "' dll");
         FreeLibrary(hModule);
         return NULL;
     }
diff --git a/Graphics/GraphicsEngineD3D12/src/DeviceContextD3D12Impl.cpp b/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,15 @@ 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);
+
+    auto& CmdCtx = GetCmdContext();
+    CmdCtx.FlushResourceBarriers();
+
+    auto* pd3d12CmdList = CmdCtx.GetCommandList();
+    pUpscalerD3D12->Execute(pd3d12CmdList, Attribs);
 }
 
 } // namespace Diligent
diff --git a/Graphics/GraphicsEngineD3D12/src/EngineFactoryD3D12.cpp b/Graphics/GraphicsEngineD3D12/src/EngineFactoryD3D12.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");
@@ -165,7 +165,8 @@ class EngineFactoryD3D12Impl : public EngineFactoryD3DBase<IEngineFactoryD3D12,
 
 private:
 #if USE_D3D12_LOADER
-    HMODULE     m_hD3D12Dll = NULL;
+    HMODULE     m_hD3D12Dll    = NULL;
+    HMODULE     m_hDirectSRDll = NULL;
     std::string m_DllName;
 #endif
 };
@@ -193,6 +194,15 @@ bool EngineFactoryD3D12Impl::LoadD3D12(const char* DllName)
             }
         }
     }
+
+    if (m_hDirectSRDll == NULL)
+    {
+        m_hDirectSRDll = LoadDirectSRDll();
+        if (m_hDirectSRDll == NULL)
+        {
+            LOG_INFO_MESSAGE("DirectSR.dll is not available. DirectSR super resolution will be disabled.");
+        }
+    }
 #endif
 
     return true;
@@ -1106,6 +1116,73 @@ GraphicsAdapterInfo EngineFactoryD3D12Impl::GetGraphicsAdapterInfo(void*
         ASSERT_SIZEOF(DrawCommandProps, 12, "Did you add a new member to DrawCommandProperties? Please initialize it here.");
     }
 
+    // Super resolution properties (DirectSR)
+    if (DSRCreateDeviceFactory != nullptr)
+    {
+        CComPtr<IDSRDeviceFactory> pDSRFactory;
+        HRESULT hr = DSRCreateDeviceFactory(IID_PPV_ARGS(&pDSRFactory));
+        if (SUCCEEDED(hr) && pDSRFactory)
+        {
+            CComPtr<IDSRDevice> pDSRDevice;
+            hr = pDSRFactory->CreateDSRDevice(d3d12Device, 0, IID_PPV_ARGS(&pDSRDevice));
+            if (SUCCEEDED(hr) && pDSRDevice)
+            {
+                const UINT NumVariants = pDSRDevice->GetNumSuperResVariants();
+                if (NumVariants > 0)
+                {
+                    Features.SuperResolution = DEVICE_FEATURE_STATE_ENABLED;
+
+                    SuperResolutionProperties& SRProps{AdapterInfo.SuperResolution};
+                    SRProps.NumUpscalers = 0;
+
+                    for (UINT i = 0; i < NumVariants && SRProps.NumUpscalers < DILIGENT_MAX_SUPER_RESOLUTION_UPSCALERS; ++i)
+                    {
+                        DSR_SUPERRES_VARIANT_DESC VariantDesc = {};
+                        hr = pDSRDevice->GetSuperResVariantInfo(i, &VariantDesc);
+                        if (FAILED(hr))
+                            continue;
+
+                        SuperResolutionInfo& Info = SRProps.Upscalers[SRProps.NumUpscalers];
+
+                        // Convert wide string name to narrow string
+                        WideCharToMultiByte(CP_UTF8, 0, VariantDesc.FriendlyName, -1, Info.Name, sizeof(Info.Name) - 1, nullptr, nullptr);
+                        Info.Name[sizeof(Info.Name) - 1] = '\0';
+
+                        // Map variant GUID to VariantId
+                        static_assert(sizeof(Info.VariantId) == sizeof(VariantDesc.VariantId), "GUID/INTERFACE_ID size mismatch");
+                        memcpy(&Info.VariantId, &VariantDesc.VariantId, sizeof(Info.VariantId));
+
+                        // Determine upscaler type and capabilities from DirectSR flags
+                        if (VariantDesc.Flags & DSR_SUPERRES_VARIANT_FLAG_SUPPORTS_TEMPORAL_UPSCALING)
+                        {
+                            Info.Type = SUPER_RESOLUTION_UPSCALER_TYPE_TEMPORAL;
+
+                            SUPER_RESOLUTION_TEMPORAL_CAP_FLAGS TemporalCaps = SUPER_RESOLUTION_TEMPORAL_CAP_FLAG_NATIVE;
+
+                            if (VariantDesc.Flags & DSR_SUPERRES_VARIANT_FLAG_SUPPORTS_EXPOSURE_SCALE_TEXTURE)
+                                TemporalCaps |= SUPER_RESOLUTION_TEMPORAL_CAP_FLAG_EXPOSURE_SCALE_TEXTURE;
+                            if (VariantDesc.Flags & DSR_SUPERRES_VARIANT_FLAG_SUPPORTS_IGNORE_HISTORY_MASK)
+                                TemporalCaps |= SUPER_RESOLUTION_TEMPORAL_CAP_FLAG_IGNORE_HISTORY_MASK;
+                            if (VariantDesc.Flags & DSR_SUPERRES_VARIANT_FLAG_SUPPORTS_REACTIVE_MASK)
+                                TemporalCaps |= SUPER_RESOLUTION_TEMPORAL_CAP_FLAG_REACTIVE_MASK;
+                            if (VariantDesc.Flags & DSR_SUPERRES_VARIANT_FLAG_SUPPORTS_SHARPNESS)
+                                TemporalCaps |= SUPER_RESOLUTION_TEMPORAL_CAP_FLAG_SHARPNESS;
+
+                            Info.TemporalCapFlags = TemporalCaps;
+                        }
+                        else
+                        {
+                            Info.Type           = SUPER_RESOLUTION_UPSCALER_TYPE_SPATIAL;
+                            Info.SpatialCapFlags = SUPER_RESOLUTION_SPATIAL_CAP_FLAG_NATIVE;
+                        }
+
+                        SRProps.NumUpscalers++;
+                    }
+                }
+            }
+        }
+    }
+
     ASSERT_SIZEOF(DeviceFeatures, 48, "Did you add a new feature to DeviceFeatures? Please handle its status here.");
 
     return AdapterInfo;
diff --git a/Graphics/GraphicsEngineD3D12/src/RenderDeviceD3D12Impl.cpp b/Graphics/GraphicsEngineD3D12/src/RenderDeviceD3D12Impl.cpp
diff --git a/Graphics/GraphicsEngineD3D12/src/SuperResolutionD3D12Impl.cpp b/Graphics/GraphicsEngineD3D12/src/SuperResolutionD3D12Impl.cpp
