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。

昇腾310 AI处理器,当前版本该接口预留。

昇腾910 AI处理器,当前版本该接口预留。

输入说明

chn:解码通道号。该参数的取值范围:[0, 127],通道总数最多128。typedef hi_s32 hi_pngd_chn;

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功能

使用场景

昇腾710 AI处理器,接口调用流程,参见PNGD功能