Linux(ubuntu系统)下使用FreeImage库
Linux(ubuntu系统)下使用FreeImage库
最近在搞一个图像处理的项目，需要用到FreeImage，之前在Windows下用过，很简单，因为FreeImage官网提供了可供使用的静态库动态库，直接包含就行了。现在需要在Linux平台下使用，发现官网并没有提供直接编译好的库，需要自己编译。安装过程也遇到好几个大坑，所幸终于解决了。记录一下自己下载编译安装的步骤：
1. 下载FreeImage源码
http://freeimage.sourceforge.net/download.html
这是官网，选择下面这个
Source distribution
Source distribution includes source for FreeImage, C++, C#, Delphi and VB6 wrappers, examples and the internally used libraries LibTIFF, LibJPEG, LibPNG, ZLib, OpenEXR, OpenJPEG, LibRaw, LibJXR and LibWebP.
Download FreeImage 3.17.0
下载即可！下载完解压得到FreeImage这个文件夹。
2. 既然是要自己编译，那么肯定是要用到makefile文件，打开FreeImage文件夹可以看到里面有很多makefile的文件，只是后缀不一样罢了：
这些其实只是给不同的系统环境下用的而已，继续在文件夹中找可以看到一个叫做“README.linux”的文件，这就是关于在linux下如何安装使用的说明文档了，打开它，按照里面的说明来操作。
摘录一些重要的信息：
1)为了编辑和使用FreeImage库，你不需要在你的电脑/usr/lib directory目录下安装任何third party libraries。
2)为了避免internal third party libraries和系统库之间的不兼容，FreeImage makefile使用了gcc的
"-fvisibility=hidden"选项，如果你使用的是老版本的gcc，你可能得先移除这个选项
3)在库编辑安装之后，你应该可以使用-lfreeimage option来link programs。You can also statically link with libfreeimage.a.
4) 安装FreeImage
------------
注意：你需要获得root权限才可以在/usr/lib目录下安装库
安装步骤很简单，如下:
1) Enter the FreeImage directory
2) Build the distribution :
make
make install
3) Clean all files produced during the build process
make clean
可以看到，安装使用的方式其实很简单，就是
(1)在FreeImage的目录下右键打开终端，先输入make命令进行编译。
(2)编译好之后使用make install将编译好的头文件FreeImage.h写进系统的/usr/include目录下，把库文件libfreeimage.o给写进系统的/usr/lib目录下。
(3)然后执行make clean清除刚才编译生成的那些中间文件即可。
但是！！！并没有想当然的那么简单，首先输入make命令是正常在编译了，但是编译完之后提示了下面的错误：
dsp.upsampling_mips_dsp_r2.o
Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.c:37:34: error: invalid character ' ' in raw string delimiter
"shll_s.w %["#R"], %["#R"], 9 \n\t"
^
Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.c:37:48: error: invalid character ' ' in raw string delimiter
"shll_s.w %["#R"], %["#R"], 9 \n\t"
^
Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.c:40:34: error: invalid character ' ' in raw string delimiter
"precrqu_s.qb.ph %["#R"], %["#R"], $zero \n\t"
^
Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.c:40:48: error: invalid character ' ' in raw string delimiter
"precrqu_s.qb.ph %["#R"], %["#R"], $zero \n\t"
^
Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.c:43:34: error: invalid character ' ' in raw string delimiter
"srl %["#R"], %["#R"], 24 \n\t"
^
Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.c:43:48: error: invalid character ' ' in raw string delimiter
"srl %["#R"], %["#R"], 24 \n\t"
^
Makefile.gnu:61: recipe for target 'Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.o' failed
make[1]: *** [Source/LibWebP/./src/dsp/dsp.upsampling_mips_dsp_r2.o] Error 1
make[1]: Leaving directory '/home/jianqiang/Documents/FreeImage'
Makefile:21: recipe for target 'default' failed
make: *** [default] Error 2
Error的内容是invalid character '' ub raw string delimiter.意思是原始字符串分隔符中有无效字符。产生这个错误的原因是编译器支持了C++11的新标准，在C++ 11中引入了原始字符串这样一个新特性：使用''R''等方式来定义一个不进行转义的字符串。而在FreeImage的一些代码中，却使用了R作为一些宏函数的参考，所以在FreeImage中那些被当成了原始字符串，从而产生了错误。
定位到提示错误的文件dsp.unsampling_mips_dsp_r2.c，打开之后找到对应的错误行，是下面这些：
#if !defined(WEBP_YUV_USE_TABLE)
#define YUV_TO_RGB(Y, U, V, R, G, B) do { \
const int t1 = kYScale * Y; \
const int t2 = kVToG * V; \
R = kVToR * V; \
G = kUToG * U; \
B = kUToB * U; \
R = t1 + R; \
G = t1 - G; \
B = t1 + B; \
R = R + kRCst; \
G = G - t2 + kGCst; \
B = B + kBCst; \
__asm__ volatile ( \
"shll_s.w %["#R"], %["#R"], 9 \n\t" \
"shll_s.w %["#G"], %["#G"], 9 \n\t" \
"shll_s.w %["#B"], %["#B"], 9 \n\t" \
"precrqu_s.qb.ph %["#R"], %["#R"], $zero \n\t" \
"precrqu_s.qb.ph %["#G"], %["#G"], $zero \n\t" \
"precrqu_s.qb.ph %["#B"], %["#B"], $zero \n\t" \
"srl %["#R"], %["#R"], 24 \n\t" \
"srl %["#G"], %["#G"], 24 \n\t" \
"srl %["#B"], %["#B"], 24 \n\t" \
: [R]"+r"(R), [G]"+r"(G), [B]"+r"(B) \
: \
); \
} while (0)
出现错误的地方就是所有的带有 R"] 的位置，解决方法很简单，把R换成Red即可。
#if !defined(WEBP_YUV_USE_TABLE)
#define YUV_TO_RGB(Y, U, V, Red, G, B) do { \
const int t1 = kYScale * Y; \
const int t2 = kVToG * V; \
Red = kVToR * V; \
G = kUToG * U; \
B = kUToB * U; \
Red = t1 + Red; \
G = t1 - G; \
B = t1 + B; \
Red = Red + kRCst; \
G = G - t2 + kGCst; \
B = B + kBCst; \
__asm__ volatile ( \
"shll_s.w %["#Red"], %["#Red"], 9 \n\t" \
"shll_s.w %["#G"], %["#G"], 9 \n\t" \
"shll_s.w %["#B"], %["#B"], 9 \n\t" \
"precrqu_s.qb.ph %["#Red"], %["#Red"], $zero \n\t" \
"precrqu_s.qb.ph %["#G"], %["#G"], $zero \n\t" \
"precrqu_s.qb.ph %["#B"], %["#B"], $zero \n\t" \
"srl %["#Red"], %["#Red"], 24 \n\t" \
"srl %["#G"], %["#G"], 24 \n\t" \
"srl %["#B"], %["#B"], 24 \n\t" \
: [R]"+r"(R), [G]"+r"(G), [B]"+r"(B) \
: \
); \
} while (0)
修改完这个文件中的错误，和刚才那个文件在同一个目录下还有一个会出现同样错误的文件：dsp.yuv_mips_dsp_r2.c
这个的错误出现在第75行的"#R"(%[dst])
"shll_s.w %[temp7], %[temp7], 9 \n\t" \
"precrqu_s.qb.ph %[temp5], %[temp5], $zero \n\t" \
"precrqu_s.qb.ph %[temp6], %[temp6], $zero \n\t" \
"precrqu_s.qb.ph %[temp7], %[temp7], $zero \n\t" \
"srl %[temp5], %[temp5], 24 \n\t" \
"srl %[temp6], %[temp6], 24 \n\t" \
"srl %[temp7], %[temp7], 24 \n\t" \
"sb %[temp5], "#R"(%[dst]) \n\t" \
"sb %[temp6], "#G"(%[dst]) \n\t" \
"sb %[temp7], "#B"(%[dst]) \n\t" \
同样按照上面的方式把R用Red替换即可。
保存修改，然后重新打开终端窗口输入：make。
这些就会执行成功了！为了验证我们可以打开FreeImage/Dist文件夹，会发现下面生成了3个文件：
FreeImage.h就是头文件，libfreeimage.a就是linux版本的库文件(Windows下同下是.lib)。
3. 其实进行到上面这一步，那两个文件你就可以拿去用了，用来编写自己的程序什么的。但是如果你要在本机上写一些代码来用，那就需要在本机上安装一下FreeImage，说是安装，其实就是执行了两次拷贝操作而已：
把FreeImage.h文件写入到系统目录/usr/include文件夹下
把libfreeimage.a写入到系统目录/usr/lib文件夹下
当然，你不需要自己亲手来进行写入，因为并不是直接复制粘贴就可以，linux系统下的系统目录你没有root权限是没办法直接复制粘贴文件的。我们直接使用命令就好，在终端继续输入：
sudo make install
系统就会自动执行上面的两个操作了，sudo是获取root权限的意思，如果你按照官网文档说明只使用make install，是会报错提示你要先获取root权限的，所以直接使用上面的命令就好。
4. 最后我们执行一次
make clean
将刚才编译过程中生成的中间文件都删除掉就可以了。
Linux(ubuntu系统)下使用FreeImage库相关教程
