hi_mpi_venc_send_jpege_frame
函数功能
发送原始图像进行图像编码,并支持配置编码结果的输出内存地址。
Atlas 200/300/500 推理产品,不支持该接口。
Atlas 训练系列产品,不支持该接口。
约束说明
- 在调用hi_mpi_venc_create_chn接口创建通道时,将参数hi_venc_chn_attr.venc_attr.buf_size参数值设置为0,本接口才有效,否则返回错误码HI_ERR_VENC_NOT_SUPPORT。
- JPEGE输入图像分辨率必须小于或等于编码通道的宽、高。
- 调用该接口发送图像,用户需要保证编码通道已创建且开启接收输入图片。
- 编码时,输入、输出内存均需要在调用hi_mpi_venc_get_stream接口获取结果之后才能进行释放。
- 图像编码,对输入、输出的约束请参见JPEGE功能及约束说明。
函数原型
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)
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
chn |
输入 |
编码通道号。 Atlas 推理系列产品(Ascend 310P处理器),编码通道号的取值范围:[0, 256),JPEGE功能和VENC功能共用通道,且通道总数最多256。 Atlas A2训练系列产品,编码通道号的取值范围:[0, 256),JPEGE功能通道总数最多256。 Atlas 200I/500 A2推理产品,编码通道号的取值范围:[0, 128),JPEGE功能和VENC功能共用通道,且通道总数最多128。 |
frame |
输入 |
原始图像信息的指针。 |
jpege_stream |
输入 |
用于指定编码结果的输出内存地址和长度。 输出内存首地址需满足16字节对齐,内存大小可以调用hi_mpi_venc_get_jpege_predicted_size获取,再可调用hi_mpi_dvpp_malloc接口申请输出内存。 |
milli_sec |
输入 |
超时时间,单位是毫秒。
|
返回值说明
- 0:成功
- 非0:失败,参见VENC视频编码/JPEGE图片编码返回码