acldvppVpcEqualizeHistAsync

函数功能

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

昇腾310 AI处理器,当前版本不支持该接口。

函数原型

aclError acldvppVpcEqualizeHistAsync(const acldvppChannelDesc *channelDesc,

const acldvppPicDesc *inputDesc,

acldvppPicDesc *outputDesc,

const acldvppLutMap *lutMap,

aclrtStream stream)

参数说明

参数名

输入/输出

说明

channelDesc

输入

指定通道描述信息,与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。

inputDesc

输入

输入图片信息。

  • 调用acldvppCreatePicDesc接口创建图片描述信息。
  • 调用acldvppSetPicDesc系列接口设置图片描述参数(例如,内存地址、内存大小、图片格式、宽、高等)。
    • 支持输入图片格式如下:

      PIXEL_FORMAT_YUV_400

      PIXEL_FORMAT_YUV_SEMIPLANAR_420

      PIXEL_FORMAT_YVU_SEMIPLANAR_420

      PIXEL_FORMAT_YUV_SEMIPLANAR_422

      PIXEL_FORMAT_YVU_SEMIPLANAR_422

      PIXEL_FORMAT_YUV_PACKED_444

      PIXEL_FORMAT_RGB_888

      PIXEL_FORMAT_BGR_888

    • 输入图片分辨率、输入图片格式、widthStride对齐要求、heightStride对齐要求等,请参见约束说明

outputDesc

输入&输出

输出图片信息。

outputDesc参数作为输入时,需要用户调用如下接口:

  • 调用acldvppCreatePicDesc接口创建图片描述信息。
  • 调用acldvppSetPicDesc系列接口设置图片描述参数(例如,内存地址、内存大小、图片格式、宽、高等)。

    输出图片分辨率、输出图片格式、widthStride对齐要求、heightStride对齐要求等,必须与输入图片格的要求保持一致。

lutMap

输入

色彩重映射表。

调用acldvppCreateLutMap接口创建acldvppLutMap类型的数据(表示色彩重映射表),再调用acldvppGetLutMapData获取内存指针,由用户自行向该内存中写入色彩重映射表数据,写完数据后,再将acldvppLutMap类型的数据作为入参传入acldvppVpcEqualizeHistAsync。

stream

输入

指定Stream。

返回值说明

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