Update SuperResolution API

Author: MikhailGorobets

Graphics/GraphicsEngine/interface/GraphicsTypes.h

@@ -3347,10 +3347,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);
 };
@@ -150,12 +164,12 @@ struct ExecuteSuperResolutionAttribs
 
     /// Output (upscaled) texture (unordered access view or render target view).
     /// Must match SuperResolutionDesc::OutputWidth x OutputHeight.
-    ITextureView* pOutputTextureRTV     DEFAULT_INITIALIZER(nullptr);
+    ITextureView* pOutputTextureView     DEFAULT_INITIALIZER(nullptr);
 
     /// 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).

Tests/DiligentCoreAPITest/src/SuperResolutionTest.cpp

@@ -329,7 +329,7 @@ TEST(SuperResolutionTest, ExecuteSpatialUpscaler)
 
     ExecuteSuperResolutionAttribs Attribs;
     Attribs.pColorTextureSRV  = pColorTex->GetDefaultView(TEXTURE_VIEW_SHADER_RESOURCE);
-    Attribs.pOutputTextureRTV = pOutputTex->GetDefaultView(TEXTURE_VIEW_RENDER_TARGET);
+    Attribs.pOutputTextureView = pOutputTex->GetDefaultView(TEXTURE_VIEW_RENDER_TARGET);
 
     pContext->ExecuteSuperResolution(Attribs, pUpscaler);
     pContext->Flush();
@@ -452,7 +452,7 @@ TEST(SuperResolutionTest, ExecuteTemporalUpscaler)
     Attribs.pColorTextureSRV   = pColorTex->GetDefaultView(TEXTURE_VIEW_SHADER_RESOURCE);
     Attribs.pDepthTextureSRV   = pDepthTex->GetDefaultView(TEXTURE_VIEW_SHADER_RESOURCE);
     Attribs.pMotionVectorsSRV  = pMotionTex->GetDefaultView(TEXTURE_VIEW_SHADER_RESOURCE);
-    Attribs.pOutputTextureRTV  = pOutputTex->GetDefaultView(TEXTURE_VIEW_RENDER_TARGET);
+    Attribs.pOutputTextureView  = pOutputTex->GetDefaultView(TEXTURE_VIEW_RENDER_TARGET);
     Attribs.JitterX            = 0.5f;
     Attribs.JitterY            = -0.5f;
     Attribs.MotionVectorScaleX = 1.0f;