venc_set_roi_attr

hi_s32 hi_mpi_venc_set_roi_attr(hi_venc_chn chn, const hi_venc_roi_attr *roi_attr)

ret = acl.himpi.venc_set_roi_attr(chn, roi_attr)

设置H.264/H.265通道的ROI属性，用户可以通过配置ROI区域，对该区域的图像QP进行限制，从而实现图像中该区域的QP与其他图像区域的差异化。关于ROI编码功能的详细说明请参见ROI编码功能说明。

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

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

Atlas A2训练系列产品/Atlas 800I A2推理产品，不支持该接口。

chn：int，编码通道号。

• Atlas 推理系列产品，编码通道号的取值范围：[0, 256)，JPEGE功能和VENC功能共用通道，且通道总数最多256。
• Atlas 200I/500 A2推理产品，编码通道号的取值范围：[0, 128)，JPEGE功能和VENC功能共用通道，且通道总数最多128。

roi_attr：dict，ROI区域参数字典。参见hi_venc_roi_attr。

ret：int，错误码。

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

• 本接口用于设置H.264/H.265通道的ROI属性。

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

• 建议用户在创建通道之后，启动编码之前调用此接口，减少在编码过程中调用的次数。

• 建议用户在调用此接口之前先调用acl.himpi.venc_get_roi_attr接口，获取当前通道的ROI配置，然后再进行设置。
• 设置该接口后，如果当前帧判断编码为pskip帧，以pskip帧效果优先。
• 设置该接口后，可能会出现感兴趣区域QP值不全为设置值的现象，这是因为在编码过程中，有些编码块的残差会为0，没有数据需要被量化，QP值不生效所致，属于正常现象，不影响编码效果。