acl.himpi.sys_close_epoll

acl.himpi.sys_ctl_epoll

c函数原型	hi_s32 hi_mpi_sys_ctl_epoll(hi_s32 epoll_fd, hi_s32 operation, hi_s32 fd, hi_dvpp_epoll_event *event);
Python函数	ret = acl.himpi.sys_ctl_epoll(epoll_fd, operation, fd, event)
函数功能	在媒体数据处理Epoll实例中，对对应的媒体数据处理通道进行控制操作（增、删、改）。
输入说明	- epoll_fd：Epoll实例句柄，句柄需提前通过acl.himpi.sys_create_epoll接口创建。 - operation：操作类型（增、删、改），参见acl.hi.dvpp_epoll_ctl_op。 - fd：媒体数据处理通道的文件句柄。VENC场景下，您可以调用acl.himpi.venc_get_fd接口提前获取该文件句柄。VDEC场景下，您可以调用acl.himpi.vdec_get_fd接口提前获取该文件句柄。 - event：Epoll事件信息的指针地址。该参数用于描述对应媒体数据处理通道事件类型以及关联的用户数据。 进行删除操作时，该字段无效。
返回值说明	ret：int，错误码。 - 返回0，表示成功。 - 返回非0，表示失败，参见公共返回码。
约束说明	- acl.himpi.sys_create_epoll、acl.himpi.sys_ctl_epoll、acl.himpi.sys_wait_epoll、acl.himpi.sys_close_epoll这几个接口要配合使用，实现使用epoll编程模型操作媒体数据处理通道的输入/输出数据。 - VPC功能不支持使用该接口。
参考资源	接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

acl.himpi.sys_wait_epoll

c函数原型	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);
Python函数	event, event_num, ret = acl.himpi.sys_wait_epoll(epoll_fd, max_events, timeout)
函数功能	使用Epoll模型进行媒体数据处理通道输入输出操作，等待媒体数据处理Epoll实例产生事件。
输入说明	- epoll_fd：媒体数据处理Epoll实例句柄的指针地址。 - max_events：最大可返回的事件数，不应超过events数组的元素个数。 - timeout：超时时间，单位是毫秒。 - -1：永久阻塞。 - 0：立即返回。 - >0：配置具体的超时时间。
返回值说明	event：hi_dvpp_epoll_event数组，保存产生的事件信息。 event_num：Epoll实际产生的事件数。 ret：int，错误码。 - 返回0表示成功。 - 返回非0表示失败，参见公共返回码。
约束说明	- acl.himpi.sys_create_epoll、acl.himpi.sys_ctl_epoll、acl.himpi.sys_wait_epoll、acl.himpi.sys_close_epoll这几个接口要配合使用，实现使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。 - VPC功能不支持使用该接口。
参考资源	接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

acl.himpi.sys_close_epoll

c函数原型	hi_s32 hi_mpi_sys_close_epoll(hi_s32 epoll_fd)
Python函数	ret = acl.himpi.sys_close_epoll(epoll_fd)
函数功能	使用Epoll模型进行媒体数据处理通道输入输出操作，销毁媒体数据处理Epoll实例。
输入说明	epoll_fd：待销毁媒体数据处理Epoll实例句柄，句柄通过acl.himpi.sys_create_epoll接口创建。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回非0表示失败，参见公共返回码。
约束说明	- acl.himpi.sys_create_epoll、acl.himpi.sys_ctl_epoll、acl.himpi.sys_wait_epoll、acl.himpi.sys_close_epoll这几个接口要配合使用，实现使用epoll编程模型操作媒体数据处理通道的输入/输出数据。 - VPC功能不支持使用该接口。
参考资源	接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

acl.himpi.sys_get_image_align_info

c函数原型	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)
Python函数	img_align_info, ret = acl.himpi.sys_get_image_align_info(mod_type, mod_num, img_base_info)
函数功能	根据模块、图片宽高计算出宽高对齐后的值以及存放图片数据的内存大小。
输入说明	- mod_type：模块类型数组。模块类型是整数型常量. 如果数组中只有一个模块，则系统内部按该模块的对齐值来计算；如果数组中有多个模块，则系统内部按多个模块中的最大对齐值来计算；如果将模块类型设置为HI_MOD_ALL，则系统内部会从所有模块中选取最大对齐值来计算，便于简化理解各模块的对齐差异，操作简便，但可能占用内存较大。 - mod_num：模块类型数组长度。 - img_base_info：图片基本信息字典。
返回值说明	img_align_info：图片对齐信息、内存大小的字典。 ret：int，错误码。 - 返回0表示成功。 - 返回非0表示失败，参见公共返回码。
约束说明	图片宽、高不能小于该模块最小宽高、不能大于最大宽高，图片格式必须是该模块所支持的。 各模块支持的图片格式、对齐要求请参见VPC图像处理接口、VDEC视频解码/JPEGD图像解码接口、VENC视频/JPEGE图像编码接口、PNGD图像处理接口下的约束说明。当前不支持设置HI_PIXEL_FORMAT_UNKNOWN格式。

父主题： 公共接口

acl.himpi.sys_set_chn_csc_matrix

c函数原型	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);
Python函数	ret = acl.himpi.sys_set_chn_csc_matrix(mode, chn, csc_matrix, csc_coefficient)
函数功能	在处理图像或视频前，YUV与RGB之间格式转换场景下，如果需要调整色域转换参数时，在创建对应图像或视频处理通道后，可调用该接口设置色域转换参数。
输入说明	- mode：模块ID，当前只支持HI_ID_VDEC和HI_ID_VPC。 - chn：通道号。当mode设置为HI_ID_VDEC时，通道号范围请参见acl.himpi.vdec_create_chn处chn参数的取值范围；当mode设置为HI_ID_VPC时，通道号范围请参见acl.himpi.vpc_create_chn处chn参数的取值范围。 - csc_matrix：色域转换矩阵的数据标准。 - csc_coefficient：如果将“csc_matrix”参数设置为“HI_CSC_MATRIX_USER”，则需要使用“csc_coefficient”参数设置色域转换矩阵参数，否则，此处传任意值。
返回值说明	**ret：**int，错误码。 - 返回0，表示成功。 - 返回非0，表示失败，参见公共返回码。
约束说明	- 如果不调用本接口设置色域转换参数，默认使用BT601 wide标准的色域转换矩阵参数值。 - 如果默认的色域转换参数不适用，仅需修改一次，该通道内的其它任务都使用修改后的色域转换参数，则在创建对应图像或视频处理通道后，可调用本接口设置色域转换参数，再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。 - 如果默认的色域转换参数不适用，不同任务使用不同的色域转换参数，需多次修改，则在创建对应图像或视频处理通道后，在上一次任务执行结束后、下一次任务执行前调用本接口设置色域转换参数（如果上一次任务没有执行结束，就再次调用本接口设置色域转换参数，可能会导致任务处理的结果不正确），再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。 调用顺序示例如下： 1. acl.himpi.sys_set_chn_csc_matrix（第一次修改色域转换参数） 2. acl.himpi.vpc_crop（抠图） 3. acl.himpi.vpc_get_process_result（等待抠图任务结束） 4. acl.himpi.sys_set_chn_csc_matrix（第二次修改色域转换参数） 5. acl.himpi.vpc_resize（缩放） 6. acl.himpi.vpc_get_process_result（等待缩放任务结束）

父主题： 公共接口

在线提单