函数功能
按指定区域从一个输入图片中抠出一张子图,再将抠的子图贴到目标图片的指定位置,作为输出图片。异步接口。
当pasteArea的宽高与cropArea的宽高不一致时会对图片做一次缩放操作。
Atlas 200/300/500 推理产品,默认缩放算法为“自研的高阶滤波算法”。
Atlas 训练系列产品,默认缩放算法为“自研的高阶滤波算法”。
Atlas 推理系列产品,默认缩放算法为“业界通用的Bilinear算法”。
约束说明
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接口创建区域位置数据。
|
pasteArea
|
输入
|
贴图区域位置的指针。
|
stream
|
输入
|
指定Stream。
|
返回值说明
返回0表示任务下发成功,返回非0表示任务下发失败。