hi_mpi_rgn_set_display_attr
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 | 输入 | 区域通道显示属性指针,不能为空。 |
返回值说明
- 0:获取数据成功
- 非0:失败,参见19.18.5-区域管理返回码
参考资源
接口调用流程,参见视频解码、处理和显示功能(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支持的模块信息。 |
返回值说明
- 0:获取数据成功
- 非0:失败,参见19.18.5-区域管理返回码
参考资源
接口调用流程,参见视频解码、处理和显示功能(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 | 输入 | 区域通道显示属性指针,不能为空。 其中,静态属性不能修改,动态属性可以被修改。 |
返回值说明
- 0:获取数据成功
- 非0:失败,参见19.18.5-区域管理返回码
参考资源
接口调用流程,参见视频解码、处理和显示功能(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 | 输出 | 区域通道显示属性指针,不能为空。 |
返回值说明
- 0:获取数据成功
- 非0:失败,参见19.18.5-区域管理返回码
参考资源
接口调用流程,参见视频解码、处理和显示功能(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 | 输出 | 区域显示画布信息。 |
返回值说明
- 0:获取数据成功
- 非0:失败,参见19.18.5-区域管理返回码
参考资源
接口调用流程,参见视频解码、处理和显示功能(NVR场景)。
父主题: Region区域管理
hi_mpi_rgn_update_canvas
函数功能
更新显示画布。
约束说明
- 区域必须已创建。
- 本接口配合hi_mpi_rgn_get_canvas_info使用 。 主要用于画布内存数据更新之后,进行画布切换显示。
- 每次调用本接口前,都必须先获取画布信息,然后在调用本接口进行更新。
- 本接口仅支持OVERLAYEX类型的区域 。
函数原型
hi_s32 hi_mpi_rgn_update_canvas(hi_rgn_handle handle)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| handle | 输入 | 区域句柄号。 取值范围:[0, 1024)。 |
返回值说明
- 0:获取数据成功
- 非0:失败,参见19.18.5-区域管理返回码
参考资源
接口调用流程,参见视频解码、处理和显示功能(NVR场景)。
父主题: Region区域管理
在线提单