Functions and Restrictions

Functions

The overlaid on screen displays (OSDs) and color blocks in a video are called regions. The Region module is used to manage region resources in a unified manner, and display specific information (such as the channel ID and timestamp) on a video, or fill color blocks in a video for covering.

For example, in practice, you can create a region and overlay the region with one or more specified VPSS channels by calling hi_mpi_rgn_attach_to_chn. In addition, you can specify the display attributes of the region in each channel, such as the position, layer, and transparency.

Basic Concepts

**Table 1** Basic concepts
Term	Description
Region type	The region types are as follows: OVERLAY: video overlay region. It supports bitmap loading and its background color can be refreshed. OVERLAYEX: extended video overlay region. Similar to the video overlay region, the extended video overlay region also supports bitmap loading and its background color can be refreshed. COVER: video cover region. It can be covered by pure color blocks. COVEREX: extended video cover region. Similar to the video cover region, the extended video cover region can also be covered by pure color blocks. LINE: extended line-based video overlay region, supporting the adjustment of the color and thickness. MOSAIC: mosaic region. It supports precision adjustment. MOSAICEX: extended mosaic cover region, supporting precision adjustment. CORNER_RECTEX: cornered rectangle region, supporting size, color, and thickness adjustment. The OVERLAYEX region is bound to the VPSS channel, and the MOSAIC and COVER regions are bound to the VPSS group. For details about the differences between VPSS groups and channels, see Functions.
Region level	Refers to the overlay level. A higher region level indicates a higher region display level. When regions are overlaid, the low-level region is overlaid with the high-level region. Figure 1 Region overlaying
Bitmap filling	Indicates that the memory value of a bitmap is filled in the region memory from the upper left corner of the region. When the bitmap size is smaller than the region size, a part of memory is filled, and the remaining part is retained. When the sizes of the bitmap and region are the same, the region memory is filled completely. When the bitmap size is greater than the region size, the region memory is filled with the information of the bitmap size. Bitmap filling is valid only for OVERLAYEX regions.
Region attribute	After creating a region, you need to set its attributes, including OVERLAYEX information such as pixel format, size, and background color.
Channel display attribute	Indicates the region display features in a channel. For example, the mosaic channel display attributes include the display position, region size, layer, and mosaic block size. If is_show (indicating whether a region is displayed) in the channel display attributes of a region is TRUE, the region is displayed in the channel. Otherwise, the region exists in the channel but is hidden.

Restrictions

**Table 2** Modules supported by regions
Type	Supported Module (mod_id)	Device ID (dev_id) Value Range	Channel ID (chn_id) Value Range
OVERLAY	Not supported	-	-
COVER	VPSS (HI_ID_VPSS)	Value range of the VPSS group ID: [0,255]	0
OVERLAYEX	VPSS (HI_ID_VPSS)	Value range of the VPSS group ID: [0,255]	[0,1]
COVEREX	Not supported	-	-
LINE	Not supported	-	-
MOSAIC	VPSS (HI_ID_VPSS)	Value range of the VPSS group ID: [0,255]	0
MOSAICEX	Not supported	-	-
CORNER_RECTEX	Not supported	-	-

Parent topic: Region Management