acldvppVpcCalcHistAsync
产品支持情况
产品 |
是否支持 |
|---|---|
√ |
|
√ |
|
√ |
|
√ |
|
x |
|
x |
功能说明
统计图像中每个像素的各颜色分量的分布。
本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，aclrtSynchronizeStream）确保任务已执行完成，否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。
函数原型
aclError acldvppVpcCalcHistAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *srcPicDesc, acldvppHist *hist, void *reserve, aclrtStream stream)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
channelDesc |
输入 |
通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。 |
srcPicDesc |
输入 |
输入图片信息的指针。
|
hist |
输入&输出 |
直方图描述信息的指针。 调用acldvppCreateHist接口创建直方图描述信息作为输入。 调用本接口后，输出每张图像各颜色分量的像素值（0-255）分布情况。 |
reserve |
输入 |
直方图统计配置的指针，预留，当前可填NULL。 |
stream |
输入 |
指定Stream。 |
返回值说明
返回0表示任务下发成功，返回非0表示任务下发失败，请参见aclError。
约束说明
- 关于输入图片分辨率的要求：
型号
约束
Atlas 推理系列产品 输入图片分辨率：[10*6, 4096*4096]。
Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件 Atlas 200I/500 A2 推理产品 输入图片分辨率：[10*6, 4096*8192]。
- 输入图片格式支持acldvppPixelFormat枚举值中的如下枚举项：
PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3, // YUV422SP 8bit PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4, // YVU422SP 8bit PIXEL_FORMAT_YUV_SEMIPLANAR_444 = 5, // YUV444SP 8bit PIXEL_FORMAT_YVU_SEMIPLANAR_444 = 6, // YVU444SP 8bit PIXEL_FORMAT_YUYV_PACKED_422 = 7, // YUV422Packed YUYV 8bit PIXEL_FORMAT_UYVY_PACKED_422 = 8, // YUV422Packed UYVY 8bit PIXEL_FORMAT_YVYU_PACKED_422 = 9, // YUV422Packed YVYU 8bit PIXEL_FORMAT_VYUY_PACKED_422 = 10, // YUV422Packed VYUY 8bit PIXEL_FORMAT_YUV_PACKED_444 = 11, // YUV444P 8bit PIXEL_FORMAT_RGB_888 = 12, // RGB888 PIXEL_FORMAT_BGR_888 = 13, // BGR888 PIXEL_FORMAT_YUV_SEMIPLANAR_440 = 1000, // YUV440SP 8bit PIXEL_FORMAT_YVU_SEMIPLANAR_440 = 1001, // YVU440SP 8bit
- 关于图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。