---
title: acl.himpi.vpc_equalize_hist
description: "| c函数原型 | 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); |"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgp/aclpythondevg_01_0432.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgp/aclpythondevg_01_0432.html
indexId: 4e538e62a60de8801ac98cdb1eb70977c7f2deb1943629b13f09dbfaa0036f9d108
---
# acl.himpi.vpc_equalize_hist

| c函数原型 | 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函数 | task\_id, ret = acl.himpi.vpc\_equalize\_hist(chn, source\_pic, dest\_pic, lut\_remap, milli\_sec) |
| 函数功能 | 将输入图片中指定分量的指定像素值重映射成其它像素值，作为输出图片，主要用户图像增强的场景。通过图片的色彩重映射以达到图片对比度更好，清晰度更好的效果。异步接口。 |
| 输入说明 | chn：int，图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 source\_pic：输入图片信息，相关约束请参见约束说明。 dest\_pic：目标图片信息。输出图片格式与输入图片格式保持一致。 lut\_remap：图像lut\_remap的配置。lut\_remap是一个768 Byte的数组，配置给硬件进行图片像素重映射。 milli\_sec：超时时间配置，单位是毫秒，取值范围如下。 “\-1”：阻塞方式。 “0”：非阻塞方式。 >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli\_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |
| 返回值说明 | ret：int，错误码。 返回0表示成功。 返回非0表示失败，参见VPC图像处理返回码。 task\_id：任务分配的ID，用来区分任务。 |


#### 约束说明

- 输入图片分辨率为10*6~4096*4096（包括4096）。
- 输入图片格式支持  hi_pixel_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
```


- 输出图片格式与输入图片格式保持一致。
- 关于各图片格式的宽高对齐、内存大小约束，请参见  图片格式、宽高对齐、内存约束
。