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 ,