Implement SuperResolution stubs in D3D11, D3D12, Vulkan, OpenGL, and WebGPU backends

Author: MikhailGorobets

Graphics/GraphicsEngine/include/RenderDeviceBase.hpp

@@ -52,6 +52,7 @@
 #include "IndexWrapper.hpp"
 #include "ThreadPool.hpp"
 #include "SpinLock.hpp"
+#include "SuperResolution.h"
 
 namespace Diligent
 {
@@ -119,6 +120,7 @@ class RenderDeviceBase : public ObjectBase<typename EngineImplTraits::RenderDevi
     using PipelineResourceSignatureImplType = typename EngineImplTraits::PipelineResourceSignatureImplType;
     using DeviceMemoryImplType              = typename EngineImplTraits::DeviceMemoryImplType;
     using PipelineStateCacheImplType        = typename EngineImplTraits::PipelineStateCacheImplType;
+    using SuperResolutionImplType           = typename EngineImplTraits::SuperResolutionImplType;
 
     /// \param pRefCounters    - Reference counters object that controls the lifetime of this render device
     /// \param RawMemAllocator - Allocator that will be used to allocate memory for all device objects (including render device itself)
@@ -638,6 +640,17 @@ class RenderDeviceBase : public ObjectBase<typename EngineImplTraits::RenderDevi
                            });
     }
 
+    template <typename... ExtraArgsType>
+    void CreateSuperResolutionImpl(ISuperResolution** ppUpscaler, const SuperResolutionDesc& Desc, const ExtraArgsType&... ExtraArgs)
+    {
+        CreateDeviceObject("Super Resolution Upscaler", Desc, ppUpscaler,
+                           [&]() //
+                           {
+                               SuperResolutionImplType* pUpscalerImpl = NEW_RC_OBJ(GetRawAllocator(), "SuperResolution instance", SuperResolutionImplType)(static_cast<RenderDeviceImplType*>(this), Desc, ExtraArgs...);
+                               pUpscalerImpl->QueryInterface(IID_SuperResolution, reinterpret_cast<IObject**>(ppUpscaler));
+                           });
+    }
+
     template <typename... ExtraArgsType>
     void CreateDeferredContextImpl(IDeviceContext** ppContext, const ExtraArgsType&... ExtraArgs)
     {

Graphics/GraphicsEngine/src/RenderDeviceBase.cpp

@@ -120,9 +120,10 @@ DeviceFeatures EnableDeviceFeatures(const DeviceFeatures& SupportedFeatures,
     ENABLE_FEATURE(NativeMultiDraw,                   "Native multi-draw commands are");
     ENABLE_FEATURE(AsyncShaderCompilation,            "Async shader compilation is");
     ENABLE_FEATURE(FormattedBuffers,                  "Formatted buffers are");
+    ENABLE_FEATURE(SuperResolution,                   "Super resolution is");
     // clang-format on
 
-    ASSERT_SIZEOF(DeviceFeatures, 47, "Did you add a new feature to DeviceFeatures? Please handle its status here (if necessary).");
+    ASSERT_SIZEOF(DeviceFeatures, 48, "Did you add a new feature to DeviceFeatures? Please handle its status here (if necessary).");
 
     return EnabledFeatures;
 }

Graphics/GraphicsEngineD3D11/include/DeviceContextD3D11Impl.hpp

@@ -284,6 +284,9 @@ class DeviceContextD3D11Impl final : public DeviceContextBase<EngineD3D11ImplTra
                                                    SHADING_RATE_COMBINER PrimitiveCombiner,
                                                    SHADING_RATE_COMBINER TextureCombiner) override final;
 
+    /// Implementation of IDeviceContext::ExecuteSuperResolution() in Direct3D11 backend.
+    virtual void DILIGENT_CALL_TYPE ExecuteSuperResolution(const ExecuteSuperResolutionAttribs& Attribs,
+                                                           ISuperResolution*                    pUpscaler) override final;
     /// Implementation of IDeviceContext::BindSparseResourceMemory() in Direct3D11 backend.
     virtual void DILIGENT_CALL_TYPE BindSparseResourceMemory(const BindSparseResourceMemoryAttribs& Attribs) override final;
 

