D3D12: Implement ISuperResolution using DirectSR

Author: MikhailGorobets

Graphics/GraphicsEngine/interface/GraphicsTypes.h

@@ -3335,10 +3335,28 @@ DILIGENT_TYPED_ENUM(SUPER_RESOLUTION_TEMPORAL_CAP_FLAGS, Uint32)
 DEFINE_FLAG_ENUM_OPERATORS(SUPER_RESOLUTION_TEMPORAL_CAP_FLAGS)
 
 
+/// Super resolution creation flags.
+DILIGENT_TYPED_ENUM(SUPER_RESOLUTION_CREATE_FLAGS, Uint32)
+{
+    SUPER_RESOLUTION_CREATE_FLAG_NONE = 0u,
+
+    /// When set, the upscaler automatically calculates exposure for each frame.
+    /// The exposure texture in ExecuteSuperResolutionAttribs is ignored.
+    SUPER_RESOLUTION_CREATE_FLAG_AUTO_EXPOSURE = 1u << 0,
+
+    /// When set, enables the sharpening pass in the upscaler.
+    /// The Sharpness field in ExecuteSuperResolutionAttribs controls the amount.
+    SUPER_RESOLUTION_CREATE_FLAG_ENABLE_SHARPENING = 1u << 1,
+
+    SUPER_RESOLUTION_CREATE_FLAG_LAST = SUPER_RESOLUTION_CREATE_FLAG_ENABLE_SHARPENING
+};
+DEFINE_FLAG_ENUM_OPERATORS(SUPER_RESOLUTION_CREATE_FLAGS)
+
+
 /// Information about a supported super resolution upscaler variant
 struct SuperResolutionInfo
 {
-    /// Human-readable name of the upscaler variant (e.g. "MetalFX Spatial", "MetalFX Temporal").
+    /// Human-readable name of the upscaler variant (e.g. "DLSS", "FSR", "MetalFX Spatial", "MetalFX Temporal").
     Char Name[128] DEFAULT_INITIALIZER({});
 
     /// Unique identifier for this upscaler variant.

Graphics/GraphicsEngine/interface/SuperResolution.h

@@ -89,10 +89,14 @@ struct SuperResolutionDesc DILIGENT_DERIVE(DeviceObjectAttribs)
     /// Unlike the reactive mask which provides proportional control, this is a binary decision.
     TEXTURE_FORMAT IgnoreHistoryMaskFormat DEFAULT_INITIALIZER(TEX_FORMAT_UNKNOWN);
 
-    /// When True, the upscaler automatically calculates exposure for each frame.
-    /// When auto exposure is enabled, the exposure texture in
-    /// ExecuteSuperResolutionAttribs is ignored.
-    Bool AutoExposureEnabled      DEFAULT_INITIALIZER(True);
+    /// Exposure scale texture format.
+    /// Optional. When auto-exposure is disabled, specifies the format of the 1x1 exposure
+    /// texture provided in ExecuteSuperResolutionAttribs::pExposureTextureSRV.
+    TEXTURE_FORMAT ExposureFormat DEFAULT_INITIALIZER(TEX_FORMAT_UNKNOWN);
+
+    /// Engine creation flags controlling the super resolution upscaler behavior.
+    /// See SUPER_RESOLUTION_CREATE_FLAGS.
+    SUPER_RESOLUTION_CREATE_FLAGS Flags DEFAULT_INITIALIZER(SUPER_RESOLUTION_CREATE_FLAG_NONE);
 };
 typedef struct SuperResolutionDesc SuperResolutionDesc;
 
@@ -112,6 +116,16 @@ struct SuperResolutionSourceSettingsAttribs
     /// Target (output) texture height. Must be greater than zero.
     Uint32 OutputHeight    DEFAULT_INITIALIZER(0);
 
+    /// Output texture format.
+    /// Some backends (e.g. DirectSR) may return different optimal input resolutions
+    /// depending on the output format. When set to TEX_FORMAT_UNKNOWN, the backend will use a reasonable default.
+    TEXTURE_FORMAT OutputFormat DEFAULT_INITIALIZER(TEX_FORMAT_UNKNOWN);
+
+    /// Engine creation flags controlling the super resolution upscaler behavior.
+    /// These flags affect the optimal source resolution returned by the backend.
+    /// Must match the flags that will be used when creating the upscaler.
+    SUPER_RESOLUTION_CREATE_FLAGS Flags DEFAULT_INITIALIZER(SUPER_RESOLUTION_CREATE_FLAG_NONE);
+
     /// Optimization type controlling the quality/performance trade-off.
     SUPER_RESOLUTION_OPTIMIZATION_TYPE OptimizationType DEFAULT_INITIALIZER(SUPER_RESOLUTION_OPTIMIZATION_TYPE_BALANCED);
 };
@@ -155,7 +169,7 @@ struct ExecuteSuperResolutionAttribs
     /// Exposure texture (shader resource view).
     /// Optional. A 1x1 R16_FLOAT texture containing the exposure value.
     /// The upscaler reads the R channel and uses it to multiply the input color.
-    /// Ignored when SuperResolutionDesc::AutoExposureEnabled is True.
+    /// Ignored when SuperResolutionDesc::Flags includes SUPER_RESOLUTION_CREATE_FLAG_AUTO_EXPOSURE.
     ITextureView* pExposureTextureSRV   DEFAULT_INITIALIZER(nullptr);
 
     /// Reactive mask texture (shader resource view).

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

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