Skip to main content

Decode

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

Resize​

函数功能​

ImageProcessor类的图像缩放接口，使用该接口申请的Image内存无需用户管理，由内部管理释放，缩放效果示意图请参见图1。

  1. 输入输出Image类支持的图像格式参考如下。

    • Atlas 200I/500 A2 推理产品 支持YUV_SP_420、YVU_SP_420（nv12、nv21）。

  2. “inputImage”的真实图片分辨率范围：18 * 6 ~ 4096 * 4096，其中YUV_SP_420 和 YVU_SP_420格式的宽高可达到 8192 * 8192。

  3. 参数“resize”的最大分辨率：4096 * 4096，最小分辨率：32 * 6。

  4. “outputImage”宽自动与16对齐，高与2对齐，因此宽高范围为：32 * 6 ~ 4096 * 4096。

  5. 缩放后图片的宽高不能超出真实图片的[1/32 ,16]倍数区间。

    图1 缩放

函数原型​

APP_ERROR Resize(const Image& inputImage, const Size& resize, Image& outputImage, const Interpolation interpolation = Interpolation::HUAWEI_HIGH_ORDER_FILTER);
APP_ERROR Resize(const Image& inputImage, const Size& resize, Image& outputImage, const Interpolation interpolation, AscendStream& stream);

参数说明​

参数名输入/输出说明
inputImage输入输入缩放前的Image类。Decode接口和其他VPC接口获取的Image类可以直接作为输入。若是用户自定义构造的Image类，则需要设置图像宽高和图像对齐后的宽高。
resize输入输入图像缩放的宽高。
interpolation输入输入图像的缩放方式，可选参数参见如下。
text<br>HUAWEI_HIGH_ORDER_FILTER = 0<br>BILINEAR_SIMILAR_OPENCV = 1<br>NEAREST_NEIGHBOR_OPENCV = 2<br>BILINEAR_SIMILAR_TENSORFLOW = 3<br>NEAREST_NEIGHBOR_TENSORFLOW = 4<br>
Atlas 200I/500 A2 推理产品
支持以下算法（默认为0）。
- 0：华为自研的高滤波算法。
- 1：业界通用的Bilinear算法（与OpenCV算法的计算精度接近）。
- 2：业界通用的Nearest neighbor算法（与OpenCV算法的计算精度接近）。
- 3：业界通用的Bilinear算法（与Tensorflow框架的计算精度接近）。
- 4：业界通用的Nearest neighbor算法（与Tensorflow框架的计算精度接近）。
outputImage输出输出缩放后的Image类。
stream输入输入用于异步执行的Stream，具体请参见AscendStream。

返回参数说明​

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

父主题： ImageProcessor

Padding​

note

须知

Atlas 200/300/500 推理产品暂不支持。

函数功能​

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

  1. 输入输出Image类支持的图像格式为YUV_SP_420、YVU_SP_420、RGB_888、BGR_888（nv12、nv21、rgb、bgr），其中RGB（BGR）图像格式分辨率不超过（4096 * 4096）。

  2. “inputImage”的真实图片分辨率范围：18 * 6 ~ 4096 * 4096。

  3. 当前接口仅支持“BORDER_CONSTANT”补边方式，其余补边方式预留接口。

    YUV_SP_420和YVU_SP_420格式，补边尺寸建议为偶数，当补边尺寸为奇数时，会自动进行向上对齐。

    例如，用户输入补边尺寸为(1, 1, 1, 1)，将自动对齐到(2, 2, 2, 2)，上下左右各补2个像素点。

    当输入图片分辨率为4095 * 4095，补边尺寸为(1, 0, 1, 0)时，由于自动对齐后的补边尺寸为4097 * 4097，超出范围，因此会补边失败。

  4. “outputImage”分辨率为18 * 6 ~ 4096 * 4096，宽自动与16对齐，高与2对齐，范围为32 * 6 ~ 4096 * 4096。

函数原型​

APP_ERROR Padding(const Image& inputImage, Dim &padDim, const Color& color, const BorderType borderType, Image& outputImage);

参数说明​

参数名输入/输出说明
inputImage输入输入补边前的Image类。Decode接口和其他VPC接口获取的Image类可以直接作为输入。若是用户自定义构造的Image类，则需要设置图像宽高和图像对齐后的宽高。
padDim输入输入图像补边的尺寸。
color输入输入补边三通道颜色值，仅在“borderType”设置为“BORDER_CONSTANT”时有效。
borderType输入输入补边方式，具体实现请参见BorderType。
outputImage输出输出缩放后的Image类。

返回参数说明​

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

父主题： ImageProcessor

在线提单