PDF《CImg 库参考手册》

CImg 库参考手册 (中文版 v.

1.0.0) 英文版作者:David Tschumperle E-mail:David.Tschumperle@greyc.ensicaen.fr 中文版作者:谢龙(云淡风轻) E-mail:dragonxie1983@163.com 1. CImg库主页 这是CImg(C++ 图像处理模板)库的中文参考手册.本文英文版是使用doxygen工具生 成的,此中文版由谢龙(云淡风轻)翻译.本文对CImg库中全部类和函数做了一个详细的 描述. 如果你已经下载了CImg包, 你已经在目录CImg/documentation/reference/下有了这些页 的本地拷贝. 可以使用上面的菜单来定位到这些文档页面.首先,你或许应该看看现有模块的列表. 为了离线阅读,同时这里(对应连接,待修改)还有一个这个参考文档的完整的 PDF 版本. 你或许也对用这个演示文档幻灯片(英文)来对CImg库的功能有个大体的了解感兴趣. 2. CImg库模块文档 2.1.CImg库概述 CImg 是为 C++程序员设计的一个图像处理库.它为加载/保存、显示和处理多种类型的 图像,提供了有用的类和函数. 2.1.1. 库结构 CImg 库只包含了一个名为 CImg.h 的头文件.在CImg.h 中提供了一组用于加载/保存, 处理和显示图像或图像列表的 C++模板类.CImg 库有非常好的可移植性(Unix/X

11、 Windows、MacOS X、FreeBSD,……) ,同时 CImg 库非常的高效和易于使用.CImg 库是一 个令人满意的在 C++中完成图像处理工作的工具箱. 头文件 CImg.h 包含了构成 CImg 库的全部类和函数.这是 CImg 库的一个新颖之处. 这尤其意味着: z 不需要对库的提前编译.因为,CImg 函数是和你自己的 C++代码同时编译的. z 不用处理复杂的依赖关系:只要包含文件 CImg.h,你就可以使用 C++图像处理工 具箱. z 编译是按需完成的(done on the fly) :只要你程序中用到的 CImg 函数才被编译, 并出现在编译后的可执行文件中.这样可以产生没有任何无用东西的,非常紧凑 的代码. z 类成员和函数都是内联的.这样程序在执行的时候会有更好的表现. CImg 库的结构如下: z 库中全部的类和函数都被定义在 cimg_library 名字空间(对应页,待修改)下.这 个名字空间封装了这个库的全部功能,并且避免了在包含其他头文件时,可能发 生的名字冲突问题.一般来说,可以把这个名字空间作为一个缺省名字空间来使 用: #include CImg.h using namespace cimg_library;

... z 在cimg_library::cimg 名字空间(对应页,待修改)下定义了一组库所使用的低 级函数和变量.这个名字空间下被本文档介绍的函数可以在你自己的程序中安全 的使用.但是,不要 .. 使用 cimg_library::cimg 名字空间作为缺省空间,因为它包含 的某些函数同 C/C++标准库中已经定义的函数同名. z 类cimg_library::CImg(对应页,待修改)表示一个至多

4 维的,每个像素点 的类型为 T 的图像.这也是本库的核心类. z 类cimg_library::CImgList(对应页,待修改)表示 cimg_library::CImg图 像的列表.它可以被用于保存一个图像序列的不同帧. z 类cimg_library::CImgDisplay(对应页,待修改)能够在图像显示窗口中显示图 像或图像列表.你或许已经猜到了,这个类的代码是高度系统相关的.但是由于 环境变量是被CImg库自动设置的(参见环境变量设置(P7) ) ,这对程序员也是透 明的了. z 类cimg_library::CImgStats(对应页,待修改)表示图像的统计资料.使用它来 计算图像像素值中的最小值、最大值和方差,以及最小/最大像素点的位置. z 类cimg_library::CImgException(对应页,待修改)(和它的子类)被本库在发生 错误时, 用来抛出异常. 这些异常能被块 try {…} catch (CImgException) {…}捕获. 子类者明确定义了不同错误的类型. 知道了这五个类,就已经足够去享受 CImg 库的功能所带来的好处了. 2.1.2. CImg版的 Hello world 下面这段非常简单代码是用来创建一幅 Hello World 图像的.这也向你展示了一个基 本的 CImg 程序看起来是什么样子的. #include CImg.h using namespace cimg_library;