FidelityFX Cas

FidelityFX 对比度自适应锐化运行时库。

Defines

FFX_CAS_VERSION_MAJOR

#define FFX_CAS_VERSION_MAJOR (1)

对比度自适应锐化主版本号。

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 38 行，第 9 列)

FFX_CAS_VERSION_MINOR

#define FFX_CAS_VERSION_MINOR (2)

对比度自适应锐化次版本号。

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 43 行，第 9 列)

FFX_CAS_VERSION_PATCH

#define FFX_CAS_VERSION_PATCH (0)

对比度自适应锐化补丁版本号。

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 48 行，第 9 列)

FFX_CAS_CONTEXT_COUNT

#define FFX_CAS_CONTEXT_COUNT 1

FidelityFX CAS 上下文计数。

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

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 55 行，第 9 列)

FFX_CAS_CONTEXT_SIZE

#define FFX_CAS_CONTEXT_SIZE (9206)

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

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 60 行，第 9 列)

函数

ffxCasContextCreate

FFX_API FfxErrorCode ffxCasContextCreate(FfxCasContext *pContext, const FfxCasContextDescription *pContextDescription)

根据 FfxCasContextDescription 结构体中设置的参数创建一个 FidelityFX CAS 上下文。

上下文结构是与 CAS 交互的主要对象，负责管理 CAS 算法使用的内部资源。调用此 API 时，将通过回调结构中的指针进行多次调用。这些回调将尝试检索 CAS 逐帧功能所需的设备功能和管道。根据创建 FfxCasContext 时使用的配置，可以通过回调函数请求不同的一组管道。

CAS 上下文应在其使用完成后销毁，通常在应用程序卸载或用户禁用 CAS 时。要销毁 CAS 上下文，应调用 ffxCasContextDestroy。

参数

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

返回： FFX_API FfxErrorCode

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 172 行，第 22 列)

ffxCasContextDispatch

FFX_API FfxErrorCode ffxCasContextDispatch(FfxCasContext *pContext, const FfxCasDispatchDescription *pDispatchDescription)

参数

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

返回： FFX_API FfxErrorCode

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 185 行，第 22 列)

ffxCasContextDestroy

FFX_API FfxErrorCode ffxCasContextDestroy(FfxCasContext *pContext)

销毁 FidelityFX CAS 上下文。

参数

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

返回： FFX_API FfxErrorCode

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 197 行，第 22 列)

ffxCasGetEffectVersion

FFX_API FfxVersionNumber ffxCasGetEffectVersion()

查询效果版本号。

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

返回: FFX_API FfxVersionNumber

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 205 行，第 26 列)

枚举

FfxCasPass

enum FfxCasPass

构成 CAS 算法的所有通道的枚举。

CAS 只有一个通道。有关此通道的更详细说明，请参阅 CAS 参考文档。

值

FFX_CAS_PASS_SHARPEN

FFX_CAS_PASS_SHARPEN = 0

一个仅锐化或放大颜色缓冲区的通道。

FFX_CAS_PASS_COUNT

CAS 执行的通道数。

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 72 行，第 1 列)

FfxCasColorSpaceConversion

enum FfxCasColorSpaceConversion

创建 FfxCASContext 时使用的颜色空间转换枚举。请参阅 FfxCASContextDescription。

值

FFX_CAS_COLOR_SPACE_LINEAR

FFX_CAS_COLOR_SPACE_LINEAR = 0

线性颜色空间，不做任何操作。

FFX_CAS_COLOR_SPACE_GAMMA20

FFX_CAS_COLOR_SPACE_GAMMA20 = 1

将 gamma 2.0 转换为线性颜色空间用于输入，并将线性颜色空间转换回 gamma 2.0 用于输出。

FFX_CAS_COLOR_SPACE_GAMMA22

FFX_CAS_COLOR_SPACE_GAMMA22 = 2

将 gamma 2.2 转换为线性颜色空间用于输入，并将线性颜色空间转换回 gamma 2.2 用于输出。

FFX_CAS_COLOR_SPACE_SRGB_OUTPUT

FFX_CAS_COLOR_SPACE_SRGB_OUTPUT = 3

仅对输出进行 sRGB 转换（输入转换将自动进行）。

FFX_CAS_COLOR_SPACE_SRGB_INPUT_OUTPUT

FFX_CAS_COLOR_SPACE_SRGB_INPUT_OUTPUT = 4

将 sRGB 转换为线性颜色空间用于输入，并将线性颜色空间转换回 sRGB 用于输出。

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 83 行，第 1 列)

FfxCasInitializationFlagBits

enum FfxCasInitializationFlagBits

创建 FfxCASContext 时使用的位标志枚举。请参阅 FfxCASContextDescription。

值

FFX_CAS_SHARPEN_ONLY

FFX_CAS_SHARPEN_ONLY = (1 <<0)

指示是否仅进行锐化的标志位。

来源： sdk/include/FidelityFX/host/ffx_cas.h (第 96 行，第 1 列)

依赖项： FfxCasContext, FfxCasContextDescription, FfxCasDispatchDescription