FidelityFX 镜头

FidelityFX Lens 运行时库。

Defines

FFX_LENS_VERSION_MAJOR

#define FFX_LENS_VERSION_MAJOR (1)

FidelityFX Lens 主版本号。

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 38 行, 第 9 列)

FFX_LENS_VERSION_MINOR

#define FFX_LENS_VERSION_MINOR (1)

FidelityFX Lens 次版本号。

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 43 行, 第 9 列)

FFX_LENS_VERSION_PATCH

#define FFX_LENS_VERSION_PATCH (0)

FidelityFX Lens 修订版本号。

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 48 行, 第 9 列)

FFX_LENS_CONTEXT_COUNT

#define FFX_LENS_CONTEXT_COUNT 1

FidelityFX Lens 上下文计数。

定义 Lens 所需的内部效果上下文数量

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 55 行, 第 9 列)

FFX_LENS_CONTEXT_SIZE

#define FFX_LENS_CONTEXT_SIZE (9200)

以 32 位值为单位指定的上下文大小。

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 60 行, 第 9 列)

函数

ffxLensContextCreate

FFX_API FfxErrorCode ffxLensContextCreate(FfxLensContext *pContext, const FfxLensContextDescription *pContextDescription)

根据 FfxLensContextDescription 结构中设置的参数，创建一个 FidelityFX Lens Downsampler 上下文。

上下文结构是与 Lens API 交互的主要对象，负责管理 Lens 算法使用的内部资源。调用此 API 时，将通过 backendInterface 结构中的指针进行多次调用。此后端将尝试获取设备功能，并创建 Lens 正常运行所需的内部资源和管线。根据创建 FfxLensContext 时使用的具体配置，可能会通过回调函数请求不同的资源和管线集。

FfxLensContext 应在使用完毕后销毁，通常在应用程序卸载或用户禁用 Lens 缩放功能时。要销毁 Lens 上下文，您应该调用 ffxLensContextDestroy。

参数

pContext (FfxLensContext *) – [输出] 指向要填充的 FfxLensContext 结构的指针。
pContextDescription (const FfxLensContextDescription *) – [输入] 指向 FfxLensContextDescription 结构的指针。

返回： FFX_API FfxErrorCode

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 177 行, 第 22 列)

ffxLensContextDispatch

FFX_API FfxErrorCode ffxLensContextDispatch(FfxLensContext *pContext, const FfxLensDispatchDescription *pDispatchDescription)

调度工作到 FidelityFX Lens 上下文。

参数

pContext (FfxLensContext *) – [输出] 指向要填充的 FfxLensContext 结构的指针。
pDispatchDescription (const FfxLensDispatchDescription *) – [输入] 指向 FfxLensDispatchDescription 结构的指针。

返回： FFX_API FfxErrorCode

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 192 行, 第 22 列)

ffxLensContextDestroy

FFX_API FfxErrorCode ffxLensContextDestroy(FfxLensContext *pContext)

销毁 FidelityFX Lens 上下文。

参数

pContext (FfxLensContext *) – [输出] 指向要销毁的 FfxLensContext 结构的指针。

返回： FFX_API FfxErrorCode

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 204 行, 第 22 列)

ffxLensGetEffectVersion

FFX_API FfxVersionNumber ffxLensGetEffectVersion()

查询效果版本号。

返回: 构建该效果的 SDK 版本。

返回: FFX_API FfxVersionNumber

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 212 行, 第 26 列)

枚举

FfxLensPass

enum FfxLensPass

构成 Lens 算法的通道枚举。

Lens 实现为一个单通道算法。每次调用 FfxLensScheduleGpuJobFunc 回调函数都将对应一个 Lens 效果计算作业。有关 Lens 内部工作原理的更全面描述，请参阅 Lens 参考文档。

值

FFX_LENS_PASS_MAIN_PASS

FFX_LENS_PASS_MAIN_PASS = 0

应用镜头效果的通道。

FFX_LENS_PASS_COUNT

Lens 中的通道数量。

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 75 行, 第 1 列)

FfxLensInitializationFlagBits

enum FfxLensInitializationFlagBits

创建 FfxLensContext 时使用的位标志枚举。请参阅 FfxLensContextDescription。

值

FFX_LENS_MATH_NONPACKED

FFX_LENS_MATH_NONPACKED = (1 <<0)

指示是否使用浮点数学的位。

FFX_LENS_MATH_PACKED

FFX_LENS_MATH_PACKED = (1 <<1)

指示是否使用 16 位半精度浮点数学（首选）的位。

来源: sdk/include/FidelityFX/host/ffx_lens.h (第 92 行, 第 1 列)

依赖项: FfxLensContext, FfxLensContextDescription, FfxLensDispatchDescription