hi_mpi_pngd_get_image_data
hi_mpi_pngd_create_chn
函数功能
根据设置的通道属性创建解码通道
约束说明
- 单个Device上的通道号不能超出最大的通道号范围。
- 如果参数attr为空，会返回错误码HI_ERR_PNGD_NULL_PTR。
- 在创建PNG解码通道之前必须保证通道未创建（或者已经销毁），否则会直接返回错误。
- 系统内存不足时会返回HI_ERR_PNGD_NO_MEM的错误码，可考虑扩展OS内存。
- 当通道属性attr中的值超过解码能力集时，会返回HI_ERR_PNGD_ILLEGAL_PARAM的错误码。
函数原型
hi_s32 hi_mpi_pngd_create_chn(hi_pngd_chn chn, const hi_pngd_chn_attr *attr)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 解码通道号。 该参数的取值范围：[0, 128)，通道总数最多128。 |
| attr | 输入 | 解码通道属性指针。 |
返回值说明
- 0：成功
- 非0：失败，参见PNGD图像解码返回码
父主题： PNGD图片解码功能
hi_mpi_pngd_destroy_chn
函数功能
用户退出流程时，需要关闭之前创建的解码通道，以释放相关资源。
约束说明
销毁前必须保证通道已创建，否则会返回通道未创建的错误。
函数原型
hi_s32 hi_mpi_pngd_destroy_chn(hi_pngd_chn chn)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 解码通道号。 该参数的取值范围：[0, 128)，通道总数最多128。 |
返回值说明
- 0：成功
- 非0：失败，参见PNGD图像解码返回码
父主题： PNGD图片解码功能
hi_mpi_pngd_send_stream
函数功能
解码前，向解码通道发送码流数据及存放解码结果的buffer。
约束说明
- 发送数据前必须保证通道已经被创建，否则直接返回通道未创建的错误码HI_ERR_PNGD_UNEXIST。如果在发送码流过程中销毁通道，就会立刻返回错误码HI_ERR_PNGD_UNEXIST。
- 发送码流时需要送入整张png图片。否则，解码会出现错误。
- 以非阻塞方式发送码流，如果码流缓冲区已满，会立刻返回错误码HI_ERR_PNGD_BUF_FULL。
- 以超时方式发送码流，到达设定的超时时间还不能成功发送码流会返回错误码HI_ERR_PNGD_BUF_FULL。
- 图像解码时，对输入、输出图片的要求请参见功能及约束说明。
- 解码时，输入输出内存必须使用hi_mpi_dvpp_malloc接口和hi_mpi_dvpp_free接口进行申请和释放，输入输出内存均需要在调用hi_mpi_pngd_get_image_data接口获取结果之后才能进行释放。
函数原型
hi_s32 hi_mpi_pngd_send_stream(hi_pngd_chn chn, const hi_img_stream *stream, hi_pic_info *png_pic_info, hi_s32 milli_sec)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 解码通道号。 该参数的取值范围：[0, 128)，通道总数最多128。 |
| stream | 输入 | 输入码流信息的指针。 该结构体内的addr参数配置的地址为Device上的内存地址。 |
| png_pic_info | 输入 | 输出图片信息的指针。 |
| milli_sec | 输入 | 超时时间，单位是毫秒。 - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |
返回值说明
- 0：成功
- 非0：失败，参见PNGD图像解码返回码
父主题： PNGD图片解码功能
hi_mpi_pngd_get_image_data
函数功能
解码后，获取解码通道的解码图像及输入Stream。
约束说明
- 此接口通过改变milli_sec值支持阻塞方式、非阻塞方式、超时方式获取解码图像。
- 获取解码图像时必须保证通道已经被创建，否则直接返回通道未创建的错误码HI_ERR_PNGD_UNEXIST。如果在获取图像的过程中销毁通道，就会立刻返回错误码 HI_ERR_PNGD_UNEXIST。
- 以非阻塞方式获取解码图像，如果缓冲区内无图像，会立刻返回错误码HI_ERR_PNGD_BUF_EMPTY。
- 以超时方式获取解码图像，到达设定的超时时间还不能获取到图像则会返回错误码 HI_ERR_PNGD_BUF_EMPTY。
- 向PNGD获取解码结果，输入buffer和输出buffer一起获取。
- PNGD图片解码时，关于输入、输出图片的要求请参见功能及约束说明。
函数原型
hi_s32 hi_mpi_pngd_get_image_data(hi_pngd_chn chn, hi_pic_info *png_pic_info, hi_img_stream *stream, hi_s32 milli_sec)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| chn | 输入 | 解码通道号。 该参数的取值范围：[0, 128)，通道总数最多128。 |
| png_pic_info | 输出 | 已解码的图像信息的指针。解码后的数据存放在Device内存中。 |
| stream | 输出 | 已解码的输入码流信息的指针。 |
| milli_sec | 输入 | 超时时间，单位是毫秒。 - -1：阻塞方式 - 0：非阻塞方式 - >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |
返回值说明
- 0：获取数据成功
- 非0：失败，参见PNGD图像解码返回码。HI_ERR_PNGD_BUF_EMPTY表示无数据，其他错误码表示解码异常
父主题： PNGD图片解码功能
hi_mpi_png_get_image_info
函数功能
根据输入码流，获取png源图片的宽、高、源格式及源格式解码时输出图片的宽stride、高stride、以及所需的内存大小等信息。
约束说明
提供给用户来计算解码后输出图片占用的内存大小。当前仅支持解析png图片。通过本接口获取的widthStride向上128对齐、heightStride向上16对齐。
函数原型
hi_s32 hi_mpi_png_get_image_info(const hi_img_stream *png_stream, hi_img_info *img_info)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| png_stream | 输入 | 输入码流信息的指针。 |
| img_info | 输出 | 图片信息的指针。 |
返回值说明
- 0：成功
- 非0：失败，参见PNGD图像解码返回码
父主题： PNGD图片解码功能
基本数据类型说明
typedef unsigned char hi_u8;
typedef signed char hi_s8;
typedef unsigned short hi_u16;
typedef short hi_s16;
typedef unsigned int hi_u32;
typedef int hi_s32;
typedef unsigned long long hi_u64;
typedef long long hi_s64;
typedef char hi_char;
typedef double hi_double;
typedef hi_u32 hi_fr32;
typedef float hi_float;
typedef enum {
HI_FALSE = 0,
HI_TRUE = 1,
} hi_bool;
#define hi_void void
#define HI_NULL 0L
#define HI_SUCCESS 0
#define HI_FAILURE (-1)
父主题： 公共
hi_pixel_format
说明
DVPP所支持的各种图片格式的枚举。
定义
typedef enum {
HI_PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3, // YUV422SP 8bit
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4, // YVU422SP 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_444 = 5, // YUV444SP 8bit
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_444 = 6, // YVU444SP 8bit
HI_PIXEL_FORMAT_YUYV_PACKED_422 = 7, // YUV422 Package YUYV 8bit
HI_PIXEL_FORMAT_UYVY_PACKED_422 = 8, // YUV422 Package UYVY 8bit
HI_PIXEL_FORMAT_YVYU_PACKED_422 = 9, // YUV422 Package YVYU 8bit
HI_PIXEL_FORMAT_VYUY_PACKED_422 = 10, // YUV422 Package VYUY 8bit
HI_PIXEL_FORMAT_YUV_PACKED_444 = 11, // YUV444 Package 8bit
HI_PIXEL_FORMAT_RGB_888 = 12, // RGB888
HI_PIXEL_FORMAT_BGR_888 = 13, // BGR888
HI_PIXEL_FORMAT_ARGB_8888 = 14, // ARGB8888
HI_PIXEL_FORMAT_ABGR_8888 = 15, // ABGR8888
HI_PIXEL_FORMAT_RGBA_8888 = 16, // RGBA8888
HI_PIXEL_FORMAT_BGRA_8888 = 17, // BGRA8888
HI_PIXEL_FORMAT_YUV_SEMI_PLANNER_420_10BIT = 18, // YUV420SP 10bit
HI_PIXEL_FORMAT_YVU_SEMI_PLANNER_420_10BIT = 19, // YVU420sp 10bit
HI_PIXEL_FORMAT_YVU_PLANAR_420 = 20, // YVU420P 8bit
HI_PIXEL_FORMAT_YVU_PLANAR_422 = 21, // YVU422P 8bit
HI_PIXEL_FORMAT_YVU_PLANAR_444 = 22, // YVU444P 8bit
HI_PIXEL_FORMAT_RGB_444 = 23, // RGB444 R:4bit G:4bit B:4bit，当前不支持该格式
HI_PIXEL_FORMAT_BGR_444 = 24, // BGR444 R:4bit G:4bit B:4bit，当前不支持该格式
HI_PIXEL_FORMAT_ARGB_4444 = 25, // ARGB4444 A:4bit R:4bit G:4bit B:4bit
HI_PIXEL_FORMAT_ABGR_4444 = 26, // ABGR4444 A:4bit B:4bit G:4bit R:4bit，当前不支持该格式
HI_PIXEL_FORMAT_RGBA_4444 = 27, // RGBA4444 R:4bit G:4bit B:4bit A:4bit，当前不支持该格式
HI_PIXEL_FORMAT_BGRA_4444 = 28, // BGRA4444 B:4bit G:4bit R:4bit A:4bit，当前不支持该格式
HI_PIXEL_FORMAT_RGB_555 = 29, // RGB555 R:5bit G:5bit B:5bit，当前不支持该格式
HI_PIXEL_FORMAT_BGR_555 = 30, // BGR555 B:5bit G:5bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_RGB_565 = 31, // RGB565 R:5bit G:6bit B:5bit，当前不支持该格式
HI_PIXEL_FORMAT_BGR_565 = 32, // BGR565 B:5bit G:6bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_ARGB_1555 = 33, // ARGB1555 A:1bit R:5bit G:6bit B:5bit
HI_PIXEL_FORMAT_ABGR_1555 = 34, // ABGR1555 A:1bit B:5bit G:6bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_RGBA_1555 = 35, // RGBA1555 A:1bit B:5bit G:6bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_BGRA_1555 = 36, // BGRA1555 A:1bit B:5bit G:6bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_ARGB_8565 = 37, // ARGB8565 A:8bit R:5bit G:6bit B:5bit，当前不支持该格式
HI_PIXEL_FORMAT_ABGR_8565 = 38, // ABGR8565 A:8bit B:5bit G:6bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_RGBA_8565 = 39, // RGBA8565 A:8bit R:5bit G:6bit B:5bit，当前不支持该格式
HI_PIXEL_FORMAT_BGRA_8565 = 40, // BGRA8565 A:8bit B:5bit G:6bit R:5bit，当前不支持该格式
HI_PIXEL_FORMAT_ARGB_CLUT2 = 41, // ARGB Color Lookup Table 2bit
HI_PIXEL_FORMAT_ARGB_CLUT4 = 42, // ARGB Color Lookup Table 4bit
HI_PIXEL_FORMAT_RGB_BAYER_8BPP = 50,
HI_PIXEL_FORMAT_RGB_BAYER_10BPP = 51,
HI_PIXEL_FORMAT_RGB_BAYER_12BPP = 52,
HI_PIXEL_FORMAT_RGB_BAYER_14BPP = 53,
HI_PIXEL_FORMAT_RGB_BAYER_16BPP = 54, // RGB Bayer 16bit，Bayer图像，当前不支持该格式
HI_PIXEL_FORMAT_YUV_PLANAR_420 = 55, // YUV420P 8bit
HI_PIXEL_FORMAT_YUV_PLANAR_422 = 56, // YUV422P 8bit
HI_PIXEL_FORMAT_YUV_PLANAR_444 = 57, // YUV444P 8bit
HI_PIXEL_FORMAT_YVU_PACKED_444 = 58, // YVU444 Package 8bit
HI_PIXEL_FORMAT_XYUV_PACKED_444 = 59, // AYUV444 Package 8bit
HI_PIXEL_FORMAT_XYVU_PACKED_444 = 60, // AYVU444 Package 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_411 = 61, // YUV411SP 8bit
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_411 = 62, // YVU411SP 8bit
HI_PIXEL_FORMAT_YUV_PLANAR_411 = 63, // YUV411P 8bit
HI_PIXEL_FORMAT_YVU_PLANAR_411 = 64, // YVU411P 8bit
HI_PIXEL_FORMAT_YUV_PLANAR_440 = 65, // YUV440P 8bit
HI_PIXEL_FORMAT_YVU_PLANAR_440 = 66, // YVU440P 8bit
HI_PIXEL_FORMAT_RGB_888_PLANAR = 69, // RGB888 Planar
HI_PIXEL_FORMAT_BGR_888_PLANAR = 70, // BGR888 Planar
HI_PIXEL_FORMAT_HSV_888_PACKAGE = 71, // HSV Package，HSV图像package格式，当前不支持该格式
HI_PIXEL_FORMAT_HSV_888_PLANAR = 72, // HSV Planar，HSV图像Planar格式，当前不支持该格式
HI_PIXEL_FORMAT_LAB_888_PACKAGE = 73, // LAB Package，LAB图像package格式，当前不支持该格式
HI_PIXEL_FORMAT_LAB_888_PLANAR = 74, // LAB Planar，LAB图像Planar格式，当前不支持该格式
HI_PIXEL_FORMAT_S8C1 = 75, // Signed 8bit for 1pixel 1Channel，每个像素用1个8bit有符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_S8C2_PACKAGE = 76, // Signed 8bit for 1pixel 2Channel Package，每个像素用2个8bit有符号数表示的双通道图像Package格式，当前不支持该格式
HI_PIXEL_FORMAT_S8C2_PLANAR = 77, // Signed 8bit for 1pixel 2Channel Planar，每个像素用2个8bit有符号数据表的双通道图像Planar格式，当前不支持该格式
HI_PIXEL_FORMAT_S16C1 = 78, // Signed 16bit 1pixel 1Channel，每个像素用1个16bit有符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_U8C1 = 79, // Unsigned 8bit 1pixel 1Channel，每个像素用1个8bit无符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_U16C1 = 80, // Unsigned 16bit 1pixel 1Channel，每个像素用1个16bit无符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_S32C1 = 81, // Signed 32bit 1pixel 1Channel，每个像素用1个32bit有符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_U32C1 = 82, // Unsigned 32bit 1pixel 1Channel，每个像素用1个32bit无符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_U64C1 = 83, // Unsigned 64bit 1pixel 1Channel，每个像素用1个64bit无符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_S64C1 = 84, // Signed 64bit 1pixel 1Channel，每个像素用1个64bit有符号数据表示的单通道图像，当前不支持该格式
HI_PIXEL_FORMAT_RGB_888_INT8 = 110, // RGB888 Package 每个像素的单分量占用1个8bit有符号数
HI_PIXEL_FORMAT_BGR_888_INT8 = 111, // BGR888 Package 每个像素的单分量占用1个8bit有符号数
HI_PIXEL_FORMAT_RGB_888_INT16 = 112, // RGB888 Package 每个像素的单分量占用1个16bit有符号数
HI_PIXEL_FORMAT_BGR_888_INT16 = 113, // BGR888 Package 每个像素的单分量占用1个16bit有符号数
HI_PIXEL_FORMAT_RGB_888_INT32 = 114, // RGB888 Package 每个像素的单分量占用1个32bit有符号数
HI_PIXEL_FORMAT_BGR_888_INT32 = 115, // BGR888 Package 每个像素的单分量占用1个32bit有符号数
HI_PIXEL_FORMAT_RGB_888_UINT16 = 116, // RGB888 Package 每个像素的单分量占用1个16bit无符号数
HI_PIXEL_FORMAT_BGR_888_UINT16 = 117, // BGR888 Package 每个像素的单分量占用1个16bit无符号数
HI_PIXEL_FORMAT_RGB_888_UINT32 = 118, // RGB888 Package 每个像素的单分量占用1个32bit无符号数
HI_PIXEL_FORMAT_BGR_888_UINT32 = 119, // BGR888 Package 每个像素的单分量占用1个32bit无符号数
HI_PIXEL_FORMAT_RGB_888_PLANAR_INT8 = 120,// RGB888 Planar 每个像素的单分量占用1个8bit有符号数
HI_PIXEL_FORMAT_BGR_888_PLANAR_INT8 = 121,// BGR888 Planar 每个像素的单分量占用1个8bit有符号数
HI_PIXEL_FORMAT_RGB_888_PLANAR_INT16 = 122,// RGB888 Planar 每个像素的单分量占用1个16bit有符号数
HI_PIXEL_FORMAT_BGR_888_PLANAR_INT16 = 123,// BGR888 Planar 每个像素的单分量占用1个16bit有符号数
HI_PIXEL_FORMAT_RGB_888_PLANAR_INT32 = 124,// RGB888 Planar 每个像素的单分量占用1个32bit有符号数
HI_PIXEL_FORMAT_BGR_888_PLANAR_INT32 = 125,// BGR888 Planar 每个像素的单分量占用1个32bit有符号数
HI_PIXEL_FORMAT_RGB_888_PLANAR_UINT16 = 126,// RGB888 Planar 每个像素的单分量占用1个16bit无符号数
HI_PIXEL_FORMAT_BGR_888_PLANAR_UINT16 = 127,// BGR888 Planar 每个像素的单分量占用1个16bit无符号数
HI_PIXEL_FORMAT_RGB_888_PLANAR_UINT32 = 128,// RGB888 Planar 每个像素的单分量占用1个32bit无符号数
HI_PIXEL_FORMAT_BGR_888_PLANAR_UINT32 = 129,// BGR888 Planar 每个像素的单分量占用1个32bit无符号数
HI_PIXEL_FORMAT_YUV400_UINT16 = 130, // YUV400 Package 每个像素的单分量占用1个16bit无符号数
HI_PIXEL_FORMAT_YUV400_UINT32 = 131, // YUV400 Package 每个像素的单分量占用1个32bit无符号数
HI_PIXEL_FORMAT_YUV400_UINT64 = 132, // YUV400 Package 每个像素的单分量占用1个64bit无符号数
HI_PIXEL_FORMAT_YUV400_INT8 = 133, // YUV400 Package 每个像素的单分量占用1个8bit有符号数
HI_PIXEL_FORMAT_YUV400_INT16 = 134, // YUV400 Package 每个像素的单分量占用1个16bit有符号数
HI_PIXEL_FORMAT_YUV400_INT32 = 135, // YUV400 Package 每个像素的单分量占用1个32bit有符号数
HI_PIXEL_FORMAT_YUV400_INT64 = 136, // YUV400 Package 每个像素的单分量占用1个64bit有符号数
HI_PIXEL_FORMAT_YUV400_FP16 = 137, // YUV400 Package 每个像素用1个float16数据表示
HI_PIXEL_FORMAT_YUV400_FP32 = 138, // YUV400 Package 每个像素用1个float32数据表示
HI_PIXEL_FORMAT_YUV400_FP64 = 139, // YUV400 Package 每个像素用1个float64数据表示
HI_PIXEL_FORMAT_YUV400_BF16 = 140, // YUV400 Package 每个像素用1个BFloat16数据表示，当前不支持该格式
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_440 = 1000, // YUV440SP 8bit
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_440 = 1001, // YVU440SP 8bit
HI_PIXEL_FORMAT_FLOAT32 = 1002, // Float 32bit for 1pixel，每个像素用1个float32数据表示，当前不支持该格式
HI_PIXEL_FORMAT_BUTT = 1003,
HI_PIXEL_FORMAT_RGB_888_PLANAR_FP16 = 1004,// RGB888 Planar 每个像素用1个float16数据表示
HI_PIXEL_FORMAT_BGR_888_PLANAR_FP16 = 1005,// BGR888 Planar 每个像素用1个float16数据表示
HI_PIXEL_FORMAT_RGB_888_PLANAR_FP32 = 1006,// RGB888 Planar 每个像素用1个float32数据表示
HI_PIXEL_FORMAT_BGR_888_PLANAR_FP32 = 1007,// BGR888 Planar 每个像素用1个float32数据表示
HI_PIXEL_FORMAT_RGB_888_PLANAR_BF16 = 1008,// RGB888 Planar 每个像素用1个BFloat16数据表示，当前不支持该格式
HI_PIXEL_FORMAT_BGR_888_PLANAR_BF16 = 1009,// BGR888 Planar 每个像素用1个BFloat16数据表示，当前不支持该格式
HI_PIXEL_FORMAT_RGB_888_FP16 = 1010, // RGB888 Package，每个像素用1个float16数据表示
HI_PIXEL_FORMAT_BGR_888_FP16 = 1011, // BGR888 Package，每个像素用1个float16数据表示
HI_PIXEL_FORMAT_RGB_888_FP32 = 1012, // RGB888 Package，每个像素用1个float32数据表示
HI_PIXEL_FORMAT_BGR_888_FP32 = 1013, // BGR888 Package，每个像素用1个float32数据表示
HI_PIXEL_FORMAT_RGB_888_BF16 = 1014, // RGB888 Package 每个像素用1个BFloat16数据表示，当前不支持该格式
HI_PIXEL_FORMAT_BGR_888_BF16 = 1015, // BGR888 Package 每个像素用1个BFloat16数据表示，当前不支持该格式
HI_PIXEL_FORMAT_UNKNOWN = 10000
} hi_pixel_format;
参考信息
下文以HI_PIXEL_FORMAT_S8C1、HI_PIXEL_FORMAT_S8C2_PACKAGE、HI_PIXEL_FORMAT_S8C2_PLANAR为例说明排布格式，供参考。
图1 HI_PIXEL_FORMAT_S8C1
图2 HI_PIXEL_FORMAT_S8C2_PACKAGE
图3 HI_PIXEL_FORMAT_S8C2_PLANAR
父主题： 公共
在线提单