bmcv_image_jpeg_dec¶

该接口可以实现对多张图片的 JPEG 解码过程。

接口形式：

bm_status_t bmcv_image_jpeg_dec(
        bm_handle_t handle,
        void *      p_jpeg_data[],
        size_t *    in_size,
        int         image_num,
        bm_image *  dst
);

输入参数说明：

bm_handle_t handle

输入参数。bm_handle 句柄。

void * p_jpeg_data[]

输入参数。待解码的图片数据指针，由于该接口支持对多张图片的解码，因此为指针数组。

size_t *in_size

输入参数。待解码各张图片的大小（以 byte 为单位）存放在该指针中，也就是上述 p_jpeg_data 每一维指针所指向空间的大小。

int image_num

输入参数。输入图片数量，最多支持 4

bm_image* dst

输出参数。输出 bm_image的指针。每个 dst bm_image 用户可以选择自行调用 bm_image_create 创建，也可以选择不创建。如果用户只声明而不创建则由接口内部根据待解码图片信息自动创建，默认的 format 如下表所示, 当不再需要时仍然需要用户调用 bm_image_destory 来销毁。

码流	默认输出 format
YUV420	FORMAT_YUV420P
YUV422	FORMAT_YUV422P
YUV444	FORMAT_YUV444P
YUV400	FORMAT_GRAY

返回值说明:

BM_SUCCESS: 成功
其他:失败

注意事项：

如果用户没有使用bmcv_image_create创建dst的bm_image，那么需要将参数传入指针所指向的空间置0。
目前解码支持的图片格式及其输出格式对应如下，如果用户需要指定以下某一种输出格式，可通过使用 bmcv_image_create 自行创建 dst bm_image，从而实现将图片解码到以下对应的某一格式。

码流	输出 format
YUV420	FORMAT_YUV420P
	FORMAT_NV12
	FORMAT_NV21
YUV422	FORMAT_YUV422P
	FORMAT_NV16
	FORMAT_NV61
YUV444	FORMAT_YUV444P
YUV400	FORMAT_GRAY

示例代码

size_t size = 0;
// read input from picture
FILE *fp = fopen(filename, "rb+");
assert(fp != NULL);
fseek(fp, 0, SEEK_END);
*size = ftell(fp);
u8* jpeg_data = (u8*)malloc(*size);
fseek(fp, 0, SEEK_SET);
fread(jpeg_data, *size, 1, fp);
fclose(fp);

// create bm_image used to save output
bm_image dst;
memset((char*)&dst, 0, sizeof(bm_image));
// if you not create dst bm_image it will create automatically inside.
// you can also create dst bm_image here, like this:
// bm_image_create(handle, IMAGE_H, IMAGE_W, FORMAT_YUV420P,
//         DATA_TYPE_EXT_1N_BYTE, &dst);

// decode input
int ret = bmcv_image_jpeg_dec(handle, (void**)&jpeg_data, &size, 1, &dst);
free(jpeg_data);
bm_image_destory(dst);