最近在搞一个图像处理的项目,需要用到FreeImage,之前在Windows下用过,很简单,因为FreeImage官网提供了可供使用的静态库动态库,直接包含就行了。现在需要在Linux平台下使用,发现官网并没有提供直接编译好的库,需要自己编译。安装过程也遇到好几个大坑,所幸终于解决了。记录一下自己下载编译安装的步骤:
1.下载FreeImage源码
https://sourceforge.net/projects/freeimage/
这是官网,选择下面这个
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
将刚才编译过程中生成的中间文件都删除掉就可以了。