3. Region of Interest Settings

3.1. ROIInterfaceDefinition

ROI（Region Of Interest） ： 。

UserCanThroughConfigurationROI ， ofImageQp，ImplementationImagein of 。

H.264andH.265 Support8 ROISettings， 0～7ofROIIndex

ROI canConfiguration Qpand Qp Mode。

QpMode：ROI ofQpisUserSettingsofQpValue。

QpMode：ROI ofQpis Qp onUserSettingsofQp Value。

Precautions

ModenotisFixedQPMode ，ROI canConfiguration。

H.264 ROIEnable ，Macro 。

QPMode is Macro QP，Actual QPandSettings QPcan 。

3.1.1. CVI_VENC_SetRoiAttr

【Description】

SettingsH.264/H.265ChannelofROIAttribute。

【 】

CVI_S32 CVI_VENC_SetRoiAttr(VENC_CHN VeChn, const VENC_ROI_ATTR_S *pstRoiAttr)

【 】

Parameter Name	Description	Input/Output
VeChn	VENC Channel	Input
pstRoiAttr	ROI	Input

【ReturnValue】

ReturnValue	Description
CVI_SUCCESS	Success
0	Failure; the value is an error code

【need 】

• File：cvi_comm_venc.h、cvi_venc.h

• File：libvenc.a

【Note】

• u32Index：Support ChannelcanSettings8 ROI ， 0～7Index ROI ，u32IndexIndicatesUserSettingsofROIofIndex 。 0～7ofROIIndex 。

• bEnable： beforeofROI Enable。

• bAbsQp： beforeofROI Use QPor QPMode。

• s32Qp： bAbsQpisCVI_TRUE ，s32Qpis ROI SettingsofQpValue， bAbsQpisCVI_FALSE ，s32QpIndicates ROI Qp onSettingsofQp Value。

• stRect： beforeofROI of and ofSize。ROI mustinImage 。

• SystemDefault ROI Enable，User mustin Channel after， Channel beforeSettings Interface ROI。 Interfacein in ，etc.tounder 。

• Userin Channel after， before Interface， in in of 。 Userin Interface before， CVI_VENC_GetRoiAttrInterface，Get before ofROIConfigurationafter Settings。

• Settings Interfaceafter，If before ispskip ，withpskip 。

• ModenotisFixedQPMode ，ROI canConfiguration。

• H.264 ROI ，Macro 。

• QpMode is Macro QP，Actual QPandSettings QPcan 。

【Example】

3.1.2. CVI_VENC_GetRoiAttr

【Description】

GetH.264/H.265ChannelofROIAttribute。

【 】

CVI_S32 CVI_VENC_GetRoiAttr(VENC_CHN VeChn, CVI_U32 u32Index, VENC_ROI_ATTR_S *pstRoiAttr);

【 】

Parameter Name	Description	Input/Output
VeChn	VENC Channel	Input
u32Index	ROI Index	Input
pstRoiAttr	ROI	Input

【ReturnValue】

ReturnValue	Description
CVI_SUCCESS	Success
0	Failure; the value is an error code

【need 】

• File：cvi_comm_venc.h、cvi_venc.h

• File：libvenc.a

【Note】

• u32IndexIndexGet ROI Configuration

• User mustin Channel after， Channel beforeSettings Interface

• Userin CVI_VENC_SetRoiAttrInterface before， Interface，Get before ofROIConfigurationafter Settings

【Example】