函数功能

实现图片的色彩重映射。异步接口。

Atlas 200/300/500 推理产品，不支持该接口。

Atlas 训练系列产品，不支持该接口。

约束说明

输入图片分辨率为10*6~4096*4096（包括4096）。

输入图片格式支持acldvppPixelFormat枚举值中的如下枚举项：

PIXEL_FORMAT_YUV_400 = 0,              // YUV400 8bit
PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1,   // YUV420SP NV12 8bit   
PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2,   // YUV420SP NV21 8bit 
PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3,   // YUV422SP 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4,   // YVU422SP 8bit
PIXEL_FORMAT_YUV_PACKED_444 = 11,      // YUV444P 8bit
PIXEL_FORMAT_RGB_888 = 12,             // RGB888
PIXEL_FORMAT_BGR_888 = 13,             // BGR888

输出图片分辨率、输出图片格式、widthStride对齐要求、heightStride对齐要求等，必须与输入图片格的要求保持一致。
不同图片格式的对齐要求请参见图片格式、宽高对齐、内存约束。

函数原型

aclError acldvppVpcEqualizeHistAsync(const acldvppChannelDesc *channelDesc,

const acldvppPicDesc *inputDesc,

acldvppPicDesc *outputDesc,

const acldvppLutMap *lutMap,

aclrtStream stream)

参数说明

参数名	输入/输出	说明
channelDesc	输入	通道描述信息的指针。与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。
inputDesc	输入	输入图片信息的指针。调用acldvppCreatePicDesc接口创建图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
outputDesc	输入&输出	输出图片信息的指针。 outputDesc参数作为输入时，需要用户调用如下接口：调用acldvppCreatePicDesc接口创建图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
lutMap	输入	色彩重映射表的指针。调用acldvppCreateLutMap接口创建acldvppLutMap类型的数据（表示色彩重映射表），再调用acldvppGetLutMapData获取内存指针，由用户自行向该内存中写入色彩重映射表数据，写完数据后，再将acldvppLutMap类型的数据作为入参传入acldvppVpcEqualizeHistAsync。
stream	输入	指定Stream。

返回值说明

返回0表示任务下发成功，返回非0表示任务下发失败。