LibJPEG库使用_通过LibJPEG将RGB数据保存为JPG图片存储到磁盘

一、前言

LibJPEG库是一个广泛使用的开源C库，用于处理JPEG图像的压缩和解压缩。该库由独立JPEG小组（Independent JPEG Group, IJG）开发，提供了功能强大的API，用于创建和读取JPEG文件。LibJPEG库支持JPEG的所有常见功能，包括高质量的压缩、解压缩、图像处理、颜色空间转换等。采用DCT（离散余弦变换）算法实现了高效的图像压缩，同时支持各种图像质量的调整。LibJPEG的灵活性和性能使其成为图像处理应用中的标准工具，被广泛应用于图像编辑软件、图像查看器、图像传输等多个领域。该库跨平台兼容，支持Windows、Linux、macOS等操作系统，开发者可以轻松将其集成到不同的平台和应用中。LibJPEG库还具有良好的文档支持，提供详细的编程指南和示例代码，帮助开发者快速上手和实现复杂的图像处理功能。由于其开源性质和广泛的应用，LibJPEG在业界享有很高的声誉，成为许多图像处理项目的首选库。

LibJPEG库的源码下载地址：https://www.ijg.org/

下载后是一个ZIP的压缩包，解压看到的数据：

如果要下载编译好的二进制文件，可以去这里下载：https://gnuwin32.sourceforge.net/packages/jpeg.htm

二、函数接口解释

LibJPEG库提供了一组函数接口，用于实现JPEG图像的压缩和解压缩操作。

以下是一些常用的LibJPEG库函数接口及其详细讲解，包括函数功能、参数作用等。

2.1 JPEG压缩相关函数

jpeg_create_compress

• 功能：初始化JPEG压缩对象。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

• 说明：必须在进行任何其他JPEG压缩操作之前调用该函数。

jpeg_stdio_dest

• 功能：设置压缩数据的目标为标准I/O流。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

  • FILE *outfile：目标文件的文件指针。

• 说明：指定JPEG数据输出的目标文件。

jpeg_set_defaults

• 功能：设置JPEG压缩参数的默认值。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

• 说明：设置一组默认的JPEG压缩参数。

jpeg_set_quality

• 功能：设置JPEG压缩质量。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

  • int quality：压缩质量，范围为0（最差）到100（最佳）。

  • boolean force_baseline：如果为TRUE，强制生成符合JPEG标准的文件。

• 说明：调整JPEG压缩的质量参数。

jpeg_start_compress

• 功能：启动压缩过程。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

  • boolean write_all_tables：如果为TRUE，写入所有JPEG标记。

• 说明：在压缩数据之前调用该函数。

jpeg_write_scanlines

• 功能：写入压缩数据行。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

  • JSAMPARRAY scanlines：指向存储图像数据的缓冲区。

  • JDIMENSION num_lines：要写入的行数。

• 说明：写入图像数据到JPEG压缩对象中。

jpeg_finish_compress

• 功能：完成压缩过程。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

• 说明：在完成所有数据写入后调用，关闭JPEG压缩对象。

jpeg_destroy_compress

• 功能：销毁JPEG压缩对象。

• 参数：

  • struct jpeg_compress_struct *cinfo：指向JPEG压缩对象的指针。

• 说明：释放JPEG压缩对象分配的所有资源。

2.2 JPEG解压缩相关函数

jpeg_create_decompress

• 功能：初始化JPEG解压缩对象。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

• 说明：必须在进行任何其他JPEG解压缩操作之前调用该函数。

jpeg_stdio_src

• 功能：设置解压数据的源为标准I/O流。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

  • FILE *infile：源文件的文件指针。

• 说明：指定JPEG数据输入的源文件。

jpeg_read_header

• 功能：读取JPEG文件的头部信息。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

  • boolean require_image：如果为TRUE，要求图像数据存在。

• 说明：读取JPEG文件的头部信息，解析JPEG图像的元数据。

jpeg_start_decompress

• 功能：启动解压缩过程。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

• 说明：在解压缩数据之前调用该函数。

jpeg_read_scanlines

• 功能：读取解压缩的数据行。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

  • JSAMPARRAY scanlines：指向存储解压缩数据的缓冲区。

  • JDIMENSION max_lines：要读取的最大行数。

