CImg库快速学习笔记

CImg库快速学习笔记

中山大学，曾坤老师的《计算机视觉》需要。

本文部分翻译自CImg_latest安装包中附带的英文文档的8 Class Documentation部分，以及互联网中的参考资料。如有错漏，烦请提醒更正。
希望你看到这篇文章的时候中大计算机视觉课仍然在使用这个库。
还没写完，有空再补

CImg库只包含一个CImg.h文件，其中所有的类和函数都被定义在了cimg_library命名空间中，所以一般来说可以直接将这个命名空间作为缺省命名空间使用：using namespace cimg_library

CImg<T>

下面的所有函数，如果没有特别指明，都为CImg<T>的成员函数（或属性）

图读写

CImg本身是一个泛型的类，一般而言接受一个unsigned char的参数，可以使用CImg<unsigned char> xxx(height,width,?,?)来创建空白图像，并进行填充，也可以使用字符串参数直接读写文件。

使用CImg.display("Windows name")可以预览图像，便于调试

构造函数与赋值

• 无参数，构造一个空的图
• 四个参数，代表x,y,z,channel
• 五个参数，(x,y,z,channel)和默认填充值
• 4+n个参数，(x,y,z,channel)和两个以上的i参数作为数据
• assign()函数，默认为库内调用(in-place version)，等同于同参数的构造函数。
• move_to(CImg )，将图像的所有内容传给参数中的这个CImg对象，并用一个空的实例来代替原来的对象。
• swap(CImg )，字面意思
• empt()，返回一个空图的引用
• clear()，等价与assign()的无参数版本
• load(filename)，从文件中读取图片

调试数据与结果

• print()，输出
• display()，打印图像
• save()，保存

图像属性与辅助计算

• CImg<T>.width()/height()/depth()/spectrum() 返回宽度/高度/深度/通道数
• longT offset(const int x,y=0,z=0,c=0) 代表x,y,z,channel，计算位移offset
• pixel_type() 返回一个字符串作为CImg的数据类型
• bool is_overlapped(const CImg<t> & img) const 检测图像重叠

全局辅助计算

• CImg<T>& sqr()，计算每个像素值的平方，并替换原来的值。
• CImg<T>& sqr()，计算每个像素值的平方根，并替换原来的值。
• CImg<T>& exp(),将每个像素值作为e的指数进行计算
• log() 自然对数，同，此外还有相似的log2、log10，数学上还有abs()、sign()、cos()、sin()、sinc()，等等。
• min(T value)、max(T value)，将 I x , y , z