功能及约束说明
函数：venc_get_frame_config_force_i_frame
| C函数原型 | uint8_t aclvencGetFrameConfigForceIFrame(const aclvencFrameConfig *config); |
|---|---|
| Python函数 | force_i_frame = acl.media.venc_get_frame_config_force_i_frame(config) |
| 函数功能 | 获取单帧编码配置参数。同步接口。 |
| 输入说明 | config：int，表示单帧编码配置数据。 |
| 返回值说明 | force_i_frame：int，是否强制重新开始I帧间隔。 - 0：不强制重新开始。 - 1：强制重新开始I帧。 |
父主题： VENC功能
函数：venc_get_frame_config_eos
| C函数原型 | uint8_t aclvencGetFrameConfigEos(const aclvencFrameConfig *config) |
|---|---|
| Python函数 | eos = acl.media.venc_get_frame_config_eos(config) |
| 函数功能 | 获取单帧编码配置参数。 |
| 输入说明 | config：int，表示单帧编码配置数据。 |
| 返回值说明 | eos：uint8_t，是否为结束帧。 - 0：不是结束帧。 - 1：是结束帧。 |
父主题： VENC功能
功能及约束说明
功能说明
PNGD（PNG Decoder）功能：实现PNG格式图片的硬件解码。
**PNGD在解码图片时，支持按源图片格式解码。**在调用PNGD解码接口时，直接将输出图片格式配置为PIXEL_FORMAT_UNKNOWN，输出格式默认按源图片格式输出。
源图片格式解码是指解码前后图片的编码格式保持一致，例如解码前输入图片格式为RGB，解码后输出图片格式为RGB888。
图片分辨率约束
-
输入图片分辨率：
最大分辨率4096*4096，最小分辨率32*32。
-
输出图片分辨率
PNGD只对图片解码，不会改变图片分辨率，因此输出与输入的图片分辨率保持一致。
图片格式、宽高对齐、内存约束
实现图片解码功能时，需调用acl.media.dvpp_malloc接口申请Device上的输入、输出内存，调用acl.media.dvpp_free接口释放输入、输出内存，这部分内存的生命周期由用户自行管理。
- 输入内存的大小就是指实际的输入图片所占用的大小。
- 输出内存的大小可调用acl.media.dvpp_png_predict_dec_size接口预估。
:::note 说明 输出图片格式的定义请参见acldvppPixelFormat，宽stride、高stride等概念请参见基本概念。 :::
表1 图片格式、宽高对齐、内存大小约束
输入图片格式 | 输出图片格式 | 输出图片宽、高对齐要求 | 输出图片宽stride、高stride、内存大小要求 |
|---|---|---|---|
RGB | RGB888 | 无对齐要求 | |
GRAY | RGB888 | 无对齐要求 | |
RGBA | RGB888 | 无对齐要求 | |
RGBA8888 8bit | 无对齐要求 | ||
AGRAY | RGB888 | 无对齐要求 | |
RGBA8888 8bit | 无对齐要求 |
父主题： PNGD功能
性能指标说明
性能指标说明
以下性能数据，是基于一个stream上下发10个异步媒体数据处理任务后，执行一次acl.rt.synchronize_stream接口。
1080p指分辨率为1920*1080的图片；4K指分辨率为3840*2160的图片。单个Device的基本场景性能指标参考如下（1路对应一个通道，一个通道对应一个线程）：
| 场景举例 | 总帧率 |
|---|---|
| 1080p*n路（1≤n≤5） | n*4fps |
| 1080p*n路（n≥ 6） | 24fps |
| 4k*n路（1≤n≤5） | n*1fps |
| 4k*n路（n≥ 6） | 6fps |
父主题： PNGD功能
函数：dvpp_png_decode_async
| C函数原型 | aclError acldvppPngDecodeAsync(acldvppChannelDesc *channelDesc, const void *data, uint32_t size, acldvppPicDesc *outputDesc, aclrtStream stream) |
|---|---|
| Python函数 | ret = acl.media.dvpp_png_decode_async(dvpp_channel_desc, data, size, output_desc, stream) |
| 函数功能 | 解码png图片，异步接口。 |
| 输入说明 | dvpp_channel_desc：int，指定通道描述信息。与调用acl.media.dvpp_create_channel接口创建通道时指定的dvpp_channel_desc保持一致。 data：int，输入图片的内存地址。 size：int，输入图片的实际数据大小，单位Byte。 output_desc：int，输出图片信息。 参数作为输入时，需要用户调用如下接口： - 调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。 - 调用acl.media.dvpp_set_pic_desc系列接口设置输出图片的内存地址、内存大小、格式。 - 输出图片的内存大小可提前调用acl.media.dvpp_png_predict_dec_size接口获取。 - png原图信息（例如宽、高）可通过acl.media.dvpp_png_get_image_info接口获取。 - 输出图片格式、内存等要求，请参见功能及约束说明。 参数作为输出时，用户可以从内存地址中获取解码后的输出图片数据。 stream：int，指定Stream。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败 |
表1 支持格式
| 功能 | 输入图片格式 | 输出图片格式 |
|---|---|---|
| 调用本接口时将输出图片格式设置为PIXEL_FORMAT_UNKNOWN 表示不指定输出图片格式，输出图片格式与输入图片格式一致。 | RGB/GRAY | RGB |
| 调用本接口时将输出图片格式设置为PIXEL_FORMAT_UNKNOWN 表示不指定输出图片格式，输出图片格式与输入图片格式一致。 | RGBA/AGRAY | RGBA |
| 调用本接口时将输出图片格式设置为PIXEL_FORMAT_RGB_888，表示指定输出图片格式，将输入图片格式转换为输出图片格式。 | RGB/RGBA/GRAY/AGRAY | RGB |
父主题： PNGD功能
函数：dvpp_png_get_image_info
| C函数原型 | aclError acldvppPngGetImageInfo(const void *data, uint32_t dataSize, uint32_t *width, uint32_t *height, int32_t *components) |
|---|---|
| Python函数 | width, height, components, ret = acl.media.dvpp_png_get_image_info(data, data_size) |
| 函数功能 | 从存放png图片数据的内存中读取png图片的宽、高。 |
| 输入说明 | data：int，存放png图片数据的内存的地址。 data_size：int，内存大小，单位为Byte。 |
| 返回值说明 | width：int，图片的宽。 height：int，图片的高。 components：int，颜色通道个数。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
父主题： PNGD功能
在线提单