Documentation

acl.himpi.vpc_crop

C Prototype

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 Function

task_id, ret = acl.himpi.vpc_crop(chn, source_pic, crop_info, count, milli_sec)

Function Usage

Crops one or more ROIs from an image. This API is asynchronous.

The Atlas 200/300/500 Inference Product does not support this API in the current version.

The Atlas Training Series Product does not support this API in the current version.

Input Description

chn: int, image processing channel ID.

source_pic: dict, original image information. For details, see hi_vpc_pic_info. For details about related restrictions, see #EN-US_TOPIC_0000002127918896/section1676152117452.

crop_info: list, cropped image information list. The length is the same as the value of count. For details, see hi_vpc_crop_region_info.

count: int, number of crop ROIs. Must be in the range of [1, 256].

milli_sec: int, timeout interval (ms).
  • -1: blocking mode.
  • 0: non-blocking mode.
  • > 0: timeout interval (timeout mode). The timeout interval varies with the operating system. The deviation is generally within a time slice of an operating system. For example, if the time slice of an operating system is 4 ms and the value of milli_sec is set to 1, the actual timeout interval ranges from 1 ms to 5 ms. When the CPU load is high, the timeout interval may fluctuate.

Return Value

task_id: int, used to identify a task.

ret: int, error code.
Parent topic: VPC APIs