2026-03-08 23:13:08 -07:00
|
|
|
#include "rendering/amd_fsr3_runtime.hpp"
|
2026-03-09 00:08:22 -07:00
|
|
|
|
2026-03-08 23:13:08 -07:00
|
|
|
#include <algorithm>
|
|
|
|
|
#include <cstdlib>
|
|
|
|
|
#include <cstring>
|
2026-03-08 23:32:02 -07:00
|
|
|
#include <type_traits>
|
|
|
|
|
#include <utility>
|
2026-03-08 23:13:08 -07:00
|
|
|
#include <vector>
|
|
|
|
|
|
|
|
|
|
#include "core/logger.hpp"
|
|
|
|
|
|
|
|
|
|
#if defined(_WIN32)
|
|
|
|
|
#include <windows.h>
|
|
|
|
|
#else
|
|
|
|
|
#include <dlfcn.h>
|
|
|
|
|
#endif
|
2026-03-09 00:09:15 -07:00
|
|
|
|
|
|
|
|
#if WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
2026-03-09 04:24:24 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
|
|
|
|
#include "third_party/ffx_fsr3_legacy_compat.h"
|
|
|
|
|
#include <ffx_vk.h>
|
|
|
|
|
#else
|
2026-03-09 00:09:15 -07:00
|
|
|
#include <FidelityFX/host/ffx_fsr3.h>
|
|
|
|
|
#include <FidelityFX/host/backends/vk/ffx_vk.h>
|
2026-03-08 23:13:08 -07:00
|
|
|
#endif
|
2026-03-09 04:24:24 -07:00
|
|
|
#endif
|
2026-03-08 23:13:08 -07:00
|
|
|
|
|
|
|
|
namespace wowee::rendering {
|
|
|
|
|
|
|
|
|
|
#if WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
|
|
|
|
struct AmdFsr3Runtime::RuntimeFns {
|
|
|
|
|
decltype(&ffxGetScratchMemorySizeVK) getScratchMemorySizeVK = nullptr;
|
|
|
|
|
decltype(&ffxGetDeviceVK) getDeviceVK = nullptr;
|
|
|
|
|
decltype(&ffxGetInterfaceVK) getInterfaceVK = nullptr;
|
|
|
|
|
decltype(&ffxGetCommandListVK) getCommandListVK = nullptr;
|
|
|
|
|
decltype(&ffxGetResourceVK) getResourceVK = nullptr;
|
|
|
|
|
decltype(&ffxFsr3ContextCreate) fsr3ContextCreate = nullptr;
|
|
|
|
|
decltype(&ffxFsr3ContextDispatchUpscale) fsr3ContextDispatchUpscale = nullptr;
|
2026-03-08 23:20:50 -07:00
|
|
|
decltype(&ffxFsr3ConfigureFrameGeneration) fsr3ConfigureFrameGeneration = nullptr;
|
|
|
|
|
decltype(&ffxFsr3DispatchFrameGeneration) fsr3DispatchFrameGeneration = nullptr;
|
2026-03-08 23:13:08 -07:00
|
|
|
decltype(&ffxFsr3ContextDestroy) fsr3ContextDestroy = nullptr;
|
|
|
|
|
};
|
|
|
|
|
#else
|
|
|
|
|
struct AmdFsr3Runtime::RuntimeFns {};
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
AmdFsr3Runtime::AmdFsr3Runtime() = default;
|
|
|
|
|
|
|
|
|
|
AmdFsr3Runtime::~AmdFsr3Runtime() {
|
|
|
|
|
shutdown();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#if WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
|
|
|
|
namespace {
|
2026-03-08 23:20:50 -07:00
|
|
|
FfxErrorCode vkSwapchainConfigureNoop(const FfxFrameGenerationConfig*) {
|
|
|
|
|
return FFX_OK;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 23:32:02 -07:00
|
|
|
template <typename T, typename = void>
|
|
|
|
|
struct HasUpscaleOutputSize : std::false_type {};
|
|
|
|
|
|
|
|
|
|
template <typename T>
|
|
|
|
|
struct HasUpscaleOutputSize<T, std::void_t<decltype(std::declval<T&>().upscaleOutputSize)>> : std::true_type {};
|
|
|
|
|
|
|
|
|
|
template <typename T>
|
|
|
|
|
inline void setUpscaleOutputSizeIfPresent(T& ctxDesc, uint32_t width, uint32_t height) {
|
|
|
|
|
if constexpr (HasUpscaleOutputSize<T>::value) {
|
|
|
|
|
ctxDesc.upscaleOutputSize.width = width;
|
|
|
|
|
ctxDesc.upscaleOutputSize.height = height;
|
|
|
|
|
} else {
|
|
|
|
|
(void)ctxDesc;
|
|
|
|
|
(void)width;
|
|
|
|
|
(void)height;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 23:13:08 -07:00
|
|
|
FfxSurfaceFormat mapVkFormatToFfxSurfaceFormat(VkFormat format, bool isDepth) {
|
|
|
|
|
if (isDepth) {
|
|
|
|
|
switch (format) {
|
|
|
|
|
case VK_FORMAT_D32_SFLOAT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R32_FLOAT;
|
|
|
|
|
case VK_FORMAT_D16_UNORM:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16_UNORM;
|
|
|
|
|
case VK_FORMAT_D24_UNORM_S8_UINT:
|
|
|
|
|
case VK_FORMAT_D32_SFLOAT_S8_UINT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R32_FLOAT;
|
|
|
|
|
default:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R32_FLOAT;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
switch (format) {
|
|
|
|
|
case VK_FORMAT_R16G16B16A16_SFLOAT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16G16B16A16_FLOAT;
|
|
|
|
|
case VK_FORMAT_R8G8B8A8_UNORM:
|
|
|
|
|
case VK_FORMAT_B8G8R8A8_UNORM:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R8G8B8A8_UNORM;
|
|
|
|
|
case VK_FORMAT_R8G8B8A8_SRGB:
|
|
|
|
|
case VK_FORMAT_B8G8R8A8_SRGB:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R8G8B8A8_SRGB;
|
|
|
|
|
case VK_FORMAT_A2R10G10B10_UNORM_PACK32:
|
|
|
|
|
case VK_FORMAT_A2B10G10R10_UNORM_PACK32:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R10G10B10A2_UNORM;
|
|
|
|
|
case VK_FORMAT_B10G11R11_UFLOAT_PACK32:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R11G11B10_FLOAT;
|
|
|
|
|
case VK_FORMAT_R16G16_SFLOAT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16G16_FLOAT;
|
|
|
|
|
case VK_FORMAT_R16G16_UINT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16G16_UINT;
|
|
|
|
|
case VK_FORMAT_R16_SFLOAT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16_FLOAT;
|
|
|
|
|
case VK_FORMAT_R16_UINT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16_UINT;
|
|
|
|
|
case VK_FORMAT_R16_UNORM:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16_UNORM;
|
|
|
|
|
case VK_FORMAT_R16_SNORM:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R16_SNORM;
|
|
|
|
|
case VK_FORMAT_R8_UNORM:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R8_UNORM;
|
|
|
|
|
case VK_FORMAT_R8_UINT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R8_UINT;
|
|
|
|
|
case VK_FORMAT_R8G8_UNORM:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R8G8_UNORM;
|
|
|
|
|
case VK_FORMAT_R32_SFLOAT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R32_FLOAT;
|
|
|
|
|
case VK_FORMAT_R32_UINT:
|
|
|
|
|
return FFX_SURFACE_FORMAT_R32_UINT;
|
|
|
|
|
default:
|
|
|
|
|
return FFX_SURFACE_FORMAT_UNKNOWN;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
FfxResourceDescription makeResourceDescription(VkFormat format,
|
|
|
|
|
uint32_t width,
|
|
|
|
|
uint32_t height,
|
|
|
|
|
FfxResourceUsage usage,
|
|
|
|
|
bool isDepth = false) {
|
|
|
|
|
FfxResourceDescription description{};
|
|
|
|
|
description.type = FFX_RESOURCE_TYPE_TEXTURE2D;
|
|
|
|
|
description.format = mapVkFormatToFfxSurfaceFormat(format, isDepth);
|
|
|
|
|
description.width = width;
|
|
|
|
|
description.height = height;
|
|
|
|
|
description.depth = 1;
|
|
|
|
|
description.mipCount = 1;
|
|
|
|
|
description.flags = FFX_RESOURCE_FLAGS_NONE;
|
|
|
|
|
description.usage = usage;
|
|
|
|
|
return description;
|
|
|
|
|
}
|
|
|
|
|
} // namespace
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
bool AmdFsr3Runtime::initialize(const AmdFsr3RuntimeInitDesc& desc) {
|
|
|
|
|
shutdown();
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_.clear();
|
|
|
|
|
loadPathKind_ = LoadPathKind::None;
|
2026-03-08 23:13:08 -07:00
|
|
|
|
|
|
|
|
#if !WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
|
|
|
|
(void)desc;
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "FSR3 runtime support not compiled in";
|
2026-03-08 23:13:08 -07:00
|
|
|
return false;
|
|
|
|
|
#else
|
|
|
|
|
if (!desc.physicalDevice || !desc.device || !desc.getDeviceProcAddr ||
|
|
|
|
|
desc.maxRenderWidth == 0 || desc.maxRenderHeight == 0 ||
|
|
|
|
|
desc.displayWidth == 0 || desc.displayHeight == 0 ||
|
|
|
|
|
desc.colorFormat == VK_FORMAT_UNDEFINED) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: invalid initialization descriptors.");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "invalid initialization descriptors";
|
2026-03-08 23:13:08 -07:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-09 04:33:05 -07:00
|
|
|
std::vector<std::string> candidates;
|
2026-03-08 23:13:08 -07:00
|
|
|
if (const char* envPath = std::getenv("WOWEE_FFX_SDK_RUNTIME_LIB")) {
|
2026-03-09 04:33:05 -07:00
|
|
|
if (*envPath) candidates.emplace_back(envPath);
|
2026-03-09 00:01:45 -07:00
|
|
|
}
|
2026-03-08 23:13:08 -07:00
|
|
|
#if defined(_WIN32)
|
2026-03-09 04:33:05 -07:00
|
|
|
candidates.emplace_back("amd_fidelityfx_vk.dll");
|
|
|
|
|
candidates.emplace_back("libamd_fidelityfx_vk.dll");
|
|
|
|
|
candidates.emplace_back("ffx_fsr3_vk.dll");
|
|
|
|
|
candidates.emplace_back("ffx_fsr3.dll");
|
2026-03-08 23:13:08 -07:00
|
|
|
#elif defined(__APPLE__)
|
2026-03-09 04:33:05 -07:00
|
|
|
candidates.emplace_back("libamd_fidelityfx_vk.dylib");
|
|
|
|
|
candidates.emplace_back("libffx_fsr3_vk.dylib");
|
|
|
|
|
candidates.emplace_back("libffx_fsr3.dylib");
|
2026-03-08 23:13:08 -07:00
|
|
|
#else
|
2026-03-09 04:33:05 -07:00
|
|
|
candidates.emplace_back("./libamd_fidelityfx_vk.so");
|
|
|
|
|
candidates.emplace_back("libamd_fidelityfx_vk.so");
|
|
|
|
|
candidates.emplace_back("./libffx_fsr3_vk.so");
|
|
|
|
|
candidates.emplace_back("libffx_fsr3_vk.so");
|
|
|
|
|
candidates.emplace_back("libffx_fsr3.so");
|
2026-03-08 23:13:08 -07:00
|
|
|
#endif
|
2026-03-09 04:33:05 -07:00
|
|
|
|
|
|
|
|
for (const std::string& path : candidates) {
|
2026-03-08 23:13:08 -07:00
|
|
|
#if defined(_WIN32)
|
2026-03-09 04:33:05 -07:00
|
|
|
HMODULE h = LoadLibraryA(path.c_str());
|
2026-03-08 23:13:08 -07:00
|
|
|
if (!h) continue;
|
|
|
|
|
libHandle_ = reinterpret_cast<void*>(h);
|
|
|
|
|
#else
|
2026-03-09 04:33:05 -07:00
|
|
|
void* h = dlopen(path.c_str(), RTLD_NOW | RTLD_LOCAL);
|
2026-03-08 23:13:08 -07:00
|
|
|
if (!h) continue;
|
|
|
|
|
libHandle_ = h;
|
|
|
|
|
#endif
|
2026-03-09 04:33:05 -07:00
|
|
|
loadedLibraryPath_ = path;
|
|
|
|
|
loadPathKind_ = LoadPathKind::Official;
|
2026-03-08 23:13:08 -07:00
|
|
|
break;
|
|
|
|
|
}
|
2026-03-09 04:33:05 -07:00
|
|
|
|
2026-03-09 00:01:45 -07:00
|
|
|
if (!libHandle_) {
|
2026-03-09 04:24:24 -07:00
|
|
|
lastError_ = "no official runtime (Path A) found";
|
2026-03-09 00:01:45 -07:00
|
|
|
return false;
|
|
|
|
|
}
|
2026-03-08 23:13:08 -07:00
|
|
|
|
|
|
|
|
auto resolveSym = [&](const char* name) -> void* {
|
|
|
|
|
#if defined(_WIN32)
|
|
|
|
|
return reinterpret_cast<void*>(GetProcAddress(reinterpret_cast<HMODULE>(libHandle_), name));
|
|
|
|
|
#else
|
|
|
|
|
return dlsym(libHandle_, name);
|
|
|
|
|
#endif
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
fns_ = new RuntimeFns{};
|
|
|
|
|
fns_->getScratchMemorySizeVK = reinterpret_cast<decltype(fns_->getScratchMemorySizeVK)>(resolveSym("ffxGetScratchMemorySizeVK"));
|
|
|
|
|
fns_->getDeviceVK = reinterpret_cast<decltype(fns_->getDeviceVK)>(resolveSym("ffxGetDeviceVK"));
|
|
|
|
|
fns_->getInterfaceVK = reinterpret_cast<decltype(fns_->getInterfaceVK)>(resolveSym("ffxGetInterfaceVK"));
|
|
|
|
|
fns_->getCommandListVK = reinterpret_cast<decltype(fns_->getCommandListVK)>(resolveSym("ffxGetCommandListVK"));
|
|
|
|
|
fns_->getResourceVK = reinterpret_cast<decltype(fns_->getResourceVK)>(resolveSym("ffxGetResourceVK"));
|
|
|
|
|
fns_->fsr3ContextCreate = reinterpret_cast<decltype(fns_->fsr3ContextCreate)>(resolveSym("ffxFsr3ContextCreate"));
|
|
|
|
|
fns_->fsr3ContextDispatchUpscale = reinterpret_cast<decltype(fns_->fsr3ContextDispatchUpscale)>(resolveSym("ffxFsr3ContextDispatchUpscale"));
|
2026-03-08 23:20:50 -07:00
|
|
|
fns_->fsr3ConfigureFrameGeneration = reinterpret_cast<decltype(fns_->fsr3ConfigureFrameGeneration)>(resolveSym("ffxFsr3ConfigureFrameGeneration"));
|
|
|
|
|
fns_->fsr3DispatchFrameGeneration = reinterpret_cast<decltype(fns_->fsr3DispatchFrameGeneration)>(resolveSym("ffxFsr3DispatchFrameGeneration"));
|
2026-03-08 23:13:08 -07:00
|
|
|
fns_->fsr3ContextDestroy = reinterpret_cast<decltype(fns_->fsr3ContextDestroy)>(resolveSym("ffxFsr3ContextDestroy"));
|
|
|
|
|
|
|
|
|
|
if (!fns_->getScratchMemorySizeVK || !fns_->getDeviceVK || !fns_->getInterfaceVK ||
|
|
|
|
|
!fns_->getCommandListVK || !fns_->getResourceVK || !fns_->fsr3ContextCreate || !fns_->fsr3ContextDispatchUpscale ||
|
|
|
|
|
!fns_->fsr3ContextDestroy) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: required symbols not found in ", loadedLibraryPath_);
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "missing required Vulkan FSR3 symbols in runtime library";
|
2026-03-08 23:13:08 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-09 04:24:24 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
|
|
|
|
scratchBufferSize_ = fns_->getScratchMemorySizeVK(FFX_FSR3_CONTEXT_COUNT);
|
|
|
|
|
#else
|
2026-03-08 23:13:08 -07:00
|
|
|
scratchBufferSize_ = fns_->getScratchMemorySizeVK(desc.physicalDevice, FFX_FSR3_CONTEXT_COUNT);
|
2026-03-09 04:24:24 -07:00
|
|
|
#endif
|
2026-03-08 23:13:08 -07:00
|
|
|
if (scratchBufferSize_ == 0) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: scratch buffer size query returned 0.");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "scratch buffer size query returned 0";
|
2026-03-08 23:13:08 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
2026-03-09 04:33:05 -07:00
|
|
|
|
2026-03-08 23:13:08 -07:00
|
|
|
scratchBuffer_ = std::malloc(scratchBufferSize_);
|
|
|
|
|
if (!scratchBuffer_) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: failed to allocate scratch buffer.");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "failed to allocate scratch buffer";
|
2026-03-08 23:13:08 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-09 04:24:24 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
|
|
|
|
FfxDevice ffxDevice = fns_->getDeviceVK(desc.device);
|
|
|
|
|
#else
|
2026-03-08 23:13:08 -07:00
|
|
|
VkDeviceContext vkDevCtx{};
|
|
|
|
|
vkDevCtx.vkDevice = desc.device;
|
|
|
|
|
vkDevCtx.vkPhysicalDevice = desc.physicalDevice;
|
|
|
|
|
vkDevCtx.vkDeviceProcAddr = desc.getDeviceProcAddr;
|
|
|
|
|
FfxDevice ffxDevice = fns_->getDeviceVK(&vkDevCtx);
|
2026-03-09 04:24:24 -07:00
|
|
|
#endif
|
2026-03-09 04:33:05 -07:00
|
|
|
|
2026-03-08 23:13:08 -07:00
|
|
|
FfxInterface backendShared{};
|
2026-03-09 04:24:24 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
|
|
|
|
FfxErrorCode ifaceErr = fns_->getInterfaceVK(
|
|
|
|
|
&backendShared, ffxDevice, desc.physicalDevice, scratchBuffer_, scratchBufferSize_, FFX_FSR3_CONTEXT_COUNT);
|
|
|
|
|
#else
|
|
|
|
|
FfxErrorCode ifaceErr = fns_->getInterfaceVK(
|
|
|
|
|
&backendShared, ffxDevice, scratchBuffer_, scratchBufferSize_, FFX_FSR3_CONTEXT_COUNT);
|
|
|
|
|
#endif
|
2026-03-08 23:13:08 -07:00
|
|
|
if (ifaceErr != FFX_OK) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: ffxGetInterfaceVK failed (", static_cast<int>(ifaceErr), ").");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "ffxGetInterfaceVK failed";
|
2026-03-08 23:13:08 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
FfxFsr3ContextDescription ctxDesc{};
|
|
|
|
|
ctxDesc.flags = FFX_FSR3_ENABLE_AUTO_EXPOSURE |
|
2026-03-08 23:20:50 -07:00
|
|
|
FFX_FSR3_ENABLE_MOTION_VECTORS_JITTER_CANCELLATION;
|
|
|
|
|
if (!desc.enableFrameGeneration) {
|
|
|
|
|
ctxDesc.flags |= FFX_FSR3_ENABLE_UPSCALING_ONLY;
|
|
|
|
|
}
|
2026-03-08 23:13:08 -07:00
|
|
|
if (desc.hdrInput) ctxDesc.flags |= FFX_FSR3_ENABLE_HIGH_DYNAMIC_RANGE;
|
|
|
|
|
if (desc.depthInverted) ctxDesc.flags |= FFX_FSR3_ENABLE_DEPTH_INVERTED;
|
|
|
|
|
ctxDesc.maxRenderSize.width = desc.maxRenderWidth;
|
|
|
|
|
ctxDesc.maxRenderSize.height = desc.maxRenderHeight;
|
2026-03-08 23:32:02 -07:00
|
|
|
setUpscaleOutputSizeIfPresent(ctxDesc, desc.displayWidth, desc.displayHeight);
|
2026-03-08 23:13:08 -07:00
|
|
|
ctxDesc.displaySize.width = desc.displayWidth;
|
|
|
|
|
ctxDesc.displaySize.height = desc.displayHeight;
|
2026-03-08 23:20:50 -07:00
|
|
|
if (!backendShared.fpSwapChainConfigureFrameGeneration) {
|
|
|
|
|
backendShared.fpSwapChainConfigureFrameGeneration = vkSwapchainConfigureNoop;
|
|
|
|
|
}
|
2026-03-08 23:13:08 -07:00
|
|
|
ctxDesc.backendInterfaceSharedResources = backendShared;
|
|
|
|
|
ctxDesc.backendInterfaceUpscaling = backendShared;
|
|
|
|
|
ctxDesc.backendInterfaceFrameInterpolation = backendShared;
|
|
|
|
|
ctxDesc.fpMessage = nullptr;
|
|
|
|
|
ctxDesc.backBufferFormat = mapVkFormatToFfxSurfaceFormat(desc.colorFormat, false);
|
|
|
|
|
|
|
|
|
|
contextStorage_ = std::malloc(sizeof(FfxFsr3Context));
|
|
|
|
|
if (!contextStorage_) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: failed to allocate context storage.");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "failed to allocate context storage";
|
2026-03-08 23:13:08 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
std::memset(contextStorage_, 0, sizeof(FfxFsr3Context));
|
|
|
|
|
|
|
|
|
|
FfxErrorCode createErr = fns_->fsr3ContextCreate(reinterpret_cast<FfxFsr3Context*>(contextStorage_), &ctxDesc);
|
|
|
|
|
if (createErr != FFX_OK) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: ffxFsr3ContextCreate failed (", static_cast<int>(createErr), ").");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "ffxFsr3ContextCreate failed";
|
2026-03-08 23:13:08 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 23:20:50 -07:00
|
|
|
if (desc.enableFrameGeneration) {
|
|
|
|
|
if (!fns_->fsr3ConfigureFrameGeneration || !fns_->fsr3DispatchFrameGeneration) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: frame generation symbols unavailable in ", loadedLibraryPath_);
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "frame generation entry points unavailable";
|
2026-03-08 23:20:50 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
FfxFrameGenerationConfig fgCfg{};
|
|
|
|
|
fgCfg.frameGenerationEnabled = true;
|
|
|
|
|
fgCfg.allowAsyncWorkloads = false;
|
|
|
|
|
fgCfg.flags = 0;
|
|
|
|
|
fgCfg.onlyPresentInterpolated = false;
|
|
|
|
|
FfxErrorCode cfgErr = fns_->fsr3ConfigureFrameGeneration(
|
|
|
|
|
reinterpret_cast<FfxFsr3Context*>(contextStorage_), &fgCfg);
|
|
|
|
|
if (cfgErr != FFX_OK) {
|
|
|
|
|
LOG_WARNING("FSR3 runtime: ffxFsr3ConfigureFrameGeneration failed (", static_cast<int>(cfgErr), ").");
|
2026-03-09 00:01:45 -07:00
|
|
|
lastError_ = "ffxFsr3ConfigureFrameGeneration failed";
|
2026-03-08 23:20:50 -07:00
|
|
|
shutdown();
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
frameGenerationReady_ = true;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 23:13:08 -07:00
|
|
|
ready_ = true;
|
2026-03-09 02:20:14 -07:00
|
|
|
LOG_INFO("FSR3 runtime: loaded official library ", loadedLibraryPath_,
|
|
|
|
|
" framegenReady=", frameGenerationReady_ ? "yes" : "no");
|
2026-03-08 23:13:08 -07:00
|
|
|
return true;
|
|
|
|
|
#endif
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool AmdFsr3Runtime::dispatchUpscale(const AmdFsr3RuntimeDispatchDesc& desc) {
|
|
|
|
|
#if !WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
|
|
|
|
(void)desc;
|
2026-03-09 01:15:49 -07:00
|
|
|
lastError_ = "FSR3 runtime support not compiled in";
|
2026-03-08 23:13:08 -07:00
|
|
|
return false;
|
|
|
|
|
#else
|
2026-03-09 01:15:49 -07:00
|
|
|
if (!ready_ || !fns_) {
|
|
|
|
|
lastError_ = "runtime not initialized";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
if (!desc.commandBuffer || !desc.colorImage || !desc.depthImage || !desc.motionVectorImage || !desc.outputImage) {
|
|
|
|
|
lastError_ = "invalid upscale dispatch resources";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
if (!contextStorage_ || !fns_->fsr3ContextDispatchUpscale) {
|
|
|
|
|
lastError_ = "official runtime upscale context unavailable";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
2026-03-08 23:13:08 -07:00
|
|
|
|
|
|
|
|
FfxResourceDescription colorDesc = makeResourceDescription(
|
|
|
|
|
desc.colorFormat, desc.renderWidth, desc.renderHeight, FFX_RESOURCE_USAGE_READ_ONLY);
|
|
|
|
|
FfxResourceDescription depthDesc = makeResourceDescription(
|
|
|
|
|
desc.depthFormat, desc.renderWidth, desc.renderHeight, FFX_RESOURCE_USAGE_DEPTHTARGET, true);
|
|
|
|
|
FfxResourceDescription mvDesc = makeResourceDescription(
|
|
|
|
|
desc.motionVectorFormat, desc.renderWidth, desc.renderHeight, FFX_RESOURCE_USAGE_READ_ONLY);
|
|
|
|
|
FfxResourceDescription outDesc = makeResourceDescription(
|
|
|
|
|
desc.outputFormat, desc.outputWidth, desc.outputHeight, FFX_RESOURCE_USAGE_UAV);
|
|
|
|
|
|
|
|
|
|
FfxFsr3DispatchUpscaleDescription dispatch{};
|
|
|
|
|
dispatch.commandList = fns_->getCommandListVK(desc.commandBuffer);
|
|
|
|
|
static wchar_t kColorName[] = L"FSR3_Color";
|
|
|
|
|
static wchar_t kDepthName[] = L"FSR3_Depth";
|
|
|
|
|
static wchar_t kMotionName[] = L"FSR3_MotionVectors";
|
|
|
|
|
static wchar_t kOutputName[] = L"FSR3_Output";
|
2026-03-09 04:33:05 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
2026-03-09 04:24:24 -07:00
|
|
|
dispatch.color = fns_->getResourceVK(desc.colorImage, colorDesc, kColorName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
|
|
|
|
dispatch.depth = fns_->getResourceVK(desc.depthImage, depthDesc, kDepthName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
|
|
|
|
dispatch.motionVectors = fns_->getResourceVK(desc.motionVectorImage, mvDesc, kMotionName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
2026-03-09 04:33:05 -07:00
|
|
|
#else
|
2026-03-08 23:13:08 -07:00
|
|
|
dispatch.color = fns_->getResourceVK(reinterpret_cast<void*>(desc.colorImage), colorDesc, kColorName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
|
|
|
|
dispatch.depth = fns_->getResourceVK(reinterpret_cast<void*>(desc.depthImage), depthDesc, kDepthName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
|
|
|
|
dispatch.motionVectors = fns_->getResourceVK(reinterpret_cast<void*>(desc.motionVectorImage), mvDesc, kMotionName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
2026-03-09 04:33:05 -07:00
|
|
|
#endif
|
2026-03-08 23:13:08 -07:00
|
|
|
dispatch.exposure = FfxResource{};
|
|
|
|
|
dispatch.reactive = FfxResource{};
|
|
|
|
|
dispatch.transparencyAndComposition = FfxResource{};
|
2026-03-09 04:33:05 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
2026-03-09 04:24:24 -07:00
|
|
|
dispatch.upscaleOutput = fns_->getResourceVK(desc.outputImage, outDesc, kOutputName, FFX_RESOURCE_STATE_UNORDERED_ACCESS);
|
2026-03-09 04:33:05 -07:00
|
|
|
#else
|
2026-03-08 23:13:08 -07:00
|
|
|
dispatch.upscaleOutput = fns_->getResourceVK(reinterpret_cast<void*>(desc.outputImage), outDesc, kOutputName, FFX_RESOURCE_STATE_UNORDERED_ACCESS);
|
2026-03-09 04:33:05 -07:00
|
|
|
#endif
|
2026-03-08 23:13:08 -07:00
|
|
|
dispatch.jitterOffset.x = desc.jitterX;
|
|
|
|
|
dispatch.jitterOffset.y = desc.jitterY;
|
|
|
|
|
dispatch.motionVectorScale.x = desc.motionScaleX;
|
|
|
|
|
dispatch.motionVectorScale.y = desc.motionScaleY;
|
|
|
|
|
dispatch.renderSize.width = desc.renderWidth;
|
|
|
|
|
dispatch.renderSize.height = desc.renderHeight;
|
|
|
|
|
dispatch.enableSharpening = false;
|
|
|
|
|
dispatch.sharpness = 0.0f;
|
|
|
|
|
dispatch.frameTimeDelta = std::max(0.001f, desc.frameTimeDeltaMs);
|
|
|
|
|
dispatch.preExposure = 1.0f;
|
|
|
|
|
dispatch.reset = desc.reset;
|
|
|
|
|
dispatch.cameraNear = desc.cameraNear;
|
|
|
|
|
dispatch.cameraFar = desc.cameraFar;
|
|
|
|
|
dispatch.cameraFovAngleVertical = desc.cameraFovYRadians;
|
|
|
|
|
dispatch.viewSpaceToMetersFactor = 1.0f;
|
|
|
|
|
|
|
|
|
|
FfxErrorCode err = fns_->fsr3ContextDispatchUpscale(
|
|
|
|
|
reinterpret_cast<FfxFsr3Context*>(contextStorage_), &dispatch);
|
2026-03-09 01:15:49 -07:00
|
|
|
if (err != FFX_OK) {
|
|
|
|
|
lastError_ = "ffxFsr3ContextDispatchUpscale failed";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
lastError_.clear();
|
|
|
|
|
return true;
|
2026-03-08 23:13:08 -07:00
|
|
|
#endif
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 23:20:50 -07:00
|
|
|
bool AmdFsr3Runtime::dispatchFrameGeneration(const AmdFsr3RuntimeDispatchDesc& desc) {
|
|
|
|
|
#if !WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
|
|
|
|
(void)desc;
|
2026-03-09 01:15:49 -07:00
|
|
|
lastError_ = "FSR3 runtime support not compiled in";
|
2026-03-08 23:20:50 -07:00
|
|
|
return false;
|
|
|
|
|
#else
|
2026-03-09 01:15:49 -07:00
|
|
|
if (!ready_ || !frameGenerationReady_ || !fns_) {
|
|
|
|
|
lastError_ = "frame generation is not ready";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
2026-03-08 23:20:50 -07:00
|
|
|
if (!desc.commandBuffer || !desc.outputImage || !desc.frameGenOutputImage ||
|
2026-03-09 01:15:49 -07:00
|
|
|
desc.outputWidth == 0 || desc.outputHeight == 0 || desc.outputFormat == VK_FORMAT_UNDEFINED) {
|
|
|
|
|
lastError_ = "invalid frame generation dispatch resources";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
if (!contextStorage_ || !fns_->fsr3DispatchFrameGeneration) {
|
|
|
|
|
lastError_ = "official runtime frame generation context unavailable";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
2026-03-08 23:20:50 -07:00
|
|
|
|
|
|
|
|
FfxResourceDescription presentDesc = makeResourceDescription(
|
|
|
|
|
desc.outputFormat, desc.outputWidth, desc.outputHeight, FFX_RESOURCE_USAGE_READ_ONLY);
|
|
|
|
|
FfxResourceDescription fgOutDesc = makeResourceDescription(
|
|
|
|
|
desc.outputFormat, desc.outputWidth, desc.outputHeight, FFX_RESOURCE_USAGE_UAV);
|
|
|
|
|
|
|
|
|
|
static wchar_t kPresentName[] = L"FSR3_PresentColor";
|
|
|
|
|
static wchar_t kInterpolatedName[] = L"FSR3_InterpolatedOutput";
|
|
|
|
|
FfxFrameGenerationDispatchDescription fgDispatch{};
|
|
|
|
|
fgDispatch.commandList = fns_->getCommandListVK(desc.commandBuffer);
|
2026-03-09 04:33:05 -07:00
|
|
|
#if WOWEE_AMD_FFX_SDK_KITS
|
2026-03-09 04:24:24 -07:00
|
|
|
fgDispatch.presentColor = fns_->getResourceVK(
|
|
|
|
|
desc.outputImage, presentDesc, kPresentName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
|
|
|
|
fgDispatch.outputs[0] = fns_->getResourceVK(
|
|
|
|
|
desc.frameGenOutputImage, fgOutDesc, kInterpolatedName, FFX_RESOURCE_STATE_UNORDERED_ACCESS);
|
2026-03-09 04:33:05 -07:00
|
|
|
#else
|
2026-03-08 23:20:50 -07:00
|
|
|
fgDispatch.presentColor = fns_->getResourceVK(
|
|
|
|
|
reinterpret_cast<void*>(desc.outputImage), presentDesc, kPresentName, FFX_RESOURCE_STATE_COMPUTE_READ);
|
|
|
|
|
fgDispatch.outputs[0] = fns_->getResourceVK(
|
|
|
|
|
reinterpret_cast<void*>(desc.frameGenOutputImage), fgOutDesc, kInterpolatedName, FFX_RESOURCE_STATE_UNORDERED_ACCESS);
|
2026-03-09 04:33:05 -07:00
|
|
|
#endif
|
2026-03-08 23:20:50 -07:00
|
|
|
fgDispatch.numInterpolatedFrames = 1;
|
|
|
|
|
fgDispatch.reset = desc.reset;
|
|
|
|
|
fgDispatch.backBufferTransferFunction = FFX_BACKBUFFER_TRANSFER_FUNCTION_SRGB;
|
|
|
|
|
fgDispatch.minMaxLuminance[0] = 0.0f;
|
|
|
|
|
fgDispatch.minMaxLuminance[1] = 1.0f;
|
|
|
|
|
|
|
|
|
|
FfxErrorCode err = fns_->fsr3DispatchFrameGeneration(&fgDispatch);
|
2026-03-09 01:15:49 -07:00
|
|
|
if (err != FFX_OK) {
|
|
|
|
|
lastError_ = "ffxFsr3DispatchFrameGeneration failed";
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
lastError_.clear();
|
|
|
|
|
return true;
|
2026-03-08 23:20:50 -07:00
|
|
|
#endif
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 23:13:08 -07:00
|
|
|
void AmdFsr3Runtime::shutdown() {
|
|
|
|
|
#if WOWEE_HAS_AMD_FSR3_FRAMEGEN
|
|
|
|
|
if (contextStorage_ && fns_ && fns_->fsr3ContextDestroy) {
|
|
|
|
|
fns_->fsr3ContextDestroy(reinterpret_cast<FfxFsr3Context*>(contextStorage_));
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
if (contextStorage_) {
|
|
|
|
|
std::free(contextStorage_);
|
|
|
|
|
contextStorage_ = nullptr;
|
|
|
|
|
}
|
|
|
|
|
if (scratchBuffer_) {
|
|
|
|
|
std::free(scratchBuffer_);
|
|
|
|
|
scratchBuffer_ = nullptr;
|
|
|
|
|
}
|
|
|
|
|
scratchBufferSize_ = 0;
|
|
|
|
|
ready_ = false;
|
2026-03-08 23:20:50 -07:00
|
|
|
frameGenerationReady_ = false;
|
2026-03-08 23:13:08 -07:00
|
|
|
if (fns_) {
|
|
|
|
|
delete fns_;
|
|
|
|
|
fns_ = nullptr;
|
|
|
|
|
}
|
|
|
|
|
#if defined(_WIN32)
|
|
|
|
|
if (libHandle_) FreeLibrary(reinterpret_cast<HMODULE>(libHandle_));
|
|
|
|
|
#else
|
|
|
|
|
if (libHandle_) dlclose(libHandle_);
|
|
|
|
|
#endif
|
|
|
|
|
libHandle_ = nullptr;
|
|
|
|
|
loadedLibraryPath_.clear();
|
2026-03-09 00:01:45 -07:00
|
|
|
loadPathKind_ = LoadPathKind::None;
|
2026-03-08 23:13:08 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
} // namespace wowee::rendering
|