总体说明
多版本接口差异
- 本手册中媒体数据处理V1版本与媒体数据处理V2版本的接口功能范围相同,都是描述处理媒体数据的接口,用于实现抠图、图片缩放、格式转换等功能,但两套接口不能混用。
- 建议使用V2版本中的接口,保证后续版本接口功能以及业务的连续演进。
- V1版本中的接口是为了兼容旧版本,保证使用该部分接口的用户能继续使用,后续版本不再演进。
功能说明
本章节介绍媒体数据处理V1版本(DVPP,Digital Vision Pre-Processing)的功能,如表1所示。
功能 |
说明 |
---|---|
VPC(Vision Preprocessing Core) |
负责图像处理功能,支持对图片做抠图、缩放、格式转换等操作,详细描述请参见功能说明。 |
JPEGD(JPEG Decoder) |
负责完成图像解码功能,将.jpg、.jpeg、.JPG、.JPEG图片解码成YUV格式图片,详细描述请参见功能及约束说明。 |
JPEGE(JPEG Encoder) |
负责完成图像编码功能,将YUV格式图片编码成.jpg图片,详细描述请参见功能及约束说明。 |
VDEC(Video Decoder) |
负责视频解码,详细描述请参见功能及约束说明。 |
VENC(Video Encoder) |
负责视频编码,详细描述请参见功能及约束说明。 |
PNGD(PNG Decoder) |
负责PNG格式图片的解码,详细描述请参见功能及约束说明。 |
整体约束说明
使用本章中介绍的接口,有以下注意点:
-
对于本章介绍的异步接口,调用接口成功仅表示任务下发成功,不表示任务执行成功,对于有依赖的接口,为确保能按序执行任务,建议用户在多个接口中指定同一个Stream,因为同一个Stream中的任务按接口调用顺序执行。
在调用异步口对图片进行解码、抠图、缩放等操作时,如果任务之间有依赖,一定要调用acl.rt.synchronize_stream接口确保在同一个Stream中的任务按序执行。
从性能角度考虑,建议一个Stream上下发多个异步媒体数据处理任务后,执行一次acl.rt.synchronize_stream接口。
调用异步接口后,不能马上释放资源,需调用同步等待接口(例如,acl.rt.synchronize_stream)确保Device侧任务执行完成后才能释放。
-
- 实现媒体数据处理的VPC、JPEGD、JPEGE等功能前,若需要申请Device上的内存存放输入或输出数据,需调用acl.media.dvpp_malloc申请内存、调用acl.media.dvpp_free接口释放内存。
- 调用1申请出来的内存可以满足媒体数据处理的要求,也可以在其它任务中使用,例如,从性能角度,为了减少拷贝,媒体数据处理的输出作为模型推理的输入,实现内存复用。
- 由于媒体数据处理访问的地址空间有限,为确保媒体数据处理时内存足够,除媒体数据处理功能外的其它功能(例如,模型加载),建议调用内存管理章节下的acl.rt.malloc接口、acl.rt.malloc_host接口或acl.rt.malloc_cached接口申请内存。
Atlas 推理系列产品(Ascend 310P处理器)上,媒体数据处理功能在每个进程内,可访问的地址空间最大为16GB。
Atlas A2训练系列产品/Atlas 800I A2推理产品上,媒体数据处理功能在每个进程内,可访问的地址空间最大为16GB。
- 关于通道的要求:
实现媒体数据处理的各功能前,必须调用接口创建对应功能的通道,创建通道的接口请参见通道创建与释放。通道的创建与销毁会涉及资源的申请与释放,反复创建与销毁通道会影响业务性能,因此建议根据实际场景管理通道,例如,如果有持续VPC图片处理,则创建VPC的通道后,等到所有VPC功能调用完成后,再销毁该VPC通道。
通道数量多,会影响Device的CPU占用率和内存占用,通道数量建议参考各功能章节下的的性能指标的路数。
Atlas 推理系列产品(Ascend 310P处理器)上,各功能的通道数有一定的限制,VPC的通道数最多256,JPEGD与VDEC共用通道且通道数最多256,JPEGE与VENC共用通道且通道数最多256,PNGD的通道数最多128。创建通道的接口请参见通道创建与释放。
Atlas A2训练系列产品/Atlas 800I A2推理产品上,各功能的通道数有一定的限制,VPC的通道数最多256,JPEGD的通道数最多256,VDEC的通道数最多128,JPEGE的通道数最多256,PNGD的通道数最多128。创建通道的接口请参见通道创建与释放。
Atlas 200I/500 A2推理产品上,各功能的通道数有一定的限制,VPC的通道数最多128,JPEGD的通道数最多128,VDEC的通道数最多128,JPEGE的通道数最多128,VENC的通道数最多128,PNGD的通道数最多128。创建通道的接口请参见通道创建与释放。
对于Atlas 推理系列产品(Ascend 310P处理器),昇腾虚拟化实例(Ascend Virtual Instance)场景下,如果通道总数不为整数,则向下取整:
- VPC通道总数 = ( 被分配的VPC硬件单元数量 / VPC硬件单元总数 ) * 256
- VDEC通道和JPEGD通道总数 = ( 被分配的VDEC硬件单元+JPEGD硬件单元数量之和 / VDEC硬件单元+JPEGD硬件单元总数之和 ) * 256
- VENC通道和JPEGE通道总数 = ( 被分配的VENC硬件单元+JPEGE硬件单元数量之和 / VENC硬件单元+JPEGE硬件单元总数之和 ) * 256
- PNGD通道总数 = 切分规格 * 128
对于PNGD功能,若使用以下昇腾虚拟化实例(Ascend Virtual Instance)模板,则对通道数的限制不同:
- 使用vir04_4c_dvpp模板时,通道总数固定为128。
- 使用vir04_3c_ndvpp模板时,表示不使用DVPP功能,因此通道总数为0。
对于Atlas A2训练系列产品/Atlas 800I A2推理产品,昇腾虚拟化实例(Ascend Virtual Instance)场景下,如果通道总数不为整数,则向下取整:
- VPC通道总数最多256。
- VDEC通道 = ( 被分配的VDEC硬件单元 / VDEC硬件单元 ) * 32,如果通道总数不为整数,则向下取整。JPEGD的通道数不受算力影响,但JPEGD+VDEC的总通道数最大256。
- JPEGE通道总数最多256。
- PNGD通道总数 = 切分规格 * 128
对于Atlas 200I/500 A2推理产品,昇腾虚拟化实例(Ascend Virtual Instance)场景下,如果通道总数不为整数,则向下取整:
- VPC通道总数最多128。
- VDEC通道 = ( 被分配的VDEC硬件单元 / VDEC硬件单元 ) * 128,如果通道总数不为整数,则向下取整。JPEGD的通道数不随算力影响,但JPEGD+VDEC的总通道数最大128。
- VENC通道 = ( 被分配的VENC硬件单元 / VENC硬件单元 ) * 128,如果通道总数不为整数,则向下取整。JPEGE的通道数不随算力影响,但JPEGE+VENC的总通道数最大128。
昇腾虚拟化实例(Ascend Virtual Instance)的详细描述,以及各场景下的算力资源规格请参见《昇腾虚拟化实例(AVI)用户指南》。