acl.himpi.vpc_crop

c函数原型	*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);*
Python函数	task_id, ret = acl.himpi.vpc_crop(chn, source_pic, crop_info, count, milli_sec)
函数功能	从一张输入图片中抠出一张或多张子图。昇腾310 AI处理器，当前版本该接口预留。昇腾910 AI处理器，当前版本该接口预留。
输入说明	chn：图片处理通道号，取值范围：[0, 255]。 source_pic: 原始图片信息。输入在106~40964096（包括4096）时，支持VPC功能处说明的输入图片格式。输入在40964096~81928192（包括8192）时，支持格式如下： YUV420 semi-planar/YVU420 semi-planar YUV422 semi-planar/YVU422 semi-planar YUV400 YUV444 semi-planar/YVU444 semi-planar YUYV422 packed/YVYU422 packed/UYVY422 packed/VYUY422 packed crop_info：抠图图片信息数组，该数组长度与count参数值保持一致。 count: 抠图区域的数量，取值范围[1,256]。 milli_sec：超时时间配置，单位是毫秒，取值范围如下： -1：阻塞方式 0：非阻塞方式 >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。
返回值说明	ret： 0：成功非0：失败，参见VPC图像处理返回码 task_id：此次任务分配的ID，用来区分任务。
使用说明	无
注意事项	通道号不能超出最大的通道号范围。抠图的区域数量不能大于256个，抠图数量必须和数组有效信息匹配。接口是异步接口。单张1080P的图像处理超时时间建议设置3ms，以此类推，如果是2张1080P的图像，建议设置超时间为6ms；如果是3张1080P图片，建议设置超时时间为9ms。其他分辨率，按照图像尺寸进行近似的等价折算，例如，3840*2160分辨率的图像建议超时时间设置为12ms。
使用场景	需要按照指定区域从输入图像中抠图。

父主题： VPC图像处理接口