mfxExtEncoderROI

Definition

 

 

typedef struct {

    mfxExtBuffer    Header;

 

    mfxU16  NumROI;

    mfxU16  reserved1[11];

 

    struct  {

        mfxU32  Left;

        mfxU32  Top;

        mfxU32  Right;

        mfxU32  Bottom;

 

        mfxI16  Priority;

        mfxU16  reserved2[7];

    } ROI[256];

} mfxExtEncoderROI;

 

Description

 

 

The mfxExtEncoderROI structure is used by the application to specify different Region Of Interests during encoding. It may be used at initialization or at runtime.

 

Members

 

 

Header.BufferId

Must be MFX_EXTBUFF_ENCODER_ROI

 

 

NumROI

Number of ROI descriptions in array. The Query function mode 2 returns maximum supported value (set it to 256 and Query will update it to maximum supported value).

 

 

ROI

Array of ROIs. Different ROI may overlap each other. If macroblock belongs to several ROI, Priority from ROI with lowest index is used.

 

 

      Left,      Top,      Right,      Bottom

ROI location. Should be aligned to MB boundaries (should be dividable by 16). If not, the SDK encoder truncates it to MB boundaries, for example, both 17 and 31 will be truncated to 16.

 

 

      Priority

Priority of ROI.

For VBR, CBR and AVBR modes, this is relative priority of the region in the -3…3 range. Bigger value produces better quality.

For CQP mode, this is absolute value in the -51…51 range, that will be added to the MB QP. Lesser value produces better quality.

 

Change History

 

This structure is available since SDK API 1.8.

 

 

For more complete information about compiler optimizations, see our Optimization Notice.