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)

Obtains the ROI attributes of an H.264/H.265 channel. For details about the ROI encoding function, see ROI Encoding Function.

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

idx: int, index of the ROI for an H.264/H.265 encoding channel.

roi_attr: dict, ROI parameter dictionary. For details, see hi_venc_roi_attr.

• This API is used to obtain the configuration of an ROI with a specified index in an H.264/H.265 encoding channel.

• This API must be called after an encoding channel is created and before the channel is destroyed.

• It is recommended that this API be called after an encoding channel is created and before encoding is started, to reduce the number of the API calls during encoding.