本手册主要介绍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中遇到的问题，以及参与完善该文档。
