Region Of Interest File Format - Region Of Interest File Format - 3.0 English - PG447

H.264/H.265/JPEG Video Codec Unit 2 (VCU2) Solutions LogiCORE IP Product Guide (PG447)

Document ID
PG447
Release Date
2026-03-06
Version
3.0 English

File containing the Regions of Interest (ROI) used to encode.

[Settings]
QPCtrlMode = ROI_QP
[INPUT]
ROIFile = <path>

The ROI definition starts with a line specifying the frame identifier, the background quality, and an ROI order (in case of overlapping regions), followed by one or more lines each defining a ROI for this frame and the following frames until the next ROI definition.

frame<index>:[BkgQuality=<quality>, Order=<order>]? <posX>:<posY>, <width>x<height>, <quality> 

Position and width and height are in pixels and are automatically rounded to the bounding LCU units. <quality> is defined as such:

Table 1. Quality Settings ROI File
Quality Description
HIGH_QUALITY Higher quality than the rate-control given value
MEDIUM_QUALITY Same quality as the rate-control given value
LOW_QUALITY Lower quality than the rate-control given value
NO_QUALITY Worse possible quality for region without interest
STATIC_QUALITY Region with static content (that is, exactly same content as in the reference picture)
INTRA_QUALITY Region all LCU encoded with Intra prediction mode
QUALITY_ORDER Use quality of the region having the best quality
INCOMING_ORDER Use quality of the earliest defined region

Following is an example:

frame0: BkgQuality=STATIC_QUALITY, Order=QUALITY_ORDER
100:52, 8x4, HIGH_QUALITY
144:86, 5x5, LOW_QUALITY
frame13:
12:8, 7x5, HIGH_QUALITY
14:8, 5x5, STATIC_QUALITY