• 说明：从JPEG解压缩对象中读取图像数据。

jpeg_finish_decompress

• 功能：完成解压缩过程。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

• 说明：在完成所有数据读取后调用，关闭JPEG解压缩对象。

jpeg_destroy_decompress

• 功能：销毁JPEG解压缩对象。

• 参数：

  • struct jpeg_decompress_struct *cinfo：指向JPEG解压缩对象的指针。

• 说明：释放JPEG解压缩对象分配的所有资源。

2.3 辅助函数

jpeg_std_error

• 功能：初始化JPEG错误处理对象。

• 参数：

  • struct jpeg_error_mgr *err：指向JPEG错误处理对象的指针。

• 说明：设置默认的JPEG错误处理例程。

这些函数共同构成了LibJPEG库的核心接口，通过它们可以实现JPEG图像的高效压缩和解压缩。在使用这些函数时，需要按照特定的调用顺序来确保正确的操作和资源管理。

三、代码实现

以下是将RGB565图像转换为RGB888并压缩为JPEG格式的完整示例代码：

#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <jpeglib.h>
​
// 将RGB565转换为RGB888
void RGB565_to_RGB888(uint16_t rgb565, uint8_t *r, uint8_t *g, uint8_t *b) {*r = ((rgb565 >> 11) & 0x1F) << 3;*g = ((rgb565 >> 5) & 0x3F) << 2;*b = (rgb565 & 0x1F) << 3;
}
​
// 将RGB565格式图像转换为RGB888格式
void convert_RGB565_to_RGB888(const uint8_t *rgb565_image, uint8_t *rgb888_image, int width, int height) {for (int i = 0; i < width * height; i++) {uint16_t rgb565 = ((uint16_t)rgb565_image[2 * i + 1] << 8) | rgb565_image[2 * i];RGB565_to_RGB888(rgb565, &rgb888_image[3 * i], &rgb888_image[3 * i + 1], &rgb888_image[3 * i + 2]);}
}
​
// 将RGB888格式图像压缩为JPEG格式
void compress_to_JPEG(const uint8_t *rgb888_image, int width, int height, const char *filename) {struct jpeg_compress_struct cinfo;struct jpeg_error_mgr jerr;
​FILE *outfile;JSAMPROW row_pointer[1];int row_stride;
​cinfo.err = jpeg_std_error(&jerr);jpeg_create_compress(&cinfo);
​if ((outfile = fopen(filename, "wb")) == NULL) {fprintf(stderr, "can't open %s\n", filename);exit(1);}jpeg_stdio_dest(&cinfo, outfile);
​cinfo.image_width = width;cinfo.image_height = height;cinfo.input_components = 3;cinfo.in_color_space = JCS_RGB;
​jpeg_set_defaults(&cinfo);jpeg_set_quality(&cinfo, 75, TRUE);jpeg_start_compress(&cinfo, TRUE);
​row_stride = width * 3;
​while (cinfo.next_scanline < cinfo.image_height) {row_pointer[0] = (JSAMPROW) &rgb888_image[cinfo.next_scanline * row_stride];jpeg_write_scanlines(&cinfo, row_pointer, 1);}
​jpeg_finish_compress(&cinfo);fclose(outfile);jpeg_destroy_compress(&cinfo);
}
​
int main() {// 假设图像尺寸为100x100int width = 100;int height = 100;
​// 示例RGB565数据uint8_t rgb565_image[20000];for (int i = 0; i < 20000; i++) {rgb565_image[i] = rand() % 256; // 用随机数据填充}
​// 分配RGB888图像数据的内存uint8_t *rgb888_image = (uint8_t *)malloc(width * height * 3);if (rgb888_image == NULL) {fprintf(stderr, "Unable to allocate memory for RGB888 image\n");return 1;}
​// 转换RGB565到RGB888convert_RGB565_to_RGB888(rgb565_image, rgb888_image, width, height);
​// 压缩并保存为JPEG文件compress_to_JPEG(rgb888_image, width, height, "output.jpg");
​// 释放内存free(rgb888_image);
​printf("Compression to JPEG completed.\n");
​return 0;
}
​