hi_mpi_vpc_destroy_chn
约束说明
图片分辨率约束
-
输入图片分辨率
VPC处理图片时，通用的输入分辨率范围为10*6~8192*8192，其中部分接口的分辨率限制可能不同，请以具体接口内的说明为准，请参见VPC图像处理功能下各接口的说明。其中，当输入图片格式为YUV440SP、YUV440P时，输入图片的宽最大值为4096。
-
输出图片分辨率
版本 分辨率范围 Atlas 200/500 A2推理产品 10*6~4096*8192
内存申请/释放接口说明
输入、输出内存大小要求请参见图片格式、宽高对齐、内存约束中的计算公式。
| 版本 | 内存申请接口 |
|---|---|
| Atlas 200/500 A2推理产品 | VPC在处理图片时，支持以下两种内存申请接口： - 调用aclrtMalloc[aclrtFree](./aclcppdevg_03_0101.md)接口申请\释放Device上的输入、输出内存，这部分内存的生命周期由用户自行管理。 - 调用hi_mpi_dvpp_malloc[hi_mpi_dvpp_free](./aclcppdevg_03_0726.md)接口申请\释放Device上的输入、输出内存，这部分内存的生命周期由用户自行管理。 注意：调用hi_mpi_dvpp_malloc接口申请的内存为媒体数据处理的专用内存，但专用内存的地址空间有限，若关注内存规划或内存资源有限时，建议调用aclrtMalloc接口申请内存。 |
图片格式、宽高对齐、内存约束
:::note 说明 在调用接口实现VPC功能时：
- 图片格式的定义请参见hi_pixel_format，宽stride、高stride等概念请参见基本概念。
- 不同版本中，宽stride、高stride的最小值、最大值不同，如下：
- Atlas 200/500 A2推理产品上，宽stride最小10、高stride最小6。
- 各接口对图片格式的要求可能不同，请参见VPC图像处理功能下各接口的说明。 :::
表1 输入图片格式、宽高对齐、内存大小约束
版本 | 图片格式 | 图片宽、高对齐要求 | 图片宽stride、高stride对齐要求 Atlas 200/500 A2推理产品 | 内存大小要求（单位Byte） |
|---|---|---|---|---|
通用格式，各版本都支持 | YUV400 8bit | 无对齐要求 | 宽stride无对齐要求，与宽相同即可； 高stride无对齐要求，与高相同即可。 | 宽stride * 高stride |
YUV420SP NV12 8bit YUV420SP NV21 8bit | 宽2对齐 高2对齐 | 宽stride无对齐要求，与宽相同即可； 高stride为高2对齐后的值。 | 宽stride * 高stride * 3/2 | |
YUV422SP 8bit YVU422SP 8bit | 宽2对齐 高无对齐要求 | 宽stride无对齐要求，与宽相同即可； 高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 2 | |
YUV444SP 8bit YVU444SP 8bit | 无对齐要求 | 宽stride无对齐要求，与宽相同即可； 高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 3 | |
YUV422Packed YUYV 8bit YUV422Packed UYVY 8bit YUV422Packed YVYU 8bit YUV422Packed VYUY 8bit | 宽2对齐 高无对齐要求 | 宽stride为宽*2的值； 高stride无对齐要求，与高相同即可。 | 宽stride * 高stride | |
YUV444Packed 8bit RGB888 BGR888 | 无对齐要求 | 宽stride为宽*3的值； 高stride无对齐要求，与高相同即可。 | 宽stride * 高stride | |
ARGB8888 ABGR8888 RGBA8888 BGRA8888 | 无对齐要求 | 宽stride为宽*4的值； 高stride无对齐要求，与高相同即可。 | 宽stride * 高stride | |
YUV440SP 8bit YVU440SP 8bit | 宽无对齐要求，但宽≤4096 高2对齐 | 宽stride无对齐要求，与宽相同即可； 高stride为高2对齐后的值。 | 宽stride * 高stride * 2 | |
该部分格式仅以下版本支持： Atlas 200/500 A2推理产品 | YVU420Planar YUV420Planar | 宽2对齐，高2对齐 | 宽stride无对齐要求，与宽相同即可；高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 3/2 |
YVU422Planar YUV422Planar | 无对齐要求 | 宽stride无对齐要求，与宽相同即可；高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 2 | |
YVU444Planar YUV444Planar | 无对齐要求 | 宽stride无对齐要求，与宽相同即可；高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 3 | |
YVU444Packed 8bit | 无对齐要求 | 宽stride无对齐要求，宽stride为宽*3的值；高stride无对齐要求，与高相同即可。 | 宽stride * 高stride | |
YUV440Planar YVU440Planar | 宽无对齐要求，但宽≤4096 高2对齐 | 宽stride无对齐要求，与宽相同即可；高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 2 | |
RGB888Planar BGR888Planar | 无对齐要求 | 宽stride无对齐要求，与宽相同即可；高stride无对齐要求，与高相同即可。 | 宽stride * 高stride * 3 |
|
- |
图片格式 |
图片宽、高对齐要求 |
图片宽stride、高stride对齐要求 Atlas 200/500 A2推理产品 |
内存大小要求（单位Byte） |
|---|---|---|---|---|
|
通用格式，各版本都支持 |
YUV400 8bit |
无对齐要求 |
宽stride无对齐要求，与宽相同即可； 高stride无对齐要求，与高相同即可。 |
宽stride * 高stride |
|
YUV420SP NV12 8bit YUV420SP NV21 8bit |
宽2对齐 高2对齐 |
宽stride无对齐要求，与宽相同即可； 高stride为高2对齐后的值。 |
宽stride * 高stride * 3/2 | |
|
YUV422SP 8bit YVU422SP 8bit |
宽2对齐 高无对齐要求 |
宽stride无对齐要求，与宽相同即可； 高stride无对齐要求，与高相同即可。 |
宽stride * 高stride * 2 | |
|
YUV444Packed 8bit RGB888 BGR888 |
无对齐要求 |
宽stride为宽*3的值； 高stride无对齐要求，与高相同即可。 |
宽stride * 高stride | |
|
ARGB8888 ABGR8888 RGBA8888 BGRA8888 |
无对齐要求 |
宽stride为宽*4的值； 高stride无对齐要求，与高相同即可。 |
宽stride * 高stride | |
|
该部分格式仅以下版本支持： Atlas 200/500 A2推理产品 |
YUV422Packed YUYV 8bit YUV422Packed UYVY 8bit YUV422Packed YVYU 8bit YUV422Packed VYUY 8bit |
宽无对齐要求 高2对齐 |
宽stride为宽*2的值； 高stride无对齐要求，与高相同即可。 |
宽stride * 高stride |
|
该部分格式仅以下版本支持： Atlas 200/500 A2推理产品 |
YVU444Packed |
无对齐要求 |
宽stride为宽*3的值； 高stride无对齐要求，与高相同即可。 |
宽stride * 高stride |
|
RGB888Planar BGR888Planar |
无对齐要求 |
宽stride无对齐要求，与宽相同即可；高stride无对齐要求，与高相同即可。 |
宽stride * 高stride * 3 |
抠图、贴图约束
-
抠图区域不超出输入图片区域。
-
抠图、贴图区域的奇数、偶数限制为：
输出图片格式为YUV420SP，贴图区域奇数、偶数限制为：左偏移和上偏移为偶数、右偏移和下偏移为奇数。
输出图片格式为YUV422SP，贴图区域奇数、偶数限制为：左偏移为偶数、右偏移为奇数。
其它格式，贴图区域没有偏移奇偶数的限制。
-
贴图区域不超出输出图片区域，最大贴图个数256个。
YUV格式图像下采样约束
VPC在处理图片时，会根据输入或输出图片格式，将输入图片格式转换为YUV444或RGB用于内部处理，YUV444或RGB没有宽高奇偶数的限制，但当输出图片格式为YUV420SP或YUV422SP格式时，会进行下采样处理，由于YUV420SP或YUV422SP格式本身的数据排布导致宽高存在奇偶数限制，因此输出图片的边缘可能存在异常数据。
图1 异常效果图片举例
出现异常数据的根因在于，在计算过程中，出现输出图片位置处于奇数起始点时，此时YUV444格式的图片是正确的，但是下采样到YUV420SP格式时，由于奇数行和偶数行是共用同一个uv的，导致图片起始行的Y与上一行的UV组成新的像素，产生异常数据。
父主题： VPC图像处理功能
性能指标说明
性能指标说明（Atlas 200/500 A2推理产品）
单个Device场景下的性能指标参考如下（1路对应一个通道，一个通道对应一个线程，或者n路对应一个通道，一个通道对应n个线程）：
| 场景举例 | 总帧率 |
|---|---|
| - 输入图片分辨率：1080p（1920*1080） - 输出图片分辨率：1080p（1920*1080） - 输入/输出图片格式：YUV420SP - n路（n<2） | n*800fps |
| - 输入图片分辨率：1080p（1920*1080） - 输出图片分辨率：1080p（1920*1080） - 输入/输出图片格式：YUV420SP - n路（n≥2） | 1600fps |
| - 输入图片分辨率：4K图像（3840*2160） - 输出图片分辨率：4K图像（3840*2160） - 输入/输出图片格式：YUV420SP - n路（n<2） | n*200fps |
| - 输入图片分辨率：4K图像（3840*2160） - 输出图片分辨率：4K图像（3840*2160） - 输入/输出图片格式：YUV420SP - n路（n≥2） | 400fps |
| - 输入图片分辨率：8K图像（7680*4320） - 输出图片分辨率：4K图像（3840*2160） - 输入/输出图片格式：YUV420SP - n路（n<2） | n*100fps |
| - 输入图片分辨率：8K图像（7680*4320） - 输出图片分辨率：4K图像（3840*2160） - 输入/输出图片格式：YUV420SP - n路（n≥2） | 200fps |
:::note 说明
- VPC处理性能与处理过程中的图像分辨率强相关，以输入图像和输出图像中的最大分辨率作为基准分辨率，基准分辨率越大，处理耗时越久，性能越低。
- 调用VPC批处理接口（接口命名中包含batch，例如hi_mpi_vpc_batch_crop_resize_paste接口）时，由于图像处理单元DVPP（Digital Video Pre-Processing）内部多个VPC硬件单元会并行处理图片任务，因此单路就可以达到最大总帧率。 :::
父主题： VPC图像处理功能
hi_mpi_vpc_create_chn
函数功能
根据设置的通道属性创建图像处理通道，由用户指定通道号。
约束说明
- 如果参数attr为空，会返回错误码HI_ERR_VPC_NULL_PTR。
- 在创建图像处理通道之前必须保证通道未创建（或者已经销毁），否则会直接返回失败。
函数原型
hi_s32 hi_mpi_vpc_create_chn(hi_vpc_chn chn, const hi_vpc_chn_attr *attr)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 （说明：对于 Atlas 200/500 A2推理产品 ， 昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多128。） |
| attr | 输入 | 图片处理通道属性指针。 |
返回值说明
- 0：成功
- 非0：失败，参见VPC图像处理返回码
参考资源
接口调用流程及示例，参见VPC图片处理典型功能。
父主题： VPC图像处理功能
hi_mpi_vpc_destroy_chn
函数功能
销毁创建的图像处理通道。
约束说明
通道号不能超出最大的通道号范围。
函数原型
hi_s32 hi_mpi_vpc_destroy_chn(hi_vpc_chn chn)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 |
返回值说明
- 0：成功
- 非0：失败，参见VPC图像处理返回码
参考资源
接口调用流程及示例，参见VPC图片处理典型功能。
父主题： VPC图像处理功能
hi_mpi_vpc_resize
函数功能
对图像进行按照一定比例进行缩放或者缩放到固定尺寸。异步接口。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 使用本接口对输入、输出图片分辨率的要求如下： - 输入图片分辨率：10*6 - 输出图片分辨率：10*6 - 关于图片格式、宽高对齐、内存等约束，请参见图片格式、宽高对齐、内存约束。 - 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。 - 设置fx/fy之后，缩放后的图片的分辨率必须在[10*6~16384*16384]范围内，否则返回错误。 - 缩放可以通过fx/fy或者目标图片宽高两种方式来指定，但是两者均配置以目标尺寸缩放优先。两者不可同时为0。 |
函数原型
hi_s32 hi_mpi_vpc_resize(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_pic_info *dest_pic, hi_double fx, hi_double fy, hi_u32 interpolation, hi_u32 *task_id, hi_s32 milli_sec)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 |
| source_pic | 输入 | 原始图片信息的指针。 |
| dest_pic | 输入 | 目标图片信息的指针。 |
| fx | 输入 | 宽的缩放比例。 |
| fy | 输入 | 高的缩放比例。 |
| interpolation | 输入 | 缩放算法。此处配置的缩放算法建议与训练模型时的缩放算法保持一致。 Atlas 200/500 A2推理产品，支持如下缩放算法： - 0：业界通用的Bilinear算法（与OpenCV-3.4.2版本算法的计算结果相同） - 1：业界通用的Nearest neighbor 算法（与OpenCV-3.4.2版本算法的计算结果相同） |
| task_id | 输出 | 任务ID的指针，用来区分任务。 |
| milli_sec | 输入 | 超时时间配置，单位是毫秒，取值范围如下： - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |
返回值说明
- 0：成功
- 非0：失败，参见VPC图像处理返回码
参考资源
接口调用流程及示例，参见VPC图片处理典型功能。
父主题： VPC图像处理功能
hi_mpi_vpc_crop
函数功能
按照指定区域从一张输入图片中抠出一张或多张子图。异步接口。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于图片分辨率、图片格式、宽高对齐、内存等约束，请参见约束说明。 - 单张1080P的图像处理超时时间建议设置3ms，以此类推，如果是2张1080P的图像，建议设置超时间为6ms；如果是3张1080P图片，建议设置超时时间为9ms。其他分辨率，按照图像尺寸进行近似的等价折算，例如，3840*2160分辨率的图像建议超时时间设置为12ms。 |
函数原型
hi_s32 hi_mpi_vpc_crop(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_crop_region_info crop_info[], hi_u32 count, hi_u32 *task_id, hi_s32 milli_sec)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 |
| source_pic | 输入 | 原始图片信息的指针。 |
| crop_info | 输入 | 抠图图片信息数组，该数组长度与count参数值保持一致。 |
| count | 输入 | 抠图区域的数量，取值范围[1,256]。 |
| task_id | 输出 | 任务ID的指针，用来区分任务。 |
| milli_sec | 输入 | 超时时间配置，单位是毫秒，取值范围如下： - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |
返回值说明
- 0：成功
- 非0：失败，参见VPC图像处理返回码
参考资源
接口调用流程及示例，参见VPC图片处理典型功能。
父主题： VPC图像处理功能
hi_mpi_vpc_crop_resize
函数功能
从一张大图中扣出一张或多张子图，并缩放到指定尺寸。异步接口。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于图片分辨率、图片格式、宽高对齐、内存等约束，请参见约束说明。 - 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。 - 若是crop的宽高与resize之后的宽高一致，则不进行缩放；resize宽高必须与输出宽高一致。 |
函数原型
hi_s32 hi_mpi_vpc_crop_resize(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_crop_resize_region crop_resize_info[], hi_u32 count, hi_u32 *task_id, hi_s32 milli_sec)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 |
| source_pic | 输入 | 原始图片信息的指针。 |
| crop_resize_info | 输入 | 抠图并缩放的图片信息数组，该数组长度与count参数值保持一致。 |
| count | 输入 | 抠图并缩放的图片数量，取值范围[1,256]。 |
| task_id | 输出 | 任务ID的指针，用来区分任务。 |
| milli_sec | 输入 | 超时时间配置，单位是毫秒，取值范围如下： - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |
返回值说明
- 0：成功
- 非0：失败，参见VPC图像处理返回码
父主题： VPC图像处理功能
在线提单