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，编码通道号。
  • Atlas 推理系列产品，编码通道号的取值范围：[0, 256)，JPEGE功能和VENC功能共用通道，且通道总数最多256。
  • Atlas A2训练系列产品，编码通道号的取值范围：[0, 256)，JPEGE功能通道总数最多256。
  • Atlas 200/500 A2推理产品，编码通道号的取值范围：[0, 128)，JPEGE功能和VENC功能共用通道，且通道总数最多128。
• 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默认配置，然后再进行设置，避免预留参数出错。
• hi_venc_vui_h264_time_info包含时钟计数相关参数，默认情况下为不生效状态，用户想要控制显示帧率时需要主动配置相关参数。注意，显示帧率只影响播放器的播放速度，若用户想设置编码过程中的码控帧率需配置acl.himpi.venc_create_chn接口中的输入/输出帧率参数。

  建议用户将码控帧率与显示帧率设置一致，否则播放时的码率可能与用户设置的编码码率不同，播放时的码率会随着所设置的显示帧率而变化。

  如果用户需要调整播放速度，则建议在合理范围内调整显示帧率，一般正常视频播放速度为30fps，表示显示帧率为30fps。

  • 若将显示帧率调大，则播放速度加快，例如3倍速播放，则显示帧率设置为90fps。
  • 若将显示帧率调小，则播放速度减慢，例如0.5倍速播放，则显示帧率设置为15fps。
• 由于Vui只是协议可选参数而非强制参数，调用本接口设置参数（如显示帧率、像素值域范围等）的最终效果取决于解码器/播放器行为，或者用户自定义的解码/播放行为。