CImg中文手册1

本手册主要介绍CImg库主要的类和函数：

类库结构

CImg仅包含一个头文件CImg.h；提供了一系列的C++模板类，实现了单个图像和图像序列的加载、保存、处理、显示等功能；这样的新颖设计有如下好处：

• 不需要预处理；
• 不需要处理复杂的文件依赖关系（可能作者对此的怨念很深）；仅需在需要使用CImg的文件中包含CImg.h即可；
• 只有应用真正用到的函数会被编译进最终的程序；
• 类成员和类函数都是内联的，运行的时候会有更高的执行效率；

CImg库代码组织如下：

• 所有的类和方法都定义在cimg_library命名空间；来避免类和函数的重名；使用的时候可以使用下面的代码引入该命名空间：

  #include "CImg.h"
  using namespace cimg_library;
  ...

• 命名空间cimg_library::cimg 定义了CImg的一系列底层函数和变量；可以使用该命名空间里面的函数，但是不要直接引用该命名空间，因为该命名空间里面定义了一系列C/C++标准库已经定义过的函数；
• 类cimg_library::CImg<T>用来存储最高4纬的图像数据；T定义了像素值类型，这是CImg库最重要的类；
• 类cimg_library::CImgl<T> 用来表示图像序列；
• 类cimg_library::CImgDisplay用来将图像和图像集合显示到屏幕窗口；该类实现虽然高度依赖操作系统，但是对使用者透明；cimg_environment章节会介绍跟显示有关的环境变量，这些环境变量在编译的时候会被CImg自动设置；
• 类cimg_library::CImgStats 用来表示图像统计信息；使用它可以快速得到图像的最大值、最大值像素座标、最小值、最小值像素座标、平均值、方差等统计数据；
• 类cimg_library::CImgException以及它的子类定义了程序运行时的异常；
  了解了上述五个类就足够开始使用CImg的函数。

CImg使用示例程序

下面是一个非常简单的示例程序，它创建了一个显示“Hello World”文字的图片，从中你能了解CImg最基本的使用；

  #include "CImg.h"
  using namespace cimg_library;
  int main() {
    CImg<unsigned char> img(640,400,1,3);        // Define a 640x400 color image with 8 bits per color component.
    img.fill(0);                                 // Set pixel values to 0 (color : black)
    unsigned char purple[3]={255,0,255};         // Define a purple color
    img.draw_text("Hello World",100,100,purple); // Draw a purple "Hello world" at coordinates (100,100).
    img.display("My first CImg code");           // Display the image in a display window.
    return 0;
  }

也可以写的更紧凑一些：

  #include "CImg.h"
  using namespace cimg_library;
  int main() {
    const unsigned char purple[3]={255,0,255};
    CImg<unsigned char>(640,400,1,3,0).draw_text("Hello World",100,100,purple).display("My first CImg code");
    return 0;
  }

使用CImg可以写出非常紧凑的代码，CImg能够用非常简单的代码实现一系列实用的图像处理操作；

编译

CImg非常轻量和和易于使用；除了标准的系统函数外，没有其他依赖，这样就避免了在编译阶段处理复杂的依赖关系；每个发布的CImg版本可以在如下编译器下编译通过：

• <b>Microsoft Visual C++ 6.0 and Visual Studio.NET</b> : CImg库提供了相关的参考工程文件；
• <b>Intel ICL compiler</b> : 使用如下命令在ICL下编译基于CImg的程序:

  icl /Ox hello_world.cpp user32.lib gdi32.lib

• <b>Digital Mars Compiler</b> : 使用如下命令在DMC下编译基于CImg的程序:

  dmc -Ae hello_world.cpp gdi32.lib

• <b>g++ (MingW windows version)</b> : 使用如下命令在MingW g++下编译基于CImg的程序:

// Windows下：
  g++ -o hello_word.exe hello_word.cpp -O2 -lgdi32

• <b>g++ (Linux version)</b> : 使用如下命令在Linux g++下编译基于CImg的程序 :

  g++ -o hello_word.exe hello_world.cpp -O2 -L/usr/X11R6/lib -lm -lpthread -lX11

• <b>g++ (Solaris version)</b> : 使用如下命令在g++(Solaris)下编译基于CImg的程序 :

  g++ -o hello_word.exe hello_world.cpp -O2 -lm -lpthread -R/usr/X11R6/lib -lrt -lnsl -lsocket

• <b>g++ (Mac OS X version)</b> : 使用如下命令在g++(Mac)下编译基于CImg的程序:

  g++ -o hello_word.exe hello_world.cpp -O2 -lm -lpthread -L/usr/X11R6/lib -lm -lpthread -lX11

• <b>Dev-Cpp</b> : CImg库提供了相关的参考工程文件.
  如果需要支持其他编译器，请给库作者写信；但是不支持C++模板的编译器不会被支持

其他

欢迎反馈在使用CImg中遇到的问题，以及参与完善该文档。