---
title: 功能及约束说明
description: "叠加在视频上的OSD (On Screen Display)和遮挡在视频上的色块统称为区域。区域管理模块，用于统一管理这些区域资源，用于在视频上显示一些特定信息（如通道号、时间戳等）、或在视频中填充色块用于遮挡。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0872.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0872.html
indexId: 434779b1096a626b71044f8170b593e87de77149804eb0c25bdf40c5d5480516105
---
# 功能及约束说明

#### 功能说明

叠加在视频上的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 | 当前不支持 | \- | \- |