函数：dvpp_vpc_convert_color_async

产品支持情况

产品	是否支持
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件	√
Atlas 训练系列产品	x
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√

功能说明

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

函数原型

C函数原型

        
             aclError acldvppVpcConvertColorAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, aclrtStream stream)

python函数

        
             ret = acl.media.dvpp_vpc_convert_color_async(dvpp_channel_desc, input_dvpp_pic_desc, output_dvpp_pic_desc, stream)

参数说明

参数名	说明
dvpp_channel_desc	int，指定通道描述信息的指针地址，与调用acl.media.dvpp_create_channel接口创建通道时指定的“dvpp_channel_desc”保持一致。
input_dvpp_pic_desc	int，输入图片信息的指针地址。调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。调用acl.media.dvpp_set_pic_desc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
output_dvpp_pic_desc	int，输出图片信息的指针地址。作为输入时，需要用户调用如下接口：调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。调用acl.media.dvpp_set_pic_desc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。需指定输出图片的宽、高、宽Stride、高Stride、内存地址、内存大小、格式等。配置输出图片的宽、高时，需与输入图片的宽、高保持一致，否则会返回报错。如果将输出图片的宽或高配置为0，则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高；同时，VPC内部会按对齐要求计算宽Stride、高Stride，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。配置输出图片的宽Stride、高Stride时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。
stream	int，指定Stream对象。

返回值说明

返回值	说明
ret	int，错误码，返回0表示成功，返回其它值表示失败。

约束说明

输入、输出图片分辨率为10 * 6 ~ 4096 * 4096（包括4096）。
输入、输出图片的格式请参见图片格式、宽高对齐、内存约束。
Atlas 推理系列产品上，当输入格式是YUV400时，输出格式只能是YUV400。

资源参考

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

父主题： VPC功能