InitPngDecodeChannel

InitJpegDecodeChannel

函数功能

初始化JPEGD图像通道，用于JPEG解码。

函数原型

APP_ERROR InitJpegDecodeChannel(const JpegDecodeChnConfig& config = JPEG_DECODE_CHN_CONFIG);

参数说明

参数名	输入/输出	说明
config	输入	通道配置参数，默认值为“JPEG_DECODE_CHN_CONFIG”。 对应数据结构参见如下（当前预留）。 text<br>struct JpegDecodeChnConfig &#123;&#125;;<br>

返回参数说明

数据结构	说明
APP_ERROR	程序执行返回的错误码，请参考APP_ERROR说明。

父主题： ImageProcessor

InitVpcChannel

函数功能

初始化VPC图像通道，用于图像处理功能（抠图、缩放、补边、抠图缩放、抠图贴图、色域转换）。

函数原型

APP_ERROR InitVpcChannel(const VpcChnConfig& config = VPC_CHN_CONFIG);

参数说明

参数名	输入/输出	说明
config	输入	通道配置参数，默认值为“VPC_CHN_CONFIG”。 对应数据结构参见如下（当前预留）。 text<br>struct VpcChnConfig &#123;&#125;;<br>

返回参数说明

数据结构	说明
APP_ERROR	程序执行返回的错误码，请参考APP_ERROR说明。

父主题： ImageProcessor

InitPngDecodeChannel

函数功能

初始化PNGD图像通道，用于PNG图片解码。

函数原型

APP_ERROR InitPngDecodeChannel(const PngDecodeChnConfig& config = PNG_DECODE_CHN_CONFIG);

参数说明

参数名	输入/输出	说明
config	输入	通道配置参数，默认值为“PNG_DECODE_CHN_CONFIG”。 对应数据结构参见如下（当前预留）。 text<br>struct PngDecodeChnConfig &#123;&#125;; <br>

返回参数说明

数据结构	说明
APP_ERROR	程序执行返回的错误码，请参考APP_ERROR说明。

父主题： ImageProcessor

Decode

函数功能

ImageProcessor类的图片解码接口，使用该接口申请的Image内存无需用户管理，由内部管理释放。仅支持以Host侧申请的内存作为解码接口的输入。输入图片内存的数据类型目前支持JPEG和PNG两种格式。

• JPG/JPEG格式：

  • JPG/JPEG输入图片的最大分辨率：8192 * 8192，其中 RGB_888, BGR_888 格式只支持至 4096*4096。

  • JPG/JPEG输入图片的最小分辨率：32 * 32。

  • 输出解码后的图片及“outputImage”的数据类型目前仅支持YUV_SP_420，YVU_SP_420两种图像格式。

  • 输出图片的宽。

    • Atlas 200I/500 A2 推理产品对齐到128（即宽度为128的倍数），在对齐操作前，接口会向下2对齐操作，例如：图片原图宽为1023 ，在进行Decode接口解码处理后，通过GetSize()获得的值为1024，通过GetOriginalSize()获得的值为1022。

  • 输出图片的高：对齐到16（即高度为16的倍数），解码接口自动对齐。

    对于Atlas 200I/500 A2 推理产品，在对齐操作前，接口会向下2对齐操作，例如：图片原图高为683，在进行Decode接口解码处理后，通过GetSize()获得的值为688，通过GetOriginalSize()获得的值为682。

    :::note 说明 JPG/JPEG输入图片格式约束：

    • 只支持Huffman编码，码流的subsample为444/422/420/400/440。
    • 不支持算术编码。
    • 不支持渐进JPEG格式。
    • 不支持JPEG2000格式。 :::
• PNG格式：
  • PNG输入图片的最大分辨率：4096 * 4096。
  • PNG输入图片的最小分辨率：32 * 32。
  • 输出图片的宽：对齐到128（即宽度为128的倍数），解码接口自动对齐。
  • 输出图片的高：对齐到16（即高度为16的倍数），解码接口自动对齐。

函数原型

APP_ERROR Decode(const std::shared_ptr<uint8_t> dataPtr, const uint32_t dataSize,
                 Image& outputImage, const ImageFormat decodeFormat = ImageFormat::YUV_SP_420);
APP_ERROR Decode(const std::string inputPath, Image& outputImage,
                 const ImageFormat decodeFormat = ImageFormat::YUV_SP_420);

参数说明

参数名	输入/输出	说明
dataPtr	输入	输入待解码图片数据的内存地址。解码前图像数据内存地址需要用户进行管理。
dataSize	输入	输入待解码图片数据的内存大小。需要与“dataPtr”的实际内存大小相符。 - 用户提供的“dataSize”无法完整读取图片文件头信息，则会返回异常。 - 用户提供的“dataSize”大于文件头信息并且小于实际内存大小，则会根据“dataSize”进行部分解码。 - 用户提供的“dataSize”大于实际内存大小，则以图片文件结束符为准。
decodeFormat	输入	输入解码后图片的格式。 - JPG/JPEG图片“decodeFormat”默认参数为“YUV_SP_420”，可自行设置该参数。 - 对于PNG图片，“decodeFormat”仅在输入图片通道是RGB/GRAY格式时，配置BGR_888会生效；其余情况设置该参数无效，将按PNG源格式进行解码，例如： - PNG图片通道为RGB/GRAY格式，则解码输出图片格式为RGB_888。 - PNG图片通道为RGBA/AGRAY格式，则解码输出图片格式为RGBA_8888。
inputPath	输入	输入待解码的图片路径。
outputImage	输出	输出解码后的Image类。 图片宽高和对齐后的宽高会自动合入进“outputImage”内。

返回参数说明

数据结构	说明
APP_ERROR	程序执行返回的错误码，请参考APP_ERROR说明。

父主题： ImageProcessor

Encode

函数功能

ImageProcessor类的图片编码接口，使用该接口申请的Image内存无需用户管理，由内部管理释放。

• 输入图像的最大分辨率：8192 * 8192。
• 输入图像的最小分辨率：32 * 32。
• 输入图像的真实宽、高均为偶数，若为奇数，则自动向上取偶数，编码出的图片自动补边1像素。
• 输入图像的宽：对于YUV420SP或RGB数据，对齐到16。
• 输入图像的高：与输入图片的高度相同的数值，或为输入图片的高度向上对齐到16的数值（最小为32）。
• 输入图像格式：
  • Atlas 200I/500 A2 推理产品支持YUV_SP_420、YVU_SP_420（nv12、nv21）。
• 输出图片格式：jpeg压缩格式的图片文件，例如*.jpg。

函数原型

APP_ERROR Encode(const Image& inputImage, const std::string savePath, const uint32_t encodeLevel = 100);
APP_ERROR Encode(const Image& inputImage, std::shared_ptr<uint8_t>& outDataPtr, uint32_t& outDataSize, const uint32_t encodeLevel = 100);

参数说明

参数名	输入/输出	说明
inputImage	输入	输入编码前的Image类。Decode接口和其他VPC接口获取的Image类可以直接作为输入。 若是用户自定义构造的Image类，则需要设置图像宽高。
encodeLevel	输入	默认为“100”，输入编码的级别[0, 100]。
savePath	输入	输入编码后保存的图片路径，文件后缀名限制为jpg。
outDataPtr	输出	输出编码后的图片内存数据地址。
outDataSize	输出	输出编码后的图片内存数据大小。

返回参数说明

数据结构	说明
APP_ERROR	程序执行返回的错误码，请参考APP_ERROR说明。

父主题： ImageProcessor

在线提单