Skip to main content

hi_mpi_rgn_detach_from_chn

hi_mpi_rgn_create​

函数功能​

创建不同类型的区域。

约束说明​

  • 不支持重复创建。
  • 创建区域时，本接口只进行基本的参数的检查，譬如：最小宽高，最大宽高等；当调用hi_mpi_rgn_attach_to_chn接口将区域叠加到通道上时，根据各通道模块支持类型的约束条件进行更加有针对性的参数检查，譬如支持的像素格式等。

函数原型​

hi_s32 hi_mpi_rgn_create(hi_rgn_handle handle, const hi_rgn_attr *rgn_attr)

参数说明​

参数名输入/输出说明
handle输入区域句柄号。 必须是未使用的handle号，由用户指定，意义等同于ID号。 取值范围：[0, 1024)。
rgn_attr输入区域属性指针，不能为空。 当前仅支持创建COVER、MOSAIC、OVERLAYEX类型的区域。其它区域属性，如区域位置、层次等，需调用hi_mpi_rgn_attach_to_chn接口时指定。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

hi_mpi_rgn_destroy​

函数功能​

销毁区域。

约束说明​

区域必须已创建。

函数原型​

hi_s32 hi_mpi_rgn_destroy(hi_rgn_handle handle)

参数说明​

参数名输入/输出说明
handle输入区域句柄号。 取值范围：[0, 1024)。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

hi_mpi_rgn_attach_to_chn​

函数功能​

将区域叠加到通道上。

约束说明​

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

函数原型​

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输入区域通道显示属性指针，不能为空。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

hi_mpi_rgn_detach_from_chn​

函数功能​

从通道中删除叠加区域。

约束说明​

  • 区域必须已创建。
  • 支持多次调用本接口。

函数原型​

hi_s32 hi_mpi_rgn_detach_from_chn(hi_rgn_handle handle, const hi_mpp_chn *chn)

参数说明​

参数名输入/输出说明
handle输入区域句柄号。 取值范围：[0, 1024)。
chn输入通道结构体指针，不能为空。 该参数的详细配置请参见表2 region支持的模块信息。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

hi_mpi_rgn_set_display_attr​

函数功能​

设置区域的通道显示属性。

约束说明​

  • 区域必须已创建。
  • 建议先获取属性，再设置。
  • 必须先调用hi_mpi_rgn_attach_to_chn接口将区域叠加到通道上。

函数原型​

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

参数说明​

参数名输入/输出说明
handle输入区域句柄号。 取值范围：[0, 1024)。
chn输入通道结构体指针，不能为空。 该参数的详细配置请参见表2 region支持的模块信息。
chn_attr输入区域通道显示属性指针，不能为空。 其中，静态属性不能修改，动态属性可以被修改。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

hi_mpi_rgn_get_display_attr​

函数功能​

获取区域的通道显示属性。

约束说明​

区域必须已创建。

函数原型​

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

参数说明​

参数名输入/输出说明
handle输入区域句柄号。 取值范围：[0, 1024)。
chn输入通道结构体指针，不能为空。 该参数的详细配置请参见表2 region支持的模块信息。
chn_attr输出区域通道显示属性指针，不能为空。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

hi_mpi_rgn_get_canvas_info​

函数功能​

获取区域的显示画布信息。

约束说明​

  • 区域必须已创建。
  • 主要用于OVERLAYEX类型导入位图数据 。
  • 本接口用于获取区域对应的画布信息， 在得到画布地址之后，用户可直接对画布进行操作，譬如：将bmp数据直接填写到该画布中。 然后通过调用hi_mpi_rgn_update_canvas接口更新显示画布数据。

函数原型​

hi_s32 hi_mpi_rgn_get_canvas_info(hi_rgn_handle handle, hi_rgn_canvas_info *canvas_info)

参数说明​

参数名输入/输出说明
handle输入区域句柄号。 取值范围：[0, 1024)。
canvas_info输出区域显示画布信息。

返回值说明​

参考资源​

接口调用流程，参见视频解码、处理和显示功能（NVR场景）。

父主题： Region区域管理

在线提单