RoiRegion

A single rectangular region of interest in normalised [0, 1] coordinates relative to the frame’s own width / height. q_offset follows the FFmpeg AVRegionOfInterest convention: -1.0 = best possible quality, +1.0 = worst, 0.0 = no change.

Field

Type

Repeated

Description

left

float

top

float

right

float

bottom

float

q_offset

float

Member of

Message

Description

RoiMetadata

Region-of-interest metadata to attach to raw video frames. An empty regions list is the "no ROI" state — semantically equivalent to clearing the override.