acl.himpi.vpc_equalize_hist

C Prototype	*hi_s32 hi_mpi_vpc_equalize_hist(hi_vpc_chn chn, const hi_vpc_pic_info source_pic, hi_vpc_pic_info* dest_pic, const hi_vpc_lut_remap lut_remap, hi_u32 task_id, hi_s32 milli_sec);**
Python Function	task_id, ret = acl.himpi.vpc_equalize_hist(chn, source_pic, dest_pic, lut_remap, milli_sec)
Function Usage	Remaps the specified pixel value of the specified component in the source image to another pixel value to form the destination image, which is usually used for image enhancement. The purpose is to increase the contrast and definition of 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. Input image information. For details, see hi_vpc_pic_info. For details about related restrictions, see Restrictions. dest_pic: dict, destination image information. For details, see hi_vpc_pic_info. The destination image has the same format as the source image. lut_remap: dict, configuration of the image lut_remap. For details, see hi_vpc_lut_remap. lut_remap is a 768-byte configuration array for hardware-based pixel remapping. 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	ret: int, error code. 0 indicates success. Other values: failure. For details, see VPC Return Codes. task_id: task ID, used to identify a task.

Restrictions

Input image resolution: (10 x 6, 4096 x 4096].

The following enum values of hi_pixel_format are supported for the source image format:

HI_PIXEL_FORMAT_YUV_400 = 0,              // YUV400 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1,   // YUV420SP NV12 8bit   
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2,   // YUV420SP NV21 8bit 
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3,   // YUV422SP 8bit
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4,   // YVU422SP 8bit
HI_PIXEL_FORMAT_YUV_PACKED_444 = 11,      // YUV444P 8bit
HI_PIXEL_FORMAT_RGB_888 = 12,             // RGB888
HI_PIXEL_FORMAT_BGR_888 = 13,             // BGR888

The destination image has the same format as the source image.
For details about the restrictions on the width and height alignment, buffer size, and image format, see Restrictions on Image Formats, Width and Height Alignment, and Buffers.

Parent topic: VPC APIs