acl.himpi.pngd_get_image_data

acl.himpi.pngd_destroy_chn

c函数原型	hi_s32 hi_mpi_pngd_destroy_chn(hi_pngd_chn chn)
Python函数	ret = acl.himpi.pngd_destroy_chn**(chn)**
函数功能	用户退出流程时，需要关闭之前创建的解码通道，以释放相关资源。
输入说明	chn：解码通道号。 该参数的取值范围为[0, 128)，通道总数最多128。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回非0表示失败，参见PNGD图像解码返回码。
约束说明	销毁前必须保证通道已创建，否则会返回通道未创建的错误。

父主题： PNGD图像处理接口

acl.himpi.pngd_send_stream

c函数原型	hi_s32 hi_mpi_pngd_send_stream(hi_pngd_chn chn, const hi_img_stream *stream, hi_pic_info *png_pic_info, hi_s32 milli_sec)
Python函数	ret = acl.himpi.pngd_send_stream(chn, stream, png_pic_info, milli_sec)
函数功能	解码前，向解码通道发送码流数据及存放解码结果的buffer。
输入说明	chn ：解码通道号。 该参数的取值范围为[0, 128)，通道总数最多128。 stream(hi_img_stream)：输入码流信息。该字典内的addr参数配置的地址为Device上的内存地址。 png_pic_info(hi_pic_info)：输出图片信息字典。 milli_sec：超时时间，单位是毫秒。 - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回非0表示失败，参见PNGD图像解码返回码。
约束说明	- 发送数据前必须保证通道已经被创建，否则直接返回通道未创建的错误码HI_ERR_PNGD_UNEXIST。如果在发送码流过程中销毁通道，就会立刻返回错误码HI_ERR_PNGD_UNEXIST。 - 发送码流时需要送入整张png图片。否则，解码会出现错误。 - 以非阻塞方式发送码流，如果码流缓冲区已满，会立刻返回错误码HI_ERR_PNGD_BUF_FULL。 - 以超时方式发送码流，到达设定的超时时间还不能成功发送码流会返回错误码HI_ERR_PNGD_BUF_FULL。 - 图像解码时，对输入、输出图片的要求请参见功能及约束说明。 - 解码时，输入输出内存必须使用acl.himpi.dvpp_malloc接口和acl.himpi.dvpp_free接口进行申请和释放，输入输出内存均需要在调用acl.himpi.pngd_get_image_data接口获取结果之后才能进行释放。

父主题： PNGD图像处理接口

acl.himpi.pngd_get_image_data

c函数原型	hi_s32 hi_mpi_pngd_get_image_data(hi_pngd_chn chn, hi_pic_info *png_pic_info, hi_img_stream *stream, hi_s32 milli_sec)
Python函数	png_pic_info, stream, ret = acl.himpi.pngd_get_image_data**(chn, milli_sec)**
函数功能	解码后，获取解码通道的解码图像及输入Stream。
输入说明	chn：解码通道号。 该参数的取值范围为[0, 128)，通道总数最多128。 milli_sec：超时时间，单位是毫秒。 - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。
返回值说明	- stream**(hi_img_stream)：获取已完成解码的输入码流信息字典。 - png_pic_info(hi_pic_info)**：获取已经完成解码的图像信息字典。解码后的数据存放在Device内存中。 - ret：int， - 返回0表示获取数据成功。 - 返回非0表示失败，参见PNGD图像解码返回码。HI_ERR_PNGD_BUF_EMPTY表示无数据，其他错误码表示解码异常
约束说明	- 此接口通过改变milli_sec值支持阻塞方式、非阻塞方式、超时方式获取解码图像。 - 获取解码图像时必须保证通道已经被创建，否则直接返回通道未创建的错误码HI_ERR_PNGD_UNEXIST。如果在获取图像的过程中销毁通道，就会立刻返回错误码HI_ERR_PNGD_UNEXIST。 - 以非阻塞方式获取解码图像，如果缓冲区内无图像，会立刻返回错误码HI_ERR_PNGD_BUF_EMPTY。 - 以超时方式获取解码图像，到达设定的超时时间还不能获取到图像则会返回错误码HI_ERR_PNGD_BUF_EMPTY。 - 向PNGD获取解码结果，输入buffer和输出buffer一起获取。 - PNGD图片解码时，关于输入、输出图片的要求请参见功能及约束说明。

父主题： PNGD图像处理接口

acl.himpi.png_get_image_info

c函数原型	hi_s32 hi_mpi_png_get_image_info(const hi_img_stream *png_stream, hi_img_info *img_info)
Python函数	img_info, ret = acl.himpi.png_get_image_info(png_stream)
函数功能	根据输入码流，获取png源图片的宽、高、源格式及源格式解码时输出图片的宽stride、高stride、以及所需的内存大小等信息。
输入说明	png_stream**(hi_img_stream)**：输入码流信息。
返回值说明	img_info(hi_img_info)：图片信息字典。 ret：int，错误码。 - 返回0表示成功。 - 返回非0表示失败，参见PNGD图像解码返回码。
约束说明	提供给用户来计算解码后输出图片占用的内存大小。当前仅支持解析png图片。通过本接口获取的widthStride向上128对齐、heightStride向上16对齐。
参考资源	无

父主题： PNGD图像处理接口

总体说明

本章节描述DVPP各个模块所用到的字典、全局变量等，预留的字段需要手动设置为0，避免后续版本的兼容性问题。

命名规则：

• 各模块均需要的模块放在公共部分，各模块特性部分尽量放在各模块内，并且以模块名开头。
• 例如HI_COMPRESS_MODE_BUTT，表示保留值。

父主题： 数据类型

基本数据类型说明

HI_FALSE = 0
HI_TRUE = 1

父主题： 公共

在线提单