Skip to main content

hi_mpi_rgn_get_canvas_info

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区域管理

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)。

返回值说明​

参考资源​

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

父主题： Region区域管理

功能说明​

VPSS模块接收VI/VDEC模块发送过来的图像，可对图像进行抠图、缩放、鱼眼矫正等处理，并实现同源输出两路不同分辨率的图像数据用于编码、预览或抓拍。

用户可调用hi_mpi_sys_bind接口，将VI/VDEC的视频流绑定到VPSS上，送给VPSS做进一步的处理，VPSS通过组Group以及组上的通道Channel来提供对应的处理能力，最终将图像输出给用户或下级模块(例如VO)。

图1 功能框图

VPSS相关概念说明如下：

  • Group

    VPSS对用户提供组（ Group ）的概念，各个组通过分时复用方式共享VPSS硬件资源。

  • Channel

    VPSS组的通道，一个VPSS组提供多个通道，每个通道具有独立的缩放、鱼眼矫正等功能。

  • FRC（Frame Rate Control）

    帧率控制，按控制点分为组帧率控制和通道帧率控制。

    • 组帧率控制，在hi_mpi_vpss_create_grp创建组时，可通过帧率控制属性控制各个Group对输入图像的接收。
    • 通道帧率控制，在hi_mpi_vpss_set_chn_attr设置组通道属性时，可通过帧率控制属性控制各个通道图像的处理。

  • CROP

    从图像中裁剪指定区域。

  • 3DNR（Three-dimensional Noise Reduction）

    3D去噪。通过参数配置，把图像中的高斯噪声去除，使得图像变得平滑，有助于降低编码码率。

  • Mosaic

    马赛克，对 VPSS 输出图像在指定区域填充马赛克块。该功能需要配合区域管理功能一起使用。

  • Cover

    视频遮挡区域，对 VPSS的输出图像填充纯色块。 该功能需要配合区域管理功能一起使用。

    遮挡区域坐标类型分为绝对坐标遮挡和相对坐标比例遮挡。

  • Aspect Ratio

    幅形比，指定输出画面相对于输入画面的宽高纵横比。

  • OverlayEx

    视频叠加区域，对 VPSS物理通道的输出图像叠加位图。该功能需要配合区域管理功能一起使用。

  • FISHEYE

    鱼眼矫正功能。

  • Scale

    缩放，对图像进行缩小放大 。 缩放倍数指水平、垂直各缩放多少倍。

父主题： VPSS视频处理功能

在线提单