Function: dvpp_vpc_batch_crop_and_paste_async

Applicability

Product	Supported
Ascend 950PR / Ascend 950DT	x
Atlas A3 training products / Atlas A3 inference products	√
Atlas A2 training products / Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Description

Crops one or more ROIs from one or more images and pastes each cropped image to the canvas for output. This API is asynchronous.

Prototype

C Prototype

        
             aclError acldvppVpcBatchCropAndPasteAsync(acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDesc, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDesc, acldvppRoiConfig *cropAreas[], acldvppRoiConfig *pasteAreas[], aclrtStream stream)

Python Function

        
             dst_batch_pic_descs, ret = acl.media.dvpp_vpc_batch_crop_and_paste_async(dvpp_channel_desc, src_batch_pic_descs, roi_nums_list, dst_batch_pic_descs, crop_area_list, paste_area_list, stream)

Parameters

Parameter	Description
dvpp_channel_desc	Int, pointer address of the channel description. The value must be the same as that of dvpp_channel_desc specified when the acl.media.dvpp_create_channel API is called to create a channel.
src_batch_pic_descs	Int, pointer address of the description of batch input images. Call the acl.media.dvpp_create_batch_pic_desc API to create the description of batch images. Call the acl.media.dvpp_get_pic_desc API to obtain the description of a specified image. Call the acl.media.dvpp_set_pic_desc APIs to set the image description (including the buffer address, buffer size, image format, and image resolution).
roi_nums_list	List, list of number of cropped images, up to 256. The value of roi_nums_list is less than or equal to 256, which is the same as the value of batch_size in dst_batch_pic_descs. (roi_nums_list[0] + ... + roi_nums_list[size - 1] <= 256)
dst_batch_pic_descs	Int, pointer address of the description of batch output images. Call the acl.media.dvpp_create_batch_pic_desc API to create the description of batch images. Call the acl.media.dvpp_get_pic_desc API to obtain the description of a specified image. Call the acl.media.dvpp_set_pic_desc APIs to set the image description (including the buffer address, buffer size, image format, and image resolution).
crop_area_list	List, list of the position of the cropping area. Call acl.media.dvpp_create_roi_config to create an ROI configuration. The number of elements in crop_area and paste_area is the same as that of batch_size in dst_batch_pic_descs.
paste_area_list	List, list of the position of the paste ROI. Call acl.media.dvpp_create_roi_config to create an ROI configuration. Round up the left offset of the paste ROI to the nearest multiple of 16. The number of elements in crop_area and paste_area is the same as that of batch_size in dst_batch_pic_descs.
stream	Int, stream object.

Return Value

Return Value	Description
dst_batch_pic_descs	Int, pointer address of the description of batch output images.
ret	Int, error code. 0 on success; else, failure.

Reference

For the API call example, see Sample Code for Image Cropping and Pasting (Single-Image, Single-ROI).

Parent topic: VPC