函数：dvpp_vpc_pyr_down_async

产品支持情况

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

功能说明

对图像进行金字塔缩放，将输出图片缩放为输入图片的一半。异步接口。

函数原型

C函数原型

aclError acldvppVpcPyrDownAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, void *reserve, aclrtStream stream)

python函数

ret = acl.media.dvpp_vpc_pyr_down_async(dvpp_channel_desc, input_dvpp_pic_desc, output_dvpp_pic_desc, reserve, 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时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。
reserve	int，金字塔缩放配置参数的指针地址，预留参数。
stream	int，指定Stream对象。

返回值说明

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

约束说明

关于输入图片
- 输入图片分辨率：20 * 12 ~ 2048 * 2048
- 输入图片格式：PIXEL_FORMAT_YUV_400
关于输出图片
- 输出图像分辨率：输入图像分辨率 / 2
- 图像格式：PIXEL_FORMAT_YUV_400
“PIXEL_FORMAT_YUV_400”图片格式的对齐要求请参见图片格式、宽高对齐、内存约束。

父主题： VPC功能