Skip to main content

hi_mpi_vpc_create_chn

性能指标说明​

性能指标说明（Atlas 200/500 A2推理产品）​

单个Device场景下的性能指标参考如下（1路对应一个通道，一个通道对应一个线程，或者n路对应一个通道，一个通道对应n个线程）：

场景举例总帧率
- 输入图片分辨率：1080p（1920*1080）
- 输出图片分辨率：1080p（1920*1080）
- 输入/输出图片格式：YUV420SP
- n路（n<2）		n*800fps
- 输入图片分辨率：1080p（1920*1080）
- 输出图片分辨率：1080p（1920*1080）
- 输入/输出图片格式：YUV420SP
- n路（n≥2）		1600fps
- 输入图片分辨率：4K图像（3840*2160）
- 输出图片分辨率：4K图像（3840*2160）
- 输入/输出图片格式：YUV420SP
- n路（n<2）		n*200fps
- 输入图片分辨率：4K图像（3840*2160）
- 输出图片分辨率：4K图像（3840*2160）
- 输入/输出图片格式：YUV420SP
- n路（n≥2）		400fps
- 输入图片分辨率：8K图像（7680*4320）
- 输出图片分辨率：4K图像（3840*2160）
- 输入/输出图片格式：YUV420SP
- n路（n<2）		n*100fps
- 输入图片分辨率：8K图像（7680*4320）
- 输出图片分辨率：4K图像（3840*2160）
- 输入/输出图片格式：YUV420SP
- n路（n≥2）		200fps

:::note 说明

  • VPC处理性能与处理过程中的图像分辨率强相关，以输入图像和输出图像中的最大分辨率作为基准分辨率，基准分辨率越大，处理耗时越久，性能越低。
  • 调用VPC批处理接口（接口命名中包含batch，例如hi_mpi_vpc_batch_crop_resize_paste接口）时，由于图像处理单元DVPP（Digital Video Pre-Processing）内部多个VPC硬件单元会并行处理图片任务，因此单路就可以达到最大总帧率。 :::

父主题： VPC图像处理功能

hi_mpi_vpc_create_chn​

函数功能​

根据设置的通道属性创建图像处理通道，由用户指定通道号。

约束说明​

  • 如果参数attr为空，会返回错误码HI_ERR_VPC_NULL_PTR。
  • 在创建图像处理通道之前必须保证通道未创建（或者已经销毁），否则会直接返回失败。

函数原型​

hi_s32 hi_mpi_vpc_create_chn(hi_vpc_chn chn, const hi_vpc_chn_attr *attr)

参数说明​

参数名输入/输出说明
chn输入图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 （说明：对于 Atlas 200/500 A2推理产品 ， 昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多128。）
attr输入图片处理通道属性指针。

返回值说明​

参考资源​

接口调用流程及示例，参见VPC图片处理典型功能。

父主题： VPC图像处理功能

hi_mpi_vpc_destroy_chn​

函数功能​

销毁创建的图像处理通道。

约束说明​

通道号不能超出最大的通道号范围。

函数原型​

hi_s32 hi_mpi_vpc_destroy_chn(hi_vpc_chn chn)

参数说明​

参数名输入/输出说明
chn输入图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。

返回值说明​

参考资源​

接口调用流程及示例，参见VPC图片处理典型功能。

父主题： VPC图像处理功能

hi_mpi_vpc_resize​

函数功能​

对图像进行按照一定比例进行缩放或者缩放到固定尺寸。异步接口。

约束说明​

版本约束
Atlas 200/500 A2推理产品- 使用本接口对输入、输出图片分辨率的要求如下：
- 输入图片分辨率：10*616384*16384 当输出图片宽度大于4096时，输入图片最小分辨率为128*16。 当输入图片宽度大于8192时，输入图片高度最小为16。
- 输出图片分辨率：10*616384*16384
- 关于图片格式、宽高对齐、内存等约束，请参见图片格式、宽高对齐、内存约束。
- 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。
- 设置fx/fy之后，缩放后的图片的分辨率必须在[10*6~16384*16384]范围内，否则返回错误。
- 缩放可以通过fx/fy或者目标图片宽高两种方式来指定，但是两者均配置以目标尺寸缩放优先。两者不可同时为0。

函数原型​

hi_s32 hi_mpi_vpc_resize(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_pic_info *dest_pic, hi_double fx, hi_double fy, hi_u32 interpolation, hi_u32 *task_id, hi_s32 milli_sec)

参数说明​

参数名输入/输出说明
chn输入图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。
source_pic输入原始图片信息的指针。
dest_pic输入目标图片信息的指针。
fx输入宽的缩放比例。
fy输入高的缩放比例。
interpolation输入缩放算法。此处配置的缩放算法建议与训练模型时的缩放算法保持一致。 Atlas 200/500 A2推理产品，支持如下缩放算法：
- 0：业界通用的Bilinear算法（与OpenCV-3.4.2版本算法的计算结果相同）
- 1：业界通用的Nearest neighbor 算法（与OpenCV-3.4.2版本算法的计算结果相同）
task_id输出任务ID的指针，用来区分任务。
milli_sec输入超时时间配置，单位是毫秒，取值范围如下：
- -1：阻塞方式
- 0：非阻塞方式
- >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

返回值说明​

参考资源​

接口调用流程及示例，参见VPC图片处理典型功能。

父主题： VPC图像处理功能

在线提单