JPEGE功能

功能及约束说明

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

• JPEGE输入的约束：
  • 输入图片分辨率

    最大分辨率：8192 * 8192，最小分辨率：32 * 32。

  • 输入图片格式：
    • YUV422 Packed（yuyv,yvyu,uyvy,vyuy）
    • YUV420SP（NV12，NV21）
  • 输入内存：
    • 输入内存首地址要求128对齐。调用acldvppMalloc接口/acldvppFree接口申请或释放内存。
    • 输入内存大小与图片数据的格式相关，计算公式如下：

      YUV422packed：widthStride*heightStride

      YUV420SP：widthStride*heightStride*3/2

  • 输入图片的宽stride、高stride对齐要求：
    • 输入图片的widthStride（即对齐后的宽度），对齐到16，兼容对齐到16的倍数如128。对于YUV422packed数据，widthStride应该为输入图片宽度的两倍对齐到16。
    • 输入图片的heightStride，取值：配置为与输入图片的高度相同的数值；或配置为输入图片的高度向上对齐到16的数值（最小为32）。其中后一种取值的使用场景举例：JPEGD的输出图片直接作为JPEGE的输入（JPEGD输出图片高度是向上对齐到16的）。
• JPEGE输出的约束：
  • 输出图片格式：
    • JPEG压缩格式的图片文件，例如*.jpg。
    • 只支持huffman编码，不支持算术编码，不支持渐进编码。
  • 输出内存：
    • 输出内存的大小就是指实际的编码后图片所占用的大小。可调用acldvppJpegPredictEncSize接口预估输出内存大小。
    • 输出内存首地址要求128对齐。调用acldvppMalloc接口/acldvppFree接口申请或释放内存。

性能指标说明（昇腾310 AI处理器）

1080p指分辨率为1920*1080的图片；4K指分辨率为3840*2160的图片。单个Device的基本场景性能指标参考如下：

上述性能数据，基于以下基本要求：

• 一个stream上下发10个异步媒体数据处理任务后，执行一次aclrtSynchronizeStream接口。
• CtrlCPU与AI CPU的配比是4：4

性能指标说明（昇腾910 AI处理器）

1080p指分辨率为1920*1080的图片；4K指分辨率为3840*2160的图片。单个Device的基本场景性能指标参考如下：

上述性能数据，基于以下基本要求：

• 一个stream上下发10个异步媒体数据处理任务后，执行一次aclrtSynchronizeStream接口。
• CtrlCPU与AI CPU的配比是1：15

函数功能

将YUV格式图片编码成.jpg图片，异步接口。

函数原型

aclError acldvppJpegEncodeAsync(acldvppChannelDesc *channelDesc,

acldvppPicDesc *inputDesc,

const void *data,

uint32_t *size,

acldvppJpegeConfig *config,

aclrtStream stream);

参数说明

返回值说明

返回0表示任务下发成功，返回非0表示任务下发失败。

参考资源

• 接口调用流程，参见JPEG图片编码。
• 接口调用示例，参见JPEG图片编码。

函数功能

根据输入图片描述信息、图片编码配置数据预估图片编码后所需的输出内存的大小。

函数原型

aclError acldvppJpegPredictEncSize(const acldvppPicDesc *inputDesc, const acldvppJpegeConfig *config, uint32_t *size)

参数说明

返回值说明

返回0表示成功，返回其它值表示失败。

参考资源

• 接口调用流程，参见JPEG图片编码。
• 接口调用示例，参见JPEG图片编码。