mxpi_imagedecoder

功能描述

用于图像解码,当前只支持JPG/JPEG/BMP格式。

JPG/JPEG输入图片格式约束:
  • 只支持Huffman编码,码流的subsample为444/422/420/400/440。
  • 不支持算术编码。
  • 不支持渐进JPEG格式。
  • 不支持JPEG2000格式。

同步/异步(status)

异步

约束限制

  • JPG/JPEG输入图片的最大分辨率:8192 * 8192。
  • JPG/JPEG输入图片的最小分辨率:32 * 32。
  • OpenCV方法或BMP输入图片均无分辨率范围约束。
  • 输出图片的widthStride(对齐后的宽度):
    • Atlas 200/300/500 推理产品对齐到128(即宽度为128的倍数),解码插件自动对齐。
    • Atlas 200I/500 A2 推理产品对齐到128(即宽度为128的倍数),解码插件自动对齐。
    • Atlas 推理系列产品对齐到64(即宽度为64的倍数),解码插件自动对齐。
  • 输出图片的heightStride(对齐后的高度):对齐到16(即高度为16的倍数),解码插件自动对齐。

插件基类(factory)

mxpi_imagedecoder

输入和输出

  • 输入:buffer(数据类型“MxpiBuffer”)。
  • 输出:buffer(数据类型“MxpiBuffer”)、metadata(数据类型“MxpiVisionList”,“MxpiObjectList”)。

端口格式(Caps)

  • 静态输入:{"image/jpeg"}。
  • 动态输出:{"image/yuv","metadata/object","image/rgb"}。

属性

请参见表1

表1 mxpi_imagedecoder插件的属性

属性名

描述

是否为必选项

是否可修改

deviceId

使用设备的芯片编号,无需自己设置,统一由“stream_config”字段中的“deviceId”属性设置。

imageFormat

解码的图像格式,默认为jpg格式。

  • Ascend方法支持jpeg和jpg、bmp。
  • OpenCV方法支持jpg、jpeg、bmp等。

cvProcessor

处理方法。
  • ascend(默认):调用昇腾DVPP接口进行处理。
  • opencv:调用OpenCV接口进行处理。

outputDataFormat

用于使用OpenCV方法或输入图像格式为bmp时,配置图像的输出数据类型,仅支持配置为BGR或RGB。

  • 使用OpenCV方法解码时,图像解码默认输出BGR数据,也可通过本属性修改为RGB数据。
  • bmp图像解码默认输出为BGR数据,也可通过本属性修改为RGB数据。
  • 使用Ascend方法解码时,jpeg和jpg图像解码输出为yuv数据,不支持该属性配置。

dataType

解码数据的类型,默认为uint8,也可以设置成float32,该选项在OpenCV处理方法中生效。

formatAdaptation

色域转换功能,将图像解码为BGR888格式,值为string,默认值为“off”(关闭),需要启动时配置“on”。(当前仅在Atlas 推理系列产品上支持该功能,输入图片的分辨率约束为32*32~4096*4096)。

handleMethod

预留属性,请使用cvProcessor属性。

处理方法:

  • ascend(默认)
  • opencv