JPEGE功能及约束说明

功能说明

JPEGE（JPEG Encoder）将YUV格式图片编码成JPEG压缩格式的图片文件，例如*.jpg。

图片分辨率约束

• 输入图片分辨率：

  型号	分辨率范围
  Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 Atlas 推理系列产品	最大分辨率：8192*8192，最小分辨率：32*32。
  Atlas 200I/500 A2 推理产品	最大分辨率：16384*16384，最小分辨率：32*32。
  Atlas 350 加速卡	最大分辨率：32768*32768，最小分辨率：32*32。

• 输出图片分辨率

  JPEGE只对图片编码，不会改变图片分辨率，因此输出与输入的图片分辨率保持一致。

内存申请/释放接口说明

输入内存的大小就是指实际的输入码流所占用的大小，输出内存的大小参见图片格式、宽高对齐、内存约束中的计算公式。

• 输入内存申请/释放接口：

  JPEGE图片编码功能时，调用hi_mpi_dvpp_malloc\hi_mpi_dvpp_free接口申请\释放Device上的输入内存，这部分内存的生命周期由用户自行管理。

• 输出内存申请/释放接口：
  • 不需要用户管理、由DVPP内部管理输出内存时，调用hi_mpi_venc_send_frame接口发送原始图像进行图像编码。

    在调用hi_mpi_venc_create_chn接口创建通道时，必须正确设置hi_venc_chn_attr.venc_attr.buf_size参数值（参数描述请参见hi_venc_attr）。

    该方式下，相比由用户管理内存，输出结果数据的JPEG头中不存在COM注释字段，数据长度会短一点，但需要用户从DVPP返回的内存中拷贝输出结果数据到指定内存。

  • 由用户自行管理输出内存、管理内存的生命周期，调用hi_mpi_venc_send_jpege_frame接口发送原始图像进行图像编码。

    在调用hi_mpi_venc_create_chn接口创建通道时，需将hi_venc_chn_attr.venc_attr.buf_size参数值设置为0（参数描述请参见hi_venc_attr），然后调用hi_mpi_venc_get_jpege_predicted_size接口预估输出内存大小，调用hi_mpi_dvpp_malloc\hi_mpi_dvpp_free接口申请\释放输出内存。

    该方式下，直接在调用hi_mpi_venc_send_jpege_frame接口时，设置输出内存地址，输出结果数据直接存放到用户设置的内存中，相比由系统管理内存的方式，用户可减少一次“从DVPP返回的内存中拷贝输出结果数据到指定内存”的操作，但输出结果数据的JPEG头中可能会存在COM注释字段（字段长度范围4~19Byte），数据长度会长一点。

针对以下产品型号，还支持调用aclrtMalloc\aclrtFree接口申请\释放Device上的输入、输出内存，这部分内存的生命周期由用户自行管理：

Atlas 350 加速卡

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas A2 训练系列产品/Atlas A2 推理系列产品

Atlas 200I/500 A2 推理产品

图片格式、宽高对齐、内存约束

输入图片格式的定义请参见hi_pixel_format，宽stride、高stride等概念请参见基本概念。

各产品型号的图片格式、宽高对齐、内存大小约束不同，如下所示。