函数功能
按指定区域从一张输入图片中抠出一张子图,再将抠的图片存放到输出内存中,作为输出图片,异步接口。
输出图片区域与cropArea不一致时会对图片再做一次缩放操作,按照resizeConfig处配置的缩放算法。
约束说明
VPC功能中,关于图片分辨率、图片格式、宽高对齐、内存等约束,请参见约束说明。
参数说明
参数名
|
输入/输出
|
说明
|
channelDesc
|
输入
|
通道描述信息的指针。
与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。
|
inputDesc
|
输入
|
输入图片信息的指针。
- 调用acldvppCreatePicDesc接口创建图片描述信息。
- 调用acldvppSetPicDesc系列接口设置图片描述参数(例如,内存地址、内存大小、图片格式、宽、高等)。
- 输入图片分辨率在10*6~4096*4096(包括4096)范围内时,支持图片格式、宽高对齐、内存约束处说明的输入图片格式。
- 输入图片的宽或高在4096~8192(包括8192)范围内时,支持格式如下:
Atlas 200/300/500 推理产品,支持 acldvppPixelFormat枚举值中的如下枚举项: PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit
Atlas 训练系列产品,支持 acldvppPixelFormat枚举值中的如下枚举项: PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit
在 Atlas 推理系列产品上,支持 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
|
outputDesc
|
输入&输出
|
输出图片信息的指针。
outputDesc参数作为输入时,需要用户调用如下接口:
|
cropArea
|
输入
|
抠图区域位置的指针。
调用acldvppCreateRoiConfig接口创建区域位置数据。
|
resizeConfig
|
输入
|
图片缩放配置数据的指针。
需提前调用acldvppCreateResizeConfig接口创建图片缩放配置数据。
|
stream
|
输入
|
指定Stream。
|
返回值说明
返回0表示任务下发成功,返回非0表示任务下发失败。