CImg:插件(plugin)使用说明塈实现JPEG图像内存编码/解码

    │  CImg.h
	│  README.md
	│
	├─examples
	│  └─img
	│
	├─plugins
	│      add_fileformat.h
	│      bayer.h
	│      chlpca.h
	│      cvMat.h
	│      draw_gradient.h
	│      inpaint.h
	│      ipl.h
	│      ipl_alt.h
	│      jpeg_buffer.h
	│      loop_macros.h
	│      matlab.h
	│      nlmeans.h
	│      patchmatch.h
	│      skeleton.h
	│      tiff_stream.h
	│      tinymatwriter.h
	│      vrml.h
	│      vtk.h
	│
	└─resources
	        compile_win_icl.bat
	        compile_win_visualcpp.bat

#include <cstdio>
// JPEG文件的读写需要libjpeg的支持，所以这里必须要include jpeglib.h jerror.h
#include <jpeglib.h>
#include <jerror.h>

// 这一行放在#include "CImg.h"前面，用于将jpeg_buffer.h插件加入CImg类的定义
// CImg.h中有多个下面这样的代码，将你定义的插件头文件 include到CImg类定义中
//             #ifdef cimg_plugin
//             #include cimg_plugin
//             #endif
//             #ifdef cimg_plugin1
//             #include cimg_plugin1
//             #endif
// 以此类推，如果你同时也想让CImg对象能转换成OpenCV的矩阵对象cv::Mat
// 就可以定义 cimg_plugin1 为  "plugins/cvMat.h"
//            #define cimg_plugin1 "plugins/cvMat.h"
#define cimg_plugin "plugins/jpeg_buffer.h"
#include "CImg.h"
using namespace cimg_library;
int main() {

  // 将一个JPEG文件的数据读取到内存缓冲区 'buffer_input'中
  const char *filename_input = "foo.jpg";
  std::fprintf(stderr," - Reading file '%s'\n",filename_input);
  std::FILE *file_input = std::fopen(filename_input,"rb");
  if (!file_input) { std::fprintf(stderr,"Input JPEG file not found !"); std::exit(0); }

  std::fprintf(stderr," - Construct input JPEG-coded buffer\n");
  unsigned buf_size = 500000; // 这里定义文件长度
  JOCTET *buffer_input = new JOCTET[buf_size];
  if (std::fread(buffer_input,sizeof(JOCTET),buf_size,file_input)) std::fclose(file_input);
  // -> 'buffer_input' is now a valid jpeg-coded memory buffer.

  std::fprintf(stderr," - Create CImg instance from JPEG-coded buffer\n");
  CImg<unsigned char> img;
  // 将内存缓冲区 'buffer_input'中的图像数据调用load_jpeg_buffer函数实现内存解压缩，buffer_input用完就可以删除了。
  img.load_jpeg_buffer(buffer_input, buf_size);
  delete[] buffer_input;

  // 然后你可以在CImg对象上做你想要的图像处理，比如下面的代码在图像上写文字 ‘ Hello!’，并显示出来
  std::fprintf(stderr," - Do simple processing\n");
  const unsigned char purple[] = { 255, 0, 0 };
  const unsigned char black[] = { 0, 0, 0 };
  img.mirror('y').draw_text(0,0,"   Hello!   ",purple,black,1,57);

  // Display image to see if everything's fine.
  img.display("Using 'jpeg_buffer.h' plugin");

  // 定义一个JPEG压缩输出缓冲区，因为无法预测JPEG压缩输出的数据尺寸，所以这里定义了原文件尺寸2倍。
  // 实际应用中为保险起见，应该以图像分辨率来决定缓冲区的大小， 
  std::fprintf(stderr," - Construct output JPEG-coded buffer\n");
  JOCTET *buffer_output = new JOCTET[2*buf_size];

  // 调用save_jpeg_buffer函数将处理过的CImg对象的图像数据压缩成JPEG格式写入输出缓冲区‘buffer_output ’
  // 调用结束时'buf_size'中会输出实际输出的数据长度
  img.save_jpeg_buffer(buffer_output,buf_size,60);


  // 将输出缓冲区‘buffer_output ’中的JPEG图像数据写入一个新文件
  const char *filename_output = "foo_output.jpg";
  std::fprintf(stderr," - Save output file '%s'\n",filename_output);
  std::FILE* file_output = std::fopen(filename_output,"wb");
  std::fwrite(buffer_output, sizeof(JOCTET), buf_size, file_output);
  std::fclose(file_output);
  delete[] buffer_output;

  std::fprintf(stderr," - All done !\n");
  return 0;
}