Resize
InitPngDecodeChannel
函数功能
初始化PNGD图像通道，用于PNG图片解码。
函数原型
APP_ERROR InitPngDecodeChannel(const PngDecodeChnConfig& config = PNG_DECODE_CHN_CONFIG);
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| config | 输入 | 通道配置参数，默认值为“PNG_DECODE_CHN_CONFIG”。 对应数据结构参见如下（当前预留）。 text<br>struct PngDecodeChnConfig {}; <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。
-
输入输出Image类支持的图像格式参考如下。
- Atlas 200I/500 A2 推理产品 支持YUV_SP_420、YVU_SP_420（nv12、nv21）。
-
“inputImage”的真实图片分辨率范围：18 * 6 ~ 4096 * 4096，其中YUV_SP_420 和 YVU_SP_420格式的宽高可达到 8192 * 8192。
-
参数“resize”的最大分辨率：4096 * 4096，最小分辨率：32 * 6。
-
“outputImage”宽自动与16对齐，高与2对齐，因此宽高范围为：32 * 6 ~ 4096 * 4096。
-
缩放后图片的宽高不能超出真实图片的[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
须知
Atlas 200/300/500 推理产品暂不支持。
函数功能
ImageProcessor类的图像补边接口，使用该接口申请的Image内存无需用户管理，由内部管理释放。
-
输入输出Image类支持的图像格式为YUV_SP_420、YVU_SP_420、RGB_888、BGR_888（nv12、nv21、rgb、bgr），其中RGB（BGR）图像格式分辨率不超过（4096 * 4096）。
-
“inputImage”的真实图片分辨率范围：18 * 6 ~ 4096 * 4096。
-
当前接口仅支持“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，超出范围，因此会补边失败。
-
“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
Crop
函数功能
ImageProcessor类的图像抠图接口，使用该接口申请的Image内存无需用户管理，由内部管理释放，抠图效果示意图请参见图1。
输入输出Image类支持的图像格式参考如下。
- Atlas 200I/500 A2 推理产品 支持YUV_SP_420、YVU_SP_420（nv12、nv21）。
-
“inputImage”的真实图片分辨率范围：18 * 6 ~ 4096 * 4096，其中 YUV_SP_420 和 YVU_SP_420 格式的分辨率为18 * 6 ~ 8192 * 8192。
-
抠图区域不超出输入图片区域，输入抠图坐标框“cropRect”的四个值推荐均为偶数。
除RGB、BGR以外，若包含奇数，则左上角坐标自动向下取偶数，右下角坐标自动向上取偶数。
抠图区域的最大分辨率为4096 * 4096，最小分辨率为18 * 6。
例如：cropRect{1, 1, 1287, 1287}，实际抠图宽高为：((1287 + 1) - (1 - 1))= 1288，对应的分辨率为1288 * 1288。
-
输出“outputImageVec”中，各项图片的宽自动与16对齐， 高与2对齐，范围为：32 * 6 ~ 4096 * 4096。
批量输入图片的抠图场景，输入图片数量不超过12张，抠图配置参数“cropRectVec”长度不超过256，输出图片张数不超过256且应满足输出图片张数 = 输入图片张数 * 抠图配置参数“cropRectVec”长度。
图1 抠图
函数原型
APP_ERROR Crop(const Image& inputImage, const Rect& cropRect, Image& outputImage);
APP_ERROR Crop(const Image& inputImage, const Rect& cropRect, Image& outputImage, AscendStream& stream);
APP_ERROR Crop(const Image& inputImage, const std::vector<Rect>& cropRectVec, std::vector<Image>& outputImageVec);
APP_ERROR Crop(const Image& inputImage, const std::vector<Rect>& cropRectVec, std::vector<Image>& outputImageVec, AscendStream& stream);
APP_ERROR Crop(const std::vector<Image>& inputImageVec, const std::vector<Rect>& cropRectVec, std::vector<Image>& outputImageVec);
APP_ERROR Crop(const std::vector<Image>& inputImageVec, const std::vector<Rect>& cropRectVec, std::vector<Image>& outputImageVec, AscendStream& stream);
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| inputImage | 输入 | 输入抠图前的Image类。 Decode接口和其他VPC接口获取的Image类可以直接作为输入。若是用户自定义构造的Image类，则需要设置图像宽高。 |
| inputImageVec | 输入 | 输入抠图前的Image类列表（针对批量抠图场景）。 |
| cropRect | 输入 | 输入图像的抠图坐标框。 |
| cropRectVec | 输入 | 输入图像的抠图坐标框列表（针对批量抠图场景）。 |
| outputImage | 输出 | 输出抠图后的Image类。 |
| outputImageVec | 输出 | 输出抠图后的Image类列表（针对批量抠图场景）。 |
| stream | 输入 | 输入用于异步执行的Stream，具体请参见AscendStream。 |
返回参数说明
| 数据结构 | 说明 |
|---|---|
| APP_ERROR | 程序执行返回的错误码，请参考APP_ERROR说明。 |
父主题： ImageProcessor
CropResize
函数功能
ImageProcessor类的图像抠图并缩放接口，使用该接口申请的Image内存无需用户管理，由内部管理释放，抠图缩放效果示意图请参见图1。
输入输出Image类支持的图像格式参考如下。
- Atlas 200I/500 A2 推理产品 支持YUV_SP_420、YVU_SP_420（nv12、nv21）。
-
“inputImage”的真实图片宽高大小范围：18 * 6 ~ 4096 * 4096，其中YUV_SP_420和YVU_SP_420格式的宽高可达到8192 * 8192。
-
抠图区域的最小为10 * 6，抠图区域不能超出输入图片的真实图片宽高，输入“cropRect”的四个值推荐均为偶数。
除RGB、BGR以外，若包含奇数，则左上角坐标自动向下取偶数，右下角坐标自动向上取偶数。
输出Image类的最大分辨率为4096 * 4096，最小分辨率为18 * 6。
例如：cropRect{1, 1, 1287, 1287} ，实际抠图宽高为：((1287 + 1) - (1 - 1))= 1288，对应的分辨率为1288 * 1288。
-
缩放的范围为18 * 6 ~ 4096 * 4096，不能超出抠图区域的[1/32, 16]倍数区间。
-
输出“outputImageVec”中，各项图片的宽自动与16对齐， 高与2对齐，范围为：32 * 6 ~ 4096 * 4096。
图1 抠图缩放
函数原型
APP_ERROR CropResize(const Image& inputImage, const std::vector<Rect>& cropRectVec, const Size& resize, std::vector<Image>& outputImageVec);
APP_ERROR CropResize(const Image& inputImage, const std::vector<Rect>& cropRectVec, const Size& resize, std::vector<Image>& outputImageVec, AscendStream& stream);
APP_ERROR CropResize(const Image& inputImage, const std::vector<std::pair<Rect, Size>>& cropResizeVec, std::vector<Image>& outputImageVec);
APP_ERROR CropResize(const Image& inputImage, const std::vector<std::pair<Rect, Size>>& cropResizeVec, std::vector<Image>& outputImageVec, AscendStream& stream);
APP_ERROR CropResize(const std::vector<Image>& inputImageVec, const std::vector<std::pair<Rect, Size>>& cropResizeVec, std::vector<Image>& outputImageVec);
APP_ERROR CropResize(const std::vector<Image>& inputImageVec, const std::vector<std::pair<Rect, Size>>& cropResizeVec, std::vector<Image>& outputImageVec, AscendStream& stream);
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| inputImage | 输入 | 输入抠图缩放前的Image类。 Decode接口和其他VPC接口获取的Image类可以直接作为输入。若是用户自定义构造的Image类，则需要设置图像宽高和图像对齐后的宽高。 |
| inputImageVec | 输入 | 输入抠图缩放前的Image类列表（针对批量抠图场景）。 Decode接口和其他VPC接口获取的Image类可以直接作为输入。若是用户自定义构造的Image类，则需要设置图像宽高和图像对齐后的宽高。 |
| cropRectVec | 输入 | 输入抠图参数列表，需要与输出图像列表的元素个数一致。 |
| resize | 输入 | 输入统一缩放宽高。 |
| cropResizeVec | 输入 | 输入图像的抠图缩放参数列表。Rect为抠图坐标框，Size为缩放宽高（针对批量抠图缩放场景）。 |
| outputImageVec | 输出 | 输出抠图后的Image类列表（针对批量抠图场景）。 |
| stream | 输入 | 输入用于异步执行的Stream，具体请参见AscendStream。 |
返回参数说明
| 数据结构 | 说明 |
|---|---|
| APP_ERROR | 程序执行返回的错误码，请参考APP_ERROR说明。 |
父主题： ImageProcessor
在线提单