acl.himpi.venc_set_h264_vui

hi_s32 hi_mpi_venc_set_h264_vui(hi_venc_chn chn, const hi_venc_h264_vui *h264_vui)

ret = acl.himpi.venc_set_h264_vui(chn, h264_vui)

设置H.264协议编码通道的Vui参数。

Vui（Video usability information）参数主要包含解码图像的格式信息，比如采样横纵比、光电转换特性、颜色空间等。Vui参数在协议中属于可选参数，不影响视频解码过程，但会建议解码器做一些矫正处理。

Atlas 200/300/500 推理产品，不支持该接口。

Atlas 训练系列产品，不支持该接口。

Atlas A2训练系列产品，不支持该接口。

• chn：int, 编码通道号。

  编码通道号的取值范围：[0, 256)，JPEGE功能和VENC功能共用通道，且通道总数最多256。

• h264_vui：dict，H.264协议编码通道的Vui参数字典。具体请参见hi_venc_h264_vui。

ret：int，错误码。

• 返回0表示成功。
• 返回非0表示失败，参见VENC视频/JPEGE图像编码返回码。

• 本接口用于设置H.264协议编码通道的Vui配置。

• 本接口在编码通道创建之后，编码通道销毁之前设置。此接口在编码过程中被调用时，等到下一个I帧时生效。

• 建议用户在创建通道之后，启动编码之前调用此接口，减少在编码过程中调用的次数。
• 用户应当仅在H.264协议编码通道中调用本接口。

• 目前仅开放hi_venc_h264_vui中的hi_venc_vui_video_signal参数供用户配置，其它参数预留，均需配置为默认值，否则会导致编码失败。建议用户在调用此接口之前先调用acl.himpi.venc_get_h264_vui接口，获取当前编码通道的Vui默认配置，然后再进行设置，避免预留参数出错。