PNGD功能

功能及约束说明

PNGD（PNG decoder）功能：实现PNG格式图片的硬件解码。

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

    最大分辨率4096 * 4096，最小分辨率32 * 32。

  • 输入图片格式：

    RGBA、RGB、GRAY、AGRAY。

  • 输入内存：
    • 输入内存首地址要求128对齐。调用acldvppMalloc接口/acldvppFree接口申请或释放内存。
    • 输入内存的大小就是指实际的输入图片所占用的大小。
• PNGD输出的约束：
  • 输出图片格式：

    RGBA、RGB。

    如果输入格式为GRAY，则输出会转码为RGB；如果输入格式为AGRAY，则输出会转码为RGB或RGBA。

  • 输出内存：
    • 输出内存的大小可调用acldvppPngPredictDecSize接口获取。
    • 输出内存首地址要求128对齐。调用acldvppMalloc接口/acldvppFree接口申请或释放内存。
  • 输出图片的宽stride、高stride对齐要求：
    • 输出图片的widthStride（对齐后的宽度），若输出格式为RGB，则输出图片宽先128对齐后再*3，若输出格式为RGBA，则输出图片宽先128对齐后再*4。
    • 输出图片的heightStride（对齐后的高度），对齐到16。

性能指标说明（昇腾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

函数功能

解码png图片，异步接口。

函数原型

aclError acldvppPngDecodeAsync(acldvppChannelDesc *channelDesc,

const void *data,

uint32_t size,

acldvppPicDesc *outputDesc,

aclrtStream stream)

参数说明

返回值说明

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

参考资源

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

函数功能

从存放png图片数据的内存中读取png图片的宽、高。

函数原型

aclError acldvppPngGetImageInfo(const void *data,

uint32_t dataSize,

uint32_t *width,

uint32_t *height,

int32_t *components)

参数说明

返回值说明

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

函数功能

根据存放png图片数据的内存计算出png图片解码后所需的输出内存的大小。

函数原型

aclError acldvppPngPredictDecSize(const void *data,

uint32_t dataSize,

acldvppPixelFormat outputPixelFormat,

uint32_t *decSize)

参数说明

返回值说明

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

参考资源

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