acl.himpi.venc_get_roi_attr

hi_s32 hi_mpi_venc_get_roi_attr(hi_venc_chn chn, hi_u32 idx, hi_venc_roi_attr *roi_attr)

roi_attr, ret = acl.himpi.venc_get_roi_attr(chn, idx)

获取H.264/H.265通道的ROI配置属性。关于ROI编码功能的详细说明请参见ROI编码功能说明。

• chn：int，编码通道号。

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

• idx：int，H.264/H.265协议编码通道ROI区域索引。

• roi_attr：dict，ROI区域参数字典。参见hi_venc_roi_attr。
• ret：int，错误码。
  • 返回0表示成功。
  • 返回非0表示失败，参见VENC视频/JPEGE图像编码返回码。

• 本接口用于获取H.264/H.265协议编码通道的指定索引号的ROI配置。

• 本接口在编码通道创建之后，编码通道销毁之前调用。

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