Atlas系列硬件: Atlas 200l DK A2 开发者套件; Atlas 200l DK 开发者套件（型号：3000）; 加速模块、加速卡、智能小站、服务器、集群

异构计算架构: CANN社区版; CANN商用版

AI框架: MindSpore; TensorFlow框架模型（社区版）; TensorFlow框架模型（商用版）; PyTorch框架适配

昇腾推理引擎: MindIE

应用使能MindX: MindX DL; MindX Edge; MindX SDK

全流程开发工具: MindStudio

功能及约束说明

功能说明

叠加在视频上的OSD (On Screen Display)和遮挡在视频上的色块统称为区域。区域管理模块，用于统一管理这些区域资源，用于在视频上显示一些特定信息（如通道号、时间戳等）、或在视频中填充色块用于遮挡。

例如，实际应用中，用户通过创建一个区域，通过调用hi_mpi_rgn_attach_to_chn接口，将该区域叠加到指定的一个或多个VPSS通道中，同时支持在每个通道中指定区域的显示属性，如位置、层次、透明度等。

基本概念

表1 概念解释
概念	描述
区域类型	区域类型包括以下： OVERLAY ：视频叠加区域，其中区域支持位图的加载、背景色更新等功能。 OVERLAYEX ：扩展视频叠加区域，功能与 OVERLAY 类似，支持位图加载、背景色更新等。 COVER ：视频遮挡区域，其中区域支持纯色块遮挡。 COVEREX ：扩展视频遮挡区域，功能与 COVER 类似，支持纯色块遮挡。 LINE ：扩展的线条视频叠加区域，支持颜色、粗细等调节。 MOSAIC：马赛克遮挡区域，支持精度调节。 MOSAICEX：扩展的马赛克遮挡区域，支持精度调节。 CORNER_RECTEX：角框区域，支持大小，颜色，粗细等调节。其中，OVERLAYEX 类型的区域会绑定到VPSS的Channel上；MOSAIC、COVER 类型的区域会绑定到VPSS的Group上。VPSS的Group和Channel区别详见功能说明
区域层次	指区域的叠加级别，层次值越大，表示区域的显示级别越高。当发生重叠时，层次值大的将会覆盖层次值小的。图1 层次叠加示意图
位图填充	指将位图的内存值填充到区域内存空间中，位图将会从区域的左上角开始填充。当位图小于区域时，只能填充一部分内存，剩余部分保持原有值；位图大小等于区域时，将刚好全部填充；当位图大于区域时，位图只能将自身和区域一样大小的内存信息填充到区域中。位图填充仅针对OVERLAYEX区域类型有效。
区域属性	用户创建一个区域时，需要设置该区域的属性信息，包含OVERLAYEX包含像素格式、大小、背景色等。
通道显示属性	指区域在某通道的显示特征。例如，MOSAIC的通道显示属性包含显示位置、区域大小、层次、mosaic块大小。当区域的通道显示属性中的is_show（区域是否显示）为TRUE时，表示区域会显示在该通道中；反之，表示区域在该通道中存在，但处于隐藏状态。

约束说明

表2 region支持的模块信息
类型	支持模块（mod_id）	设备号（dev_id）取值范围	通道号（chn_id）取值范围
OVERLAY	当前不支持	-	-
COVER	VPSS（HI_ID_VPSS）	VPSS Group ID取值范围：[0,255]	0
OVERLAYEX	VPSS（HI_ID_VPSS）	VPSS Group ID取值范围：[0,255]	[0,1]
COVEREX	当前不支持	-	-
LINE	当前不支持	-	-
MOSAIC	VPSS（HI_ID_VPSS）	VPSS Group ID取值范围：[0,255]	0
MOSAICEX	当前不支持	-	-
CORNER_RECTEX	当前不支持	-	-

父主题： Region区域管理