vdec_set_display_mode

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	x
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	x
Atlas 训练系列产品	x
Atlas 推理系列产品	x
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	x

本接口不支持设置显示模式，默认为回放模式。

C函数原型

hi_s32 hi_mpi_vdec_set_display_mode(hi_vdec_chn chn, hi_video_display_mode display_mode)

python函数

ret = acl.himpi.vdec_set_display_mode(chn, display_mode)

参数名	说明
chn	int，解码通道号。 Atlas 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256。 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。 Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。 Atlas A3 训练系列产品/Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。
display_mode	int，显示模式，参考hi_video_display_mode。

参数名

说明

chn

int，解码通道号。

Atlas 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256。
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。
Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
Atlas A3 训练系列产品/Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。

display_mode

int，显示模式，参考hi_video_display_mode。

返回值	说明
ret	int。 0：成功非0：失败，参见公共返回码、VDEC视频/JPEGD图像解码返回码。

设置显示模式前必须保证通道已创建，否则会返回通道未创建的错误码HI_ERR_VDEC_UNEXIT。
预览模式（HI_VIDEO_DISPLAY_MODE_PREVIEW）：预览模式下VDEC绑定的直接后级模块（比如 VPSS）以非阻塞方式接收解码图像，即当VPSS的图像Buffer满时（解码帧存个数比 VPSS 缓存队列个数多）， VPSS丢弃VDEC发送过来的图像，以达到不反压VDEC 解码的目的，实现实时预览。需要注意的是，当解码帧存个数比VPSS缓存队列个数少时，即使开启预览模式， VPSS还是会反压解码。
回放模式（HI_VIDEO_DISPLAY_MODE_PLAYBACK）：回放模式下VDEC绑定的直接后级模块（比如 VPSS）以阻塞方式接收解码图像，即当VPSS的图像Buffer满时，拒绝接收VDEC发送过来的图像， VDEC发现当前图像发送失败后启动图像重新发送机制，直到图像发送成功为止。回放模式下VDEC绑定的直接后级模块能够反压VDE 解码，以达到不丢弃任何一帧解码图像的回放效果。

父主题： VDEC视频解码/JPEGD图像解码接口