acldvppPngPredictDecSize

acldvppPngPredictDecSize

函数功能

根据存放png图片数据的内存计算出png图片解码后所需的输出内存的大小。

函数原型

aclError acldvppPngPredictDecSize(const void *data,

uint32_t dataSize,

acldvppPixelFormat outputPixelFormat,

uint32_t *decSize)

参数说明

参数名	输入/输出	说明
data	输入	存放png图片数据内存地址的指针。
size	输入	内存大小，单位为Byte。
outputPixelFormat	输入	解码后的输出图片的格式，支持设置如下格式： - PIXEL_FORMAT_UNKNOWN：按占用内存大小最大的PNG解码输出格式计算内存大小。 - PIXEL_FORMAT_RGB_888 - PIXEL_FORMAT_RGBA_8888
decSize	输出	png图片解码后所需输出内存大小的指针，单位为Byte。

返回值说明

返回0表示成功，返回其它值表示失败。

参考资源

接口调用流程及示例，参见PNGD图片解码。

父主题： PNGD功能

功能及约束说明

功能说明

VDEC（Video Decoder）实现视频的解码，VDEC内部经过VPC处理后，输出指定格式的图片，参见码流/图片格式、宽高对齐、内存约束。

分辨率约束

• 输入码流分辨率：

  版本	分辨率范围
  Atlas 200/500 A2推理产品	对于H264输入码流，最大分辨率8192*8192，最小分辨率128*128。 对于H265输入码流，最大分辨率5400*8192，最小分辨率128*128。

• 输出图片分辨率：

  版本	分辨率范围
  Atlas 200/500 A2推理产品	输出图片最大分辨率8192*8192；当输入码流宽度小于或等于4096时，输出图片最小分辨率为10*6，当输入码流宽度大于4096时，输出图片最小分辨率为128*128。

码流/图片格式、宽高对齐、内存约束

实现VDEC视频解码功能时，输入或输出内存的生命周期由用户自行管理：

• 输入内存

  调用acldvppMalloc/acldvppFree接口申请/释放内存、或调用aclrtMalloc/aclrtFree接口申请/释放内存，内存大小就是指实际的输入码流所占用的大小。

  调用acldvppMalloc接口申请的内存为媒体数据处理的专用内存，但专用内存的地址空间有限，若关注内存规划或内存资源有限时，使用VDEC视频解码功能时，建议调用aclrtMalloc接口申请内存。

• 输出内存

  需调用acldvppMalloc接口申请Device上的输出内存，调用acldvppFree接口释放输出内存，内存大小请参见下表中的计算公式。

:::note 说明 输出图片格式的定义请参见acldvppPixelFormat，宽stride、高stride等概念请参见基本概念。 :::

VDEC视频解码时，输入码流支持如下格式：

• H264 bp/mp/hp level5.1 YUV420编码的码流，当前只支持annex-B的裸码流。
• H265 8/10bit level5.1 YUV420编码的码流，当前只支持annex-B的裸码流。

VDEC视频解码时，输出图片格式、宽高对齐要求等如下表所示：

表1 码流/图片格式、宽高对齐、内存大小约束

版本	输出图片格式	输出图片宽、高对齐要求	输出图片宽stride、高stride、内存大小要求 Atlas 200/500 A2推理产品
通用格式，各版本都支持	YUV420SP NV12 8bit	宽2对齐 高2对齐	宽stride无对齐要求，与宽相同即可，最小10，最大24576。 高stride无对齐要求，与高相同即可，最小6，最大24576。 内存大小（单位Byte）≥ 宽stride * 高stride * 3/2
	YUV420SP NV21 8bit
该部分格式仅以下版本支持： Atlas 200/500 A2推理产品	RGB888	无对齐要求	宽stride为宽乘以3的值，最小30，最大24576。 高stride无对齐要求，最小6，最大24576。 内存大小（单位Byte）≥ 宽stride * 高stride
	BGR888

其它约束

• VDEC只支持按帧输入码流进行解码。
• 若码流中有坏帧、缺帧等情况，解码器VDEC可能会丢帧。
• 通过隔行扫描方式编码出来的码流，VDEC仅支持解码H264 8bit编码的码流。

父主题： VDEC功能

性能指标说明

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

1080p指分辨率为1920*1080的图片。单个Device的基本场景性能指标参考如下（1路对应一个通道，一个通道对应一个线程）：

场景举例	总帧率
720p*n路(1≤n≤4)	n*600fps
720p*n路(n>4)	2400fps
1080p*n路(1≤n≤4)	n*300fps
1080p*n路(n>4)	1200fps
4k*n路(1≤n≤4)	n*75fps
4k*n路(n>4)	300fps

下表说明了典型场景下每路VDEC解码的内存消耗，在内存消耗的计算公式中：

• 输入码流缓存大小：等于输入码流的宽*高*2。
• 解码图像帧存大小：1080P分辨率的输入码流，该参数值为3MB。其它分辨率时参数值可等量折算。
• 视频解码图像Tmv缓存大小：H264格式、1080P分辨率的输入码流，该参数值为0.5MB；H265格式、1080P分辨率的输入码流，该参数值为1MB。其它分辨率时参数值可等量折算。
• 参考帧数量可由用户调用aclvdecSetChannelDescRefFrameNum接口设置。
• 解码后缓存图像帧数固定为2个。

每路VDEC解码的内存消耗计算公式	场景举例	内存消耗（单位为MB）
6MB + 输入码流缓存大小 * 2 + (解码图像帧存大小 + 视频解码图像Tmv缓存大小) * (参考帧数量 + 解码后缓存图像帧数 +1 )	输入码流格式H264 输入码流分辨率1080P 输入码流缓存大小为4MB 解码图像帧存大小为3MB 视频解码图像Tmv缓存大小为0.5MB 解码后缓存图像帧数2个	52.5MB（参考帧数量8个） 31.5MB（参考帧数量2个）
	输入码流格式H265 输入码流分辨率1080P 输入码流缓存大小为4MB 解码图像帧存大小为3MB 视频解码图像Tmv缓存大小为1MB 解码后缓存图像帧数2个	58MB（参考帧数量8个） 34MB（参考帧数量2个）

父主题： VDEC功能

在线提单