产品支持情况

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

功能说明

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

本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，aclrtSynchronizeStream）确保任务已执行完成，否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。

函数原型

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

参数说明

参数名	输入/输出	说明
channelDesc	输入	通道描述信息的指针。与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。
inputDesc	输入	输入图片信息的指针。调用acldvppCreatePicDesc接口创建图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
outputDesc	输入&输出	输出图片信息的指针。 outputDesc参数作为输入时，需要用户调用如下接口：调用acldvppCreatePicDesc接口创建图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
reserve	输入	金字塔缩放配置参数的指针，预留参数。
stream	输入	指定Stream。

返回值说明

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

约束说明

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