# xeg_gles_temporal_upscale.h

#### 概述

XEngine时域AI超分特性OpenGL ES接口。推荐超分倍率为\[1.25, 2.0\]，使用此头文件中的接口前需要通过HMS\_XEG\_GetString接口查询XEG\_TEMPORAL\_UPSCALE\_EXTENSION\_NAME扩展可用。

**引用文件**：<xengine/xeg\_gles\_temporal\_upscale.h>

**库：** libxengine.so

**系统能力：** SystemCapability.Graphic.XEngine

**起始版本：** 6.0.0(20)

**相关模块：** XEngine

#### 汇总

#### 宏定义

| 名称 | 描述 |
| --- | --- |
| XEG_TEMPORAL_UPSCALE_INPUT_SIZE 0x1U | 用于通过HMS_XEG_TemporalUpscaleParameter接口设置超分输入纹理的真实宽高。 |
| XEG_TEMPORAL_UPSCALE_JITTER_NUM 0x2U | 用于通过HMS_XEG_TemporalUpscaleParameter接口设置相机抖动的周期数，取值范围为[4, 16]，推荐8。 |
| XEG_TEMPORAL_UPSCALE_DEPTH_REVERSED 0x3U | 用于通过HMS_XEG_TemporalUpscaleParameter接口设置是否存在深度反转。true表示存在深度反转，false表示不存在深度反转。 |
| XEG_TEMPORAL_UPSCALE_RESET_HISTORY 0x4U | 用于通过HMS_XEG_TemporalUpscaleParameter接口设置是否重置历史帧数据，true表示重置，false表示不重置。在历史帧未使用超分，并且当前帧开始使用超分的情况下建议设置为true。 |
| XEG_TEMPORAL_UPSCALE_STEADY_LEVEL 0x5U | 用于通过HMS_XEG_TemporalUpscaleParameter接口设置画面偏向当前帧（鬼影少但可能存在闪烁）还是历史帧（鬼影多但是更稳定）的平衡程度。取值范围为[0.0, 1.0]，值越大越偏向历史帧。 |

#### 类型定义

| 名称 | 描述 |
| --- | --- |
| typedef void(GL_APIENTRYP PFN_HMS_XEG_TemporalUpscaleParameter) (GLenum pname, GLvoid *param) | 设置时域AI超分输入参数的函数指针定义。 |
| typedef void(GL_APIENTRYP PFN_HMS_XEG_RenderTemporalUpscale) (GLuint inputTexture, GLuint depthTexture, GLuint motionVectorTexture, GLuint dynamicMaskTexture, GLfloat jitterX, GLfloat jitterY) | 执行时域AI超分渲染命令的函数指针定义。 |

#### 函数

| 名称 | 描述 |
| --- | --- |
| GL_APICALL void GL_APIENTRY HMS_XEG_TemporalUpscaleParameter (GLenum pname, const GLvoid *param) | 设置时域AI超分输入参数。 |
| GL_APICALL void GL_APIENTRY HMS_XEG_RenderTemporalUpscale (GLuint inputTexture, GLuint depthTexture, GLuint motionVectorTexture, GLuint dynamicMaskTexture, GLfloat jitterX, GLfloat jitterY) | 执行时域AI超分渲染命令。 |