跳到主要内容

hi_mpi_sys_close_epoll

hi_mpi_sys_ctl_epoll​

函数功能​

在媒体数据处理Epoll实例中，对对应的媒体数据处理通道进行控制操作（增、删、改）。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_ctl_epoll(hi_s32 epoll_fd, hi_s32 operation, hi_s32 fd, hi_dvpp_epoll_event *event)

参数说明​

参数名输入/输出说明
epoll_fd输入Epoll实例句柄，句柄需提前通过hi_mpi_sys_create_epoll接口创建。
operation输入操作类型（增、删、改），参见hi_dvpp_epoll_ctl_op。
fd输入媒体数据处理通道的文件句柄。VENC场景下，您可以调用hi_mpi_venc_get_fd接口提前获取该文件句柄。VDEC场景下，您可以调用hi_mpi_vdec_get_fd接口提前获取该文件句柄。
event输入Epoll事件信息的指针。 该参数用于描述对应媒体数据处理通道事件类型以及关联的用户数据。 进行删除操作时，该字段不用，可直接传入NULL。

返回值说明​

参考资源​

接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

hi_mpi_sys_wait_epoll​

函数功能​

使用Epoll模型进行媒体数据处理通道输入输出操作，等待媒体数据处理Epoll实例产生事件。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_wait_epoll(hi_s32 epoll_fd, hi_dvpp_epoll_event *events, hi_s32 max_events, hi_s32 timeout, hi_s32 *event_num)

参数说明​

参数名输入/输出说明
epoll_fd输入媒体数据处理Epoll实例句柄的指针。
events输出hi_dvpp_epoll_event数组，保存产生的事件信息。
max_events输入最大可返回的事件数，不应超过events数组的元素个数。
timeout输入超时时间，单位是毫秒。
- -1：永久阻塞
- 0：立即返回
- >0：配置具体的超时时间
event_num输出Epoll实际产生的事件数的指针。

返回值说明​

参考资源​

接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

hi_mpi_sys_close_epoll​

函数功能​

使用Epoll模型进行媒体数据处理通道输入输出操作，销毁媒体数据处理Epoll实例。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_close_epoll(hi_s32 epoll_fd)

参数说明​

参数名输入/输出说明
epoll_fd输入待销毁媒体数据处理Epoll实例句柄，句柄通过hi_mpi_sys_create_epoll接口创建。

返回值说明​

参考资源​

接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

hi_mpi_sys_set_chn_csc_matrix​

函数功能​

在处理图像或视频前，YUV与RGB之间格式转换场景下，如果需要调整色域转换参数时，在创建对应图像或视频处理通道后，可调用该接口设置色域转换参数。

约束说明​

如果不调用本接口设置色域转换参数，默认使用BT601 wide标准的色域转换矩阵参数值。

如果默认的色域转换参数不适用，仅需修改一次，该通道内的其它任务都使用修改后的色域转换参数，则在创建对应图像或视频处理通道后，可调用本接口设置色域转换参数，再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。

如果默认的色域转换参数不适用，不同任务使用不同的色域转换参数，需多次修改，则在创建对应图像或视频处理通道后，在上一次任务执行结束后、下一次任务执行前调用本接口设置色域转换参数（如果上一次任务没有执行结束，就再次调用本接口设置色域转换参数，可能会导致任务处理的结果不正确），再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。

调用顺序示例如下：

  1. hi_mpi_sys_set_chn_csc_matrix（第一次修改色域转换参数）
  2. hi_mpi_vpc_crop（抠图）
  3. hi_mpi_vpc_get_process_result（等待抠图任务结束）
  4. hi_mpi_sys_set_chn_csc_matrix（第二次修改色域转换参数）
  5. hi_mpi_vpc_resize（缩放）
  6. hi_mpi_vpc_get_process_result（等待缩放任务结束）

函数原型​

hi_s32 hi_mpi_sys_set_chn_csc_matrix(hi_mod_id mode, hi_s32 chn, hi_csc_matrix csc_matrix, hi_csc_coefficient *csc_coefficient)

参数说明​

参数名输入/输出说明
mode输入模块ID，当前只支持HI_ID_VDEC和HI_ID_VPC。
chn输入通道号。当mode设置为HI_ID_VDEC时，通道号范围请参见hi_mpi_vdec_create_chn处chn参数的取值范围；当mode设置为HI_ID_VPC时，通道号范围请参见hi_mpi_vpc_create_chn处chn参数的取值范围。
csc_matrix输入色域转换矩阵的数据标准。
csc_coefficient输入色域转换矩阵参数值的指针。 如果将csc_matrix参数设置为HI_CSC_MATRIX_USER，则需要使用csc_coefficient参数设置色域转换矩阵参数；否则，此处传任意值。

返回值说明​

父主题： 公共接口

hi_mpi_sys_get_chn_csc_matrix​

函数功能​

用户使用该接口获取通道的色域转换矩阵参数值。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_get_chn_csc_matrix(hi_mod_id mode, hi_s32 chn, hi_csc_matrix *csc_matrix, hi_csc_coefficient *csc_coefficient)

参数说明​

参数名输入/输出说明
mode输入模块ID，当前只支持HI_ID_VDEC和HI_ID_VPC。
chn输入通道号。 当mode设置为HI_ID_VDEC时，通道号范围请参见hi_mpi_vdec_create_chn处chn参数的取值范围； 当mode设置为HI_ID_VPC时，通道号范围请参见hi_mpi_vpc_create_chn处chn参数的取值范围。
csc_matrix输出色域转换矩阵的数据标准的指针。
csc_coefficient输出色域转换矩阵参数值的指针。

返回值说明​

父主题： 公共接口

hi_mpi_sys_get_image_align_info​

函数功能​

根据模块、图片宽高计算出宽高对齐后的值以及存放图片数据的内存大小。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_get_image_align_info(const hi_module_type mod_type[], const hi_u32 mod_num, const hi_img_base_info *img_base_info, hi_img_align_info *img_align_info)

参数说明​

参数名输入/输出说明
mod_type输入模块类型数组。 如果数组中只有一个模块，则系统内部按该模块的对齐值来计算；如果数组中有多个模块，则系统内部按多个模块中的最大对齐值来计算；如果将模块类型设置为HI_MOD_ALL，则系统内部会从所有模块中选取最大对齐值来计算，便于简化理解各模块的对齐差异，操作简便，但可能占用内存较大。
mod_num输入模块类型数组长度。
img_base_info输入图片基本信息结构体。
img_align_info输出图片对齐信息、内存大小的结构体。

返回值说明​

父主题： 公共接口

在线提单