acldvppVpcConvertColorAsync

函数功能

转换图片的格式,输出图片的宽高须与输入图片的宽高一致。异步接口。

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

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

约束说明

函数原型

aclError acldvppVpcConvertColorAsync(acldvppChannelDesc *channelDesc,

acldvppPicDesc *inputDesc,

acldvppPicDesc *outputDesc,

aclrtStream stream)

参数说明

参数名

输入/输出

说明

channelDesc

输入

通道描述信息的指针。

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

inputDesc

输入

输入图片信息的指针。

outputDesc

输入&输出

输出图片信息的指针。

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

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

    需指定输出图片的宽、高、宽stride、高stride、内存地址、内存大小、格式等。

    • 配置输出图片的宽、高时,需与输入图片的宽、高保持一致,否则会返回报错。

      如果将输出图片的宽或高配置为0,则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高;同时,VPC内部会按对齐要求计算宽stride、高stride,不同图片格式的对齐要求不同,请参见图片格式、宽高对齐、内存约束

    • 配置输出图片的宽stride、高stride时,满足对齐要求即可,不同图片格式的对齐要求不同,请参见图片格式、宽高对齐、内存约束

stream

输入

指定Stream。

返回值说明

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

参考资源

接口调用示例,参见格式转换示例代码