bmcv_image_jpeg_enc

该接口可以实现对多张 bm_image 的 JPEG 编码过程。

接口形式:

bm_status_t bmcv_image_jpeg_enc(
        bm_handle_t handle,
        int         image_num,
        bm_image *  src,
        void *      p_jpeg_data[],
        size_t *    out_size,
        int         quality_factor = 85
);

输入参数说明:

  • bm_handle_t handle

    输入参数。bm_handle 句柄。

  • int image_num

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

  • bm_image* src

    输入参数。输入 bm_image的指针。每个 bm_image 需要外部调用 bmcv_image_create 创建,image 内存可以使用 bm_image_alloc_dev_mem 或者 bm_image_copy_host_to_device 来开辟新的内存,或者使用 bmcv_image_attach 来 attach 已有的内存。

  • void * p_jpeg_data,

    输出参数。编码后图片的数据指针,由于该接口支持对多张图片的编码,因此为指针数组,数组的大小即为 image_num。用户可以选择不为其申请空间(即数组每个元素均为NULL),在 api 内部会根据编码后数据的大小自动分配空间,但当不再使用时需要用户手动释放该空间。当然用户也可以选择自己申请足够的空间。

  • size_t *out_size,

    输出参数。完成编码后各张图片的大小(以 byte 为单位)存放在该指针中。

  • int quality_factor = 85

    输入参数。编码后图片的质量因子。取值 0~100 之间,值越大表示图片质量越高,但数据量也就越大,反之值越小图片质量越低,数据量也就越少。该参数为可选参数,默认值为85。

返回值说明:

  • BM_SUCCESS: 成功

  • 其他:失败

注解

目前编码支持的图片格式包括以下几种:
FORMAT_YUV420P
FORMAT_YUV422P
FORMAT_YUV444P
FORMAT_NV12
FORMAT_NV21
FORMAT_NV16
FORMAT_NV61
FORMAT_GRAY
目前编码支持的数据格式如下:
DATA_TYPE_EXT_1N_BYTE

示例代码

int image_h     = 1080;
int image_w     = 1920;
int size        = image_h * image_w;
int format      = FORMAT_YUV420P;
bm_image src;
bm_image_create(handle, image_h, image_w, (bm_image_format_ext)format,
        DATA_TYPE_EXT_1N_BYTE, &src);
std::unique_ptr<unsigned char[]> buf1(new unsigned char[size]);
memset(buf1.get(), 0x11, size);

std::unique_ptr<unsigned char[]> buf2(new unsigned char[size / 4]);
memset(buf2.get(), 0x22, size / 4);

std::unique_ptr<unsigned char[]> buf3(new unsigned char[size / 4]);
memset(buf3.get(), 0x33, size / 4);

unsigned char *buf[] = {buf1.get(), buf2.get(), buf3.get()};
bm_image_copy_host_to_device(src, (void **)buf);

void* jpeg_data = NULL;
size_t out_size = 0;
int ret = bmcv_image_jpeg_enc(handle, 1, &src, &jpeg_data, &out_size);
if (ret == BM_SUCCESS) {
    FILE *fp = fopen("test.jpg", "wb");
    fwrite(jpeg_data, out_size, 1, fp);
    fclose(fp);
}
free(jpeg_data);
bm_image_destroy(src);