函数功能
按指定区域从一张输入图片中抠出一张子图,再将抠的图片存放到输出内存中,作为输出图片,异步接口。
输出图片区域与cropArea不一致时会对图片再做一次缩放操作。
Atlas 200/300/500 推理产品,默认缩放算法为“自研的高阶滤波算法”。
Atlas 训练系列产品,默认缩放算法为“自研的高阶滤波算法”。
Atlas 推理系列产品,默认缩放算法为“业界通用的Bilinear算法”。
Atlas A2训练系列产品,默认缩放算法为“业界通用的Bilinear算法”。
约束说明
版本 |
约束 |
Atlas 200/300/500 推理产品 Atlas 训练系列产品 |
- 关于输入图片分辨率、图片格式:
- 输入图片分辨率在10*6~4096*4096(包括4096)范围内时,支持图片格式、宽高对齐、内存约束处说明的输入图片格式。
- 输入图片的宽或高在4096~8192(包括8192)范围内时,支持格式如下:
支持 acldvppPixelFormat枚举值中的如下枚举项:
PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit
- 关于输出图片分辨率、图片格式请参见图片格式、宽高对齐、内存约束。
- 关于各图片格式的宽高对齐、内存大小约束,请参见图片格式、宽高对齐、内存约束。
- 由于通过本接口抠的图直接作为输出图片,所以需满足输出图片最大分辨率4096*4096的限制,因此本接口中抠图区域最大分辨率为4096*4096。
|
Atlas 推理系列产品 |
- 关于输入图片分辨率、图片格式:
- 输入图片分辨率在10*6~4096*4096(包括4096)范围内时,支持图片格式、宽高对齐、内存约束处说明的输入图片格式。
- 输入图片的宽或高在4096~8192(包括8192)范围内时,支持格式如下:
支持 acldvppPixelFormat枚举值中的如下枚举项:
PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit
PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit
PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3, // YUV422SP 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4, // YVU422SP 8bit
PIXEL_FORMAT_YUV_SEMIPLANAR_444 = 5, // YUV444SP 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_444 = 6, // YVU444SP 8bit
PIXEL_FORMAT_YUYV_PACKED_422 = 7, // YUV422Packed YUYV 8bit
PIXEL_FORMAT_UYVY_PACKED_422 = 8, // YUV422Packed UYVY 8bit
PIXEL_FORMAT_YVYU_PACKED_422 = 9, // YUV422Packed YVYU 8bit
PIXEL_FORMAT_VYUY_PACKED_422 = 10, // YUV422Packed VYUY 8bit
- 关于输出图片分辨率、图片格式请参见图片格式、宽高对齐、内存约束。
- 关于各图片格式的宽高对齐、内存大小约束,请参见图片格式、宽高对齐、内存约束。
- 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时,在经过本接口处理后,A分量值会变为0。
- 由于通过本接口抠的图直接作为输出图片,所以需满足输出图片最大分辨率4096*4096的限制,因此本接口中抠图区域最大分辨率为4096*4096。
|
Atlas A2训练系列产品 |
- 关于输入、输出图片分辨率:
- 输入图片分辨率:10*6~8192*8192
- 输出图片分辨率:10*6~4096*8192
- 关于图片格式、宽高对齐、内存等总体约束,请参见图片格式、宽高对齐、内存约束。
- 由于通过本接口抠的图直接作为输出图片,所以需满足输出图片最大分辨率4096*4096的限制,因此本接口中抠图区域最大分辨率为4096*4096。
|
参数说明
参数名 |
输入/输出 |
说明 |
channelDesc |
输入 |
通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。 |
inputDesc |
输入 |
输入图片信息的指针。
|
outputDesc |
输入&输出 |
输出图片信息的指针。 outputDesc参数作为输入时,需要用户调用如下接口:
|
cropArea |
输入 |
抠图区域位置的指针。 调用acldvppCreateRoiConfig接口创建区域位置数据。 |
stream |
输入 |
指定Stream。 |
返回值说明
返回0表示任务下发成功,返回非0表示任务下发失败。