跳到主要内容

acl.himpi.venc_get_jpege_predicted_size

acl.himpi.venc_compact_jpeg_tables

c函数原型hi_s32 hi_mpi_venc_compact_jpeg_tables(hi_venc_chn chn, hi_u32 table_type, hi_bool enable);
Python函数ret = acl.himpi.venc_compact_jpeg_tables(chn, table_type, enable)
函数功能配置是否对高级参数huffman或QT表进行压缩。
输入说明- chn:编码通道号。
- Atlas 200/500 A2推理产品,编码通道号的取值范围:[0, 128),JPEGE功能和VENC功能共用通道,且通道总数最多128。
- table_type:压缩类型,取值范围:仅支持0,表示huffman表数据和QT量化表数据都压缩。
- enable: 是否压缩,0表示不压缩,1表示压缩。
返回值说明ret:int,错误码。
- 返回0表示成功。
- 返回非0表示失败,参见VENC视频/JPEGE图像编码返回码
约束说明本接口在编码通道创建之后、编码通道销毁之前调用。 调用此接口后,如果huffman表或QT表的Y、Cb、Cr分量内容一致时,支持压缩。
参考资源

父主题: VENC视频/JPEGE图像编码接口

acl.himpi.venc_send_jpege_frame

c函数原型hi_s32 hi_mpi_venc_send_jpege_frame(hi_venc_chn chn, const hi_video_frame_info *frame, const hi_img_stream *jpege_stream, hi_s32 milli_sec)
Python函数ret = acl.himpi.venc_send_jpege_frame(chn, frame, jpege_stream, milli_sec)
函数功能发送原始图像进行图像编码,并支持配置编码结果的输出内存地址。
输入说明- chn:编码通道号。
- Atlas 200/500 A2推理产品,编码通道号的取值范围:[0, 128),JPEGE功能和VENC功能共用通道,且通道总数最多128。
- frame(hi_video_frame_info):原始图像信息字典。
- **jpege_stream(hi_img_stream):**用于指定编码结果的输出内存地址和长度。 输出内存首地址需满足16字节对齐,内存大小可以调用acl.himpi.venc_get_jpege_predicted_size获取,再可调用acl.himpi.dvpp_malloc接口申请输出内存。
- milli_sec:超时时间,单位是毫秒。
- “-1”:阻塞方式。
- “0”:非阻塞方式。
- >0:超时方式,配置具体的超时时间。超时时间受操作系统影响,一般偏差在操作系统的一个时间片内,例如,操作系统的一个时间片为4ms,用户设置的milli_sec参数值为1,则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下,超时时间仍可能存在波动。
返回值说明ret:int,错误码。
- 返回0表示成功。
- 返回非0表示失败,参见VENC视频/JPEGE图像编码返回码
约束说明- 在调用acl.himpi.venc_create_chn接口创建通道时,将参数hi_venc_chn_attr.get("venc_attr")["buf_size"]参数值设置为0,本接口才有效,否则返回错误码HI_ERR_VENC_NOT_SUPPORT。
- JPEGE输入图像分辨率必须小于或等于编码通道的宽、高。
- 调用该接口发送图像,用户需要保证编码通道已创建且开启接收输入图片。
- 编码时,输入、输出内存均需要在调用acl.himpi.venc_get_stream接口获取结果之后才能进行释放。
- 图像编码,对输入、输出的约束请参见JPEGE功能及约束说明
参考资源接口调用流程及示例,参见JPEGE图片编码VENC视频编码

父主题: VENC视频/JPEGE图像编码接口

acl.himpi.venc_get_jpege_predicted_size

c函数原型hi_s32 hi_mpi_venc_get_jpege_predicted_size(const hi_video_frame_info *frame, const hi_venc_jpeg_param *jpeg_param, hi_u32 *size)
Python函数size, ret = acl.himpi.venc_get_jpege_predicted_size(frame, jpeg_param)
函数功能预估JPEGE编码一帧图片所需的输出缓冲区大小。
输入说明frame(hi_video_frame_info):int,原始图像信息字典。 jpeg_param(hi_venc_jpeg_param):JPEG协议编码通道的高级参数集合字典,预留参数。
返回值说明ret:int,错误码。
- 返回0表示成功。
- 返回非0表示失败,参见VENC视频/JPEGE图像编码返回码
size:输出缓冲区大小,单位为Byte。

父主题: VENC视频/JPEGE图像编码接口

acl.himpi.venc_get_cu_pred

