Skip to main content

hi_mpi_vpss_release_chn_frame

hi_mpi_vpss_enable_chn​

函数功能​

启用VPSS通道。

约束说明​

函数原型​

hi_s32 hi_mpi_vpss_enable_chn(****hi_vpss_grp grp, hi_vpss_chn chn);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。如果通过hi_mpi_vpss_create_grp接口的hi_vpss_grp_attr.nr_en参数开启3DNR功能，则VPSS组ID的取值范围为：[256, 264)。
chn输入VPSS 通道号。 取值范围：[0, 2)

返回值说明​

参考资源​

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

父主题： VPSS视频处理功能

hi_mpi_vpss_disable_chn​

函数功能​

禁用VPSS通道。

约束说明​

  • 调用本接口重复禁用同一个通道返回成功
  • VPSS组必须已创建，请参见hi_mpi_vpss_create_grp接口。

函数原型​

hi_s32 hi_mpi_vpss_disable_chn(****hi_vpss_grp grp, hi_vpss_chn chn);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。如果通过hi_mpi_vpss_create_grp接口的hi_vpss_grp_attr.nr_en参数开启3DNR功能，则VPSS组ID的取值范围为：[256, 264)。
chn输入VPSS 通道号。 取值范围：[0, 2)

返回值说明​

参考资源​

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

父主题： VPSS视频处理功能

hi_mpi_vpss_get_chn_frame​

函数功能​

用户从通道获取一帧处理完成的图像。

约束说明​

  • VPSS组必须已创建，请参见hi_mpi_vpss_create_grp接口。

  • 只有在通过hi_mpi_vpss_get_chn_attr接口设置为USER模式下，并且队列深度不为0，才能获取到图像。

  • 调用该接口获取图像，不会对后端绑定的模块有影响。如后端绑定VO显示，可以在显示过程中获取图像，VO仍正常显示，不会受到影响。

  • 解码回放场景，由于不允许出现丢帧，VPSS只要有一个通道不处理新图像（通道已开启），则整个VPSS不处理新图像。例如说开启了通道0和通道1，两者都不绑定后端，通道图像队列长度都设为2，此时从通道0中最多获取出2帧已缓存的图像，因为通道1缓存2帧后未处理新图像，所以VPSS不会再处理新图像。

函数原型​

hi_s32 hi_mpi_vpss_get_chn_frame(****hi_vpss_grp grp, hi_vpss_chn chn, hi_video_frame_info *frame_info, hi_s32 milli_sec);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。如果通过hi_mpi_vpss_create_grp接口的hi_vpss_grp_attr.nr_en参数开启3DNR功能，则VPSS组ID的取值范围为：[256, 264)。
chn输入VPSS通道号。 取值范围：[0, 2)
frame_info输出图像信息。
milli_sec输入超时时间。 取值范围：
- -1：表示阻塞模式，程序一直等待，直到获取到图像才返回；
- 0：表示非阻塞模式；
- >0： 配置具体的超时时间，单位为毫秒（ms）。在此指定时间内如果没有获取到图像，则超时返回。

返回值说明​

参考资源​

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

父主题： VPSS视频处理功能

hi_mpi_vpss_release_chn_frame​

函数功能​

用户释放一帧通道图像。

约束说明​

调用hi_mpi_vpss_get_chn_frame接口获取到图像数据后，需及时调用本接口释放资源。

函数原型​

hi_s32 hi_mpi_vpss_release_chn_frame(****hi_vpss_grp grp, hi_vpss_chn chn, const hi_video_frame_info *frame_info);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。如果通过hi_mpi_vpss_create_grp接口的hi_vpss_grp_attr.nr_en参数开启3DNR功能，则VPSS组ID的取值范围为：[256, 264)。
chn输入VPSS 通道号。 取值范围：[0, 2)
frame_info输入图像信息。

返回值说明​

参考资源​

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

父主题： VPSS视频处理功能

hi_mpi_vpss_set_chn_fisheye​

函数功能​

设置VPSS物理通道鱼眼属性。

约束说明​

  • VPSS组必须已创建，请参见hi_mpi_vpss_create_grp接口。

  • 调用本接口配置鱼眼属性前必须先调用hi_mpi_vpss_set_chn_attr接口配置对应物理通道的属性。

  • 物理通道如果需要开启鱼眼矫正，建议在启用通道前配置鱼眼属性。

  • 动态改变鱼眼属性时，鱼眼矫正后的输出图像大小应小于启用通道前配置的大小，如果未进行配置则应小于对应通道的宽高属性

  • 物理通道开启了鱼眼矫正后，不支持动态改变通道Crop属性以及通道宽高属性。

  • 输出图像的非校正区域是随机数据，可能会出现异常图像。

  • 通道输出VIDEO_FORMAT_TILE_16x8格式时，不支持鱼眼。

  • 如果在本接口中，hi_fisheye_attr属性开启了LMF参数功能，则必须调用VPSS的hi_mpi_vpss_set_grp_fisheye_cfg设置LMF（Lens Map Function）参数，否则进行鱼眼处理时会因为获取不到用户配置的LMF参数而报错。

函数原型​

hi_s32 hi_mpi_vpss_set_chn_fisheye(****hi_vpss_grp grp, hi_vpss_chn chn, const hi_fisheye_correction_attr *correction_attr);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。
chn输入VPSS 通道号。 取值范围：[0, 2)。
correction_attr输入VPSS物理通道的鱼眼属性结构体指针。

返回值说明​

参考资源​

接口调用流程，参见视频数据获取和处理功能（Camera场景）。

父主题： VPSS视频处理功能

hi_mpi_vpss_get_chn_fisheye​

函数功能​

获取用户前一次调用hi_mpi_vpss_set_chn_fisheye接口设置的VPSS物理通道鱼眼属性。

约束说明​

  • VPSS组必须已创建，请参见hi_mpi_vpss_create_grp接口。
  • 必须先设置才能获取，否则会获取失败。

函数原型​

hi_s32 hi_mpi_vpss_get_chn_fisheye(hi_vpss_grp grp, hi_vpss_chn chn, hi_fisheye_correction_attr *correction_attr);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。
chn输入VPSS 通道号。 取值范围：[0, 2)。
correction_attr输出VPSS物理通道的鱼眼属性结构体指针。

返回值说明​

父主题： VPSS视频处理功能

hi_mpi_vpss_get_chn_fd​

函数功能​

获取VPSS通道对应的设备文件句柄。

函数原型​

hi_s32 hi_mpi_vpss_get_chn_fd(hi_vpss_grp grp, hi_vpss_chn chn);

参数说明​

参数名输入/输出说明
grp输入VPSS组ID。 取值范围：[0, 264)。如果通过hi_mpi_vpss_create_grp接口的hi_vpss_grp_attr.nr_en参数开启3DNR功能，则VPSS组ID的取值范围为：[256, 264)。
chn输入VPSS 通道号。 取值范围：[0, 2)。

返回值说明​

当大于或等于0时，接口调用成功，返回对应句柄，否则表示接口调用失败。

参考资源​

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

父主题： VPSS视频处理功能

在线提单