昇腾社区首页
中文
注册

hi_mpi_rgn_attach_to_chn

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

x

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

x

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

x

Atlas 训练系列产品

x

Atlas 200/300/500 推理产品

x

Atlas 200I/500 A2 推理产品 Ascend EP 形态下,不支持使用该接口。

功能说明

将区域叠加到通道上。

函数原型

hi_s32 hi_mpi_rgn_attach_to_chn(hi_rgn_handle handle, const hi_mpp_chn *chn, const hi_rgn_chn_attr *chn_attr)

参数说明

参数名

输入/输出

说明

handle

输入

区域句柄号。

取值范围:[0, 1024)。

chn

输入

通道结构体指针,不能为空。

该参数的详细配置请参见表2 region支持的模块信息

chn_attr

输入

区域通道显示属性指针,不能为空。

返回值说明

约束说明

  • 区域必须已创建。
  • 支持多次调用本接口,但此接口不用于改变hi_mpi_rgn_create接口创建的区域属性。
  • 如果将某个区域重复叠加到指定通道上,接口返回成功,但不会改变之前设置的区域通道显示属性。
  • 最多支持将4个不同的MOSAIC类型的区域绑定到同一个通道上。
  • 最多支持将8个不同的COVER类型的区域绑定到同一个通道上。
  • 最多支持将8个不同的OVERLAYEX类型的区域绑定到同一个通道上。

参考资源

接口调用流程,参见NVR场景视频解码、处理和显示