函数：dvpp_png_decode_async

产品支持情况

产品	是否支持
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

功能说明

解码PNG图片，异步接口，支持格式请参见表1 支持格式。

表1 支持格式
功能	输入图片格式	输出图片格式
调用本接口时将输出图片格式设置为PIXEL_FORMAT_UNKNOWN 表示不指定输出图片格式，输出图片格式与输入图片格式一致。	RGB/GRAY	RGB
调用本接口时将输出图片格式设置为PIXEL_FORMAT_UNKNOWN 表示不指定输出图片格式，输出图片格式与输入图片格式一致。	RGBA/AGRAY	RGBA
调用本接口时将输出图片格式设置为PIXEL_FORMAT_RGB_888，表示指定输出图片格式，将输入图片格式转换为输出图片格式。	RGB/RGBA/GRAY/AGRAY	RGB

函数原型

C函数原型

        
             aclError acldvppPngDecodeAsync(acldvppChannelDesc *channelDesc,const void *data,uint32_t size,acldvppPicDesc *outputDesc,aclrtStream stream)

python函数

        
             ret = acl.media.dvpp_png_decode_async(dvpp_channel_desc, data, size, output_desc, stream)

参数说明

参数名	说明
dvpp_channel_desc	int，指定通道描述信息的指针地址。与调用acl.media.dvpp_create_channel接口创建通道时指定的“dvpp_channel_desc”保持一致。
data	int，输入图片的内存地址的指针地址。
size	int，输入图片的实际数据大小，单位Byte。
output_desc	int，输出图片信息的指针地址。作为输入时，需要用户调用如下接口：调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。调用acl.media.dvpp_set_pic_desc系列接口设置输出图片的内存地址、内存大小、格式。输出图片的内存大小可提前调用acl.media.dvpp_png_predict_dec_size接口获取。 PNG原图信息（例如宽、高）可通过acl.media.dvpp_png_get_image_info接口获取。输出图片格式、内存等要求，请参见功能及约束说明。作为输出时，用户可以从内存地址中获取解码后的输出图片数据。
stream	int，指定Stream。

返回值说明

返回值	说明
ret	int，错误码，返回0表示成功，返回其它值表示失败。

约束说明

本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，acl.rt.synchronize_stream）确保任务已执行完成。

资源参考

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

父主题： PNGD功能