Graphics/GraphicsEngineD3D11/include/EngineD3D11ImplTraits.hpp

@@ -71,8 +71,8 @@ class TopLevelASD3D11Impl;
 class ShaderBindingTableD3D11Impl;
 class PipelineResourceSignatureD3D11Impl;
 class DeviceMemoryD3D11Impl;
-class PipelineStateCacheD3D11Impl
-{};
+class PipelineStateCacheD3D11Impl;
+class SuperResolutionD3D11Impl;
 
 class FixedBlockMemoryAllocator;
 
@@ -127,7 +127,7 @@ struct EngineD3D11ImplTraits
     using PipelineResourceSignatureImplType = PipelineResourceSignatureD3D11Impl;
     using DeviceMemoryImplType              = DeviceMemoryD3D11Impl;
     using PipelineStateCacheImplType        = PipelineStateCacheD3D11Impl;
-
+    using SuperResolutionImplType           = SuperResolutionD3D11Impl;
 
     using BuffViewObjAllocatorType = FixedBlockMemoryAllocator;
     using TexViewObjAllocatorType  = FixedBlockMemoryAllocator;

Graphics/GraphicsEngineD3D11/include/RenderDeviceD3D11Impl.hpp

@@ -111,6 +111,14 @@ class RenderDeviceD3D11Impl final : public RenderDeviceD3DBase<EngineD3D11ImplTr
     virtual void DILIGENT_CALL_TYPE CreateSBT(const ShaderBindingTableDesc& Desc,
                                               IShaderBindingTable**         ppSBT) override final;
 
+    /// Implementation of IRenderDevice::CreateSuperResolution() in Direct3D11 backend.
+    virtual void DILIGENT_CALL_TYPE CreateSuperResolution(const SuperResolutionDesc& Desc,
+                                                          ISuperResolution**         ppUpscaler) override final;
+
+    /// Implementation of IRenderDevice::GetSuperResolutionSourceSettings() in Direct3D11 backend.
+    virtual void DILIGENT_CALL_TYPE GetSuperResolutionSourceSettings(const SuperResolutionSourceSettingsAttribs& Attribs,
+                                                                     SuperResolutionSourceSettings&              Settings) const override final;
+
     /// Implementation of IRenderDevice::CreatePipelineResourceSignature() in Direct3D11 backend.
     virtual void DILIGENT_CALL_TYPE CreatePipelineResourceSignature(const PipelineResourceSignatureDesc& Desc,
                                                                     IPipelineResourceSignature**         ppSignature) override final;

Graphics/GraphicsEngineD3D11/src/DeviceContextD3D11Impl.cpp

@@ -2466,6 +2466,12 @@ void DeviceContextD3D11Impl::SetShadingRate(SHADING_RATE BaseRate, SHADING_RATE_
     UNSUPPORTED("SetShadingRate is not supported in DirectX 11");
 }
 
