hi_mpi_vi_get_chn_frame
hi_mpi_vi_set_chn_ldc_attr
函数功能
设置VI镜头畸变校正( LDC )属性。
约束说明
-
调用本接口前,必须先调用hi_mpi_vi_create_pipe接口创建PIPE。
-
必须调用hi_mpi_vi_set_chn_attr接口设置通道属性后,再调用本接口。
函数原型
hi_s32 hi_mpi_vi_set_chn_ldc_attr(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, const hi_vi_ldc_attr *ldc_attr)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | PIPE号。 取值范围:[0, 8) |
| vi_chn | 输入 | VI通道号。 取值范围:[0, 1) |
| ldc_attr | 输入 | LDC属性结构体指针。 |
返回值说明
- 0:成功
- 非0:失败,参见VI视频输入返回码。
父主题: VI视频输入功能
hi_mpi_vi_get_chn_ldc_attr
函数功能
获取VI镜头畸变校正( LDC )属性。
约束说明
- 调用本接口前,必须先调用hi_mpi_vi_create_pipe接口创建PIPE。
函数原型
hi_s32 hi_mpi_vi_get_chn_ldc_attr(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, hi_vi_ldc_attr *ldc_attr)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | PIPE号。 取值范围:[0, 8) |
| vi_chn | 输入 | VI通道号。 取值范围:[0, 1) |
| ldc_attr | 输入&输出 | LDC属性结构体指针。 ldc_attr参数作为输入时,需要指定该参数结构体内的ldc_version,否则会返回报错。 |
返回值说明
- 0:成功
- 非0:失败,参见VI视频输入返回码。
父主题: VI视频输入功能
hi_mpi_vi_get_chn_frame
函数功能
从指定VI通道获取的视频图像信息,图像信息主要包括:图像的宽度、高度、像素格式、时间戳以及YUV各分量的地址等等。
约束说明
-
调用本接口前,必须先调用hi_mpi_vi_create_pipe接口创建PIPE。
-
通道已启用且通道队列深度不为0时,才能调用本接口获取到图像。
-
支持多次获取后再释放,但建议获取和释放接口配对使用。
-
获取的地址信息来自模块内部使用的临时内存,因此使用完之后,必须要调用hi_mpi_vi_release_chn_frame接口释放其内存。
-
用户可结合hi_mpi_vi_get_chn_fd接口,采用select/epoll方式等待可读图像信息,等到有可用的视频输入数据后再通过非阻塞方式使用hi_mpi_vi_get_chn_frame获取图像。
函数原型
hi_s32 hi_mpi_vi_get_chn_frame(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, hi_video_frame_info *frame_info, hi_s32 milli_sec)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | PIPE号。 取值范围:[0, 8) |
| vi_chn | 输入 | VI通道号。 取值范围:[0, 1) |
| frame_info | 输入 | VI帧信息结构体。 |
| milli_sec | 输入 | 超时参数 。取值范围: - -1:表示阻塞模式,程序一直等待,直到获取到图像才返回; - 0:表示非阻塞模式; - >0: 配置具体的超时时间,单位为毫秒(ms),在配置的超时时间内如果没有获取到图像,则超时返回。 |
返回值说明
- 0:成功
- 非0:失败,参见VI视频输入返回码。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: VI视频输入功能
hi_mpi_vi_release_chn_frame
函数功能
释放一帧从VI通道获取的图像。
约束说明
- 本接口需与hi_mpi_vi_get_chn_frame接口配对使用,接口调用次数保持一致,否则返回报错。
- 用户需先调用hi_mpi_vi_get_chn_frame接口获取frame_info,再将获取到的frame_info传入本接口,否则可能造成释放不成功。
函数原型
hi_s32 hi_mpi_vi_release_chn_frame(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, const hi_video_frame_info *frame_info)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | PIPE号。 取值范围:[0, 8) |
| vi_chn | 输入 | VI通道号。 取值范围:[0, 1) |
| frame_info | 输入 | VI帧信息结构体。 |
返回值说明
- 0:成功
- 非0:失败,参见VI视频输入返回码。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: VI视频输入功能
hi_mpi_vi_get_chn_fd
函数功能
获取VI通道文件描述符 。
函数原型
hi_s32 hi_mpi_vi_get_chn_fd(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | PIPE号。 取值范围:[0, 8) |
| vi_chn | 输入 | VI通道号。 取值范围:[0, 1) |
返回值说明
当大于或等于0时,接口调用成功,返回对应句柄,否则表示接口调用失败。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: VI视频输入功能
hi_mpi_vi_set_chn_low_delay_attr
函数功能
设置VI PIPE低延时属性 。
约束说明
-
调用本接口前,必须先调用hi_mpi_vi_create_pipe接口创建PIPE。
-
为确保设置的低延时生效,需:
- 调用hi_mpi_sys_bind接口绑定VI与VPSS。
- 已开启视频防抖(DIS)、镜头畸变校正(LDC)中的任意一个功能或组合功能。
函数原型
hi_s32 hi_mpi_vi_set_chn_low_delay_attr(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, const hi_vi_low_delay_info *delay_info)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | VI PIPE号。 取值范围:[0, 8) |
| vi_chn | 输入 | VI通道号。 取值范围:[0, 1) |
| delay_info | 输入 | 低延时功能参数结构体指针。 |
返回值说明
- 0:成功
- 非0:失败,参见VI视频输入返回码。
父主题: VI视频输入功能
在线提单