c函数原型hi_s32 **hi_mpi_venc_get_cu_pred(**hi_venc_chn chn, hi_venc_cu_prediction *cu_pred)
Python函数cu_pred, ret = acl.himpi.venc_get_cu_pred(chn)
函数功能获取通道CU/MB的模式选择的倾向性设置。
输入说明chn:int,编码通道号。
- Atlas 200/500 A2推理产品,编码通道号的取值范围:[0, 128),JPEGE功能和VENC功能共用通道,且通道总数最多128。
返回值说明cu_pred:dict,CU模式选择的倾向性字典。具体参见hi_venc_cu_predictionret:int,错误码。
- 返回0表示成功。
- 返回非0表示失败,参见VENC视频/JPEGE图像编码返回码
约束说明- 本接口用于获取CU模式选择的倾向性配置。
- 本接口在编码通道创建之后,编码通道销毁之前调用。
- 仅H.265/H.264编码通道支持。
参考资源

父主题: VENC视频/JPEGE图像编码接口

acl.himpi.venc_set_cu_pred

c函数原型hi_s32 **hi_mpi_venc_set_cu_pred(**hi_venc_chn chn, const hi_venc_cu_prediction *cu_pred)
Python函数ret = acl.himpi.venc_set_cu_pred(chn, cu_pred)
函数功能本接口用于调节通道CU/MB的模式选择的倾向性,支持调节帧间预测(Inter)和帧内预测(Intra)的倾向性配置以及编码块大小的倾向性配置。 编码协议以像素块作为基本处理单元,H.265/H.264中分别称为CU(Coding Unit)/MB(MacroBlock)。本接口中的CU模式指Inter/Intra预测模式中对不同尺寸像素块的选择。
输入说明- chn:int,编码通道号。
- Atlas 200/500 A2推理产品,编码通道号的取值范围:[0, 128),JPEGE功能和VENC功能共用通道,且通道总数最多128。
- cu_pred:CU模式选择的倾向性参数字典。具体参见hi_venc_cu_prediction。 该字典内需包含以下参数:
- pred_mode:倾向性选择模式,支持auto和manual两种模式。auto模式下由驱动内部完成倾向性配置,即用户的配置参数不生效;manual模式允许用户根据实际场景完成自定义的倾向性配置。
- intra32_cost/intra16_cost/intra8_cost/intra4_cost/inter64_cost/inter32_cost/inter16_cost/inter8_cost分别设置各自模式的倾向性大小。默认每个cost值为8,即不做倾向性配置。每个模式的cost设置越大意味着选择该模式的倾向性越小。
返回值说明ret:int,错误码。
- 返回0表示成功。
- 返回非0表示失败,参见VENC视频/JPEGE图像编码返回码
约束说明- 仅H.265/H.264编码通道支持。
- 建议用户在创建通道之后,启动编码之前调用本接口,减少编码过程中调用本接口的次数。若在编码过程中调用本接口,则下一帧编码时配置生效。
- 建议用户在调用此接口之前先调用acl.himpi.venc_get_cu_pred接口,获取CU模式选择的倾向性配置,然后再进行设置。
- 注意某些场景下特定模式不使能(例如,H.264中最大MB尺寸为16*16,且baseline和main profile下inter16_cost不使能,high profile下inter8_cost不使能),即使用户设置了这些特定模式的倾向性参数也不生效。
参考资源

父主题: VENC视频/JPEGE图像编码接口

acl.himpi.venc_get_h264_vui

c函数原型hi_s32 **hi_mpi_venc_get_h264_vui(**hi_venc_chn chn, hi_venc_h264_vui *h264_vui)
Python函数h264_vui**, ret = acl.himpi.venc_get_h264_vui(chn)**
函数功能获取H.264协议编码通道的Vui配置。
输入说明chn:int,编码通道号。
- Atlas 200/500 A2推理产品,编码通道号的取值范围:[0, 128),JPEGE功能和VENC功能共用通道,且通道总数最多128。
返回值说明h264_vui:dict,H.264协议编码通道的Vui属性。具体请参见hi_venc_h264_vuiret:int,错误码。
- 返回0表示成功。
- 返回非0表示失败,参见VENC视频/JPEGE图像编码返回码
约束说明- 本接口用于获取H.264协议编码通道的Vui配置。
- 本接口在编码通道创建之后,编码通道销毁之前调用。
- 建议用户在创建通道之后,启动编码之前调用此接口,减少在编码过程中调用的次数。
- 用户应当仅在H.264协议编码通道中调用本接口。
参考资源

父主题: VENC视频/JPEGE图像编码接口

在线提单