+void DeviceContextD3D11Impl::ExecuteSuperResolution(const ExecuteSuperResolutionAttribs& Attribs,
+                                                    ISuperResolution*                    pUpscaler)
+{
+    UNSUPPORTED("ExecuteSuperResolution is not supported in DirectX 11");
+}
+
 void DeviceContextD3D11Impl::BindSparseResourceMemory(const BindSparseResourceMemoryAttribs& Attribs)
 {
     TDeviceContextBase::BindSparseResourceMemory(Attribs, 0);

Graphics/GraphicsEngineD3D11/src/EngineFactoryD3D11.cpp

@@ -490,7 +490,7 @@ GraphicsAdapterInfo EngineFactoryD3D11Impl::GetGraphicsAdapterInfo(void*
         Features.ShaderFloat16 = ShaderFloat16Supported ? DEVICE_FEATURE_STATE_ENABLED : DEVICE_FEATURE_STATE_DISABLED;
     }
 
-    ASSERT_SIZEOF(Features, 47, "Did you add a new feature to DeviceFeatures? Please handle its status here.");
+    ASSERT_SIZEOF(Features, 48, "Did you add a new feature to DeviceFeatures? Please handle its status here.");
 
     // Texture properties
     {

Graphics/GraphicsEngineD3D11/src/RenderDeviceD3D11Impl.cpp

@@ -58,6 +58,10 @@ class TopLevelASD3D11Impl
 {};
 class ShaderBindingTableD3D11Impl
 {};
+class PipelineStateCacheD3D11Impl
+{};
+class SuperResolutionD3D11Impl
+{};
 
 RenderDeviceD3D11Impl::RenderDeviceD3D11Impl(IReferenceCounters*          pRefCounters,
                                              IMemoryAllocator&            RawMemAllocator,
@@ -355,6 +359,20 @@ void RenderDeviceD3D11Impl::CreateSBT(const ShaderBindingTableDesc& Desc,
     *ppSBT = nullptr;
 }
 
+void RenderDeviceD3D11Impl::CreateSuperResolution(const SuperResolutionDesc& Desc,
+                                                  ISuperResolution**         ppUpscaler)
+{
+    UNSUPPORTED("CreateSuperResolution is not supported in DirectX 11");
+    *ppUpscaler = nullptr;
+}
+
+void RenderDeviceD3D11Impl::GetSuperResolutionSourceSettings(const SuperResolutionSourceSettingsAttribs& Attribs,
+                                                             SuperResolutionSourceSettings&              Settings) const
+{
+    UNSUPPORTED("GetSuperResolutionSourceSettings is not supported in DirectX 11");
+    Settings = {};
+}
+
 void RenderDeviceD3D11Impl::CreatePipelineResourceSignature(const PipelineResourceSignatureDesc& Desc,
                                                             IPipelineResourceSignature**         ppSignature)
 {

Graphics/GraphicsEngineD3D12/include/DeviceContextD3D12Impl.hpp

@@ -299,6 +299,9 @@ class DeviceContextD3D12Impl final : public DeviceContextNextGenBase<EngineD3D12
                                                    SHADING_RATE_COMBINER PrimitiveCombiner,
                                                    SHADING_RATE_COMBINER TextureCombiner) override final;
 
+    /// Implementation of IDeviceContext::ExecuteSuperResolution() in Direct3D12 backend.
+    virtual void DILIGENT_CALL_TYPE ExecuteSuperResolution(const ExecuteSuperResolutionAttribs& Attribs,
+                                                           ISuperResolution*                    pUpscaler) override final;
     /// Implementation of IDeviceContext::BindSparseResourceMemory() in Direct3D12 backend.
     virtual void DILIGENT_CALL_TYPE BindSparseResourceMemory(const BindSparseResourceMemoryAttribs& Attribs) override final;
 

Graphics/GraphicsEngineD3D12/include/EngineD3D12ImplTraits.hpp

@@ -77,6 +77,7 @@ class ShaderBindingTableD3D12Impl;
 class PipelineResourceSignatureD3D12Impl;
 class DeviceMemoryD3D12Impl;
 class PipelineStateCacheD3D12Impl;
+class SuperResolutionD3D12Impl;
 
 class FixedBlockMemoryAllocator;
 
@@ -138,6 +139,7 @@ struct EngineD3D12ImplTraits
     using PipelineResourceSignatureImplType = PipelineResourceSignatureD3D12Impl;
     using DeviceMemoryImplType              = DeviceMemoryD3D12Impl;
     using PipelineStateCacheImplType        = PipelineStateCacheD3D12Impl;
+    using SuperResolutionImplType           = SuperResolutionD3D12Impl;
 
     using BuffViewObjAllocatorType = FixedBlockMemoryAllocator;
     using TexViewObjAllocatorType  = FixedBlockMemoryAllocator;