海思OSD实现

一、OSD概述

用户一般都需要在视频中叠加 OSD 用于显示一些特定的信息（如：通道号、时间戳等），必要时还会填充色块。这些叠加在视频上的 OSD 和遮挡在视频上的色块统称为区域。REGION 模块，用于统一管理这些区域资源。

重要概念：

1.区域类型：

− Overlay：视频叠加区域，其中区域支持位图的加载、背景色更新等功能。
− OverlayEx：扩展视频叠加区域，功能与 Overlay 类似，支持位图加载、背景色
更新等。
− Cover：视频遮挡区域，其中区域支持纯色块遮挡。
− CoverEx：扩展视频遮挡区域，功能与 Cover 类似，支持纯色块遮挡。
− OverlayEx/ CoverEx，分别相对于 Overlay/Cover，功能上类似，但是会引入额
外的系统带宽，OverlayEx/ CoverEx 由 VGS 叠加到图像上 ，OverlayEx/
CoverEx 区域越大，占用 VGS 的性能就越大，当 VGS 性能不足时，会导致帧
率降低。建议只有当 Overlay/Cover 不支持，或者数量无法满足需求时，再使
用。
− Mosaic：马赛克遮挡区域，支持精度调节。

2.区域层次

区域层次表示区域的叠加级别，层次值越大，表示区域的显示级别越高。当发生重叠时，层次值大的将会覆盖层次值小的。

3.位图填充（针对 Overlay 和 OverlayEx 有效）

位图填充是指将位图的内存值填充到区域内存空间中，位图将会从区域的左上角
开始填充。当位图小于区域时，只能填充一部分内存，剩余部分保持原有值；位
图大小等于区域时，将刚好全部填充；当位图大于区域时，位图只能将自身和区
域一样大小的内存信息填充到区域中。
位图填充支持两种实现方式：其一、用户通过 HI_MPI_RGN_SetBitMap 接口将位
图数据拷贝至内部显示画布；其二、用户通过 HI_MPI_RGN_GetCanvasInfo 获取
内部备份显示画布的地址，直接对该地址数据进行更新，然后调用
HI_MPI_RGN_UpdateCanvas 接口将备份显示画布更新为待显示画布，达到实现更
新位图数据的目的

4.区域公共属性

用户创建一个区域时，需要设置该属性信息，它包含公共的资源信息。例如，
Overlay 包含像素格式，大小和背景色。

5.通道显示属性(RGN_CHN_ATTR_S)

通道显示属性表明区域在某通道的显示特征。例如，Overlay 的通道显示属性包含显示位置，层次，前景 Alpha，背景 Alpha，还有编码用到的 QP 信息。当通道显示属性中的区域是否显示(bShow)为 TRUE 时，表示显示在该通道中；反之，表示在该通道中存在，但处于隐藏状态。

6.区域反色

当区域叠加到视频上显示时，如果视频背景与叠加区域的亮度色度相近，往往会导致背景与区域很难进行区分。区域反色功能即针对这种场景，自适应背景的变化，对区域的亮度色度进行调整，实现区域清晰可见。
区域反色功能支持实现方式如下：通过 VPSS 提供的区域亮度和统计功能。用户可实时获取视频序列中每个待叠加区域背景的亮度统计，然后利用 VGS 对区域进行手动的反色处理，最后通过 VGS 将该反色后的区域叠加到视频上。

7.Hi3519AV100 region支持的模块信息

二、使用示意：

使用过程包含以下步骤：

1.用户填充区域属性并创建区域。
2.将该区域指定到具体通道中(如 VENC)。在指定到具体通道时，需要输入通道的显
示属性。

以上步骤完成区域的创建和使用。用户还可以通过以下操作来控制区域属性以及在某
通道的通道显示属性。

1.通过 HI_MPI_RGN_GetAttr、HI_MPI_RGN_SetAttr 获取和设置区域属性。
2.通过 HI_MPI_RGN_SetBitMap(仅针对 Overlay、Overlayex)设置区域的位图信息。
3.通过 HI_MPI_RGN_GetDisplayAttr 和 HI_MPI_RGN_SetDisplayAttr 获取和设置区
域在某通道（如 VENC 通道）的通道显示属性。
4.最后用户可以将该区域从通道中撤出（非必须操作），再销毁区域。

三、API参考：

HI_MPI_RGN_Create：创建区域。
HI_MPI_RGN_Destroy：销毁区域。
HI_MPI_RGN_GetAttr：获取区域属性
HI_MPI_RGN_SetAttr：设置区域属性。
HI_MPI_RGN_SetBitMap：设置区域位图。
HI_MPI_RGN_AttachToChn：将区域叠加到通道上。
HI_MPI_RGN_DetachFromChn：将区域从通道中撤出。
HI_MPI_RGN_SetDisplayAttr：设置区域的通道显示属性。
HI_MPI_RGN_GetDisplayAttr：获取区域的通道显示属性。
HI_MPI_RGN_GetCanvasInfo：获取区域画布信息。
HI_MPI_RGN_UpdateCanvas：更新区域画布信息。
HI_MPI_RGN_BatchBegin：设置区域批处理。
HI_MPI_RGN_BatchEnd：区域批处理信息同步。
HI_MPI_RGN_GetFd：获取区域管理模块文件描述符。