Skip to main content

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功能

在线提单