红联Linux门户
Linux帮助

Linux(ubuntu系统)下使用FreeImage库

发布时间:2017-07-12 09:41:41来源:linux网站作者:邓无邪
最近在搞一个图像处理的项目,需要用到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的文件,只是后缀不一样罢了:
Linux(ubuntu系统)下使用FreeImage库
这些其实只是给不同的系统环境下用的而已,继续在文件夹中找可以看到一个叫做“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个文件:
Linux(ubuntu系统)下使用FreeImage库
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
将刚才编译过程中生成的中间文件都删除掉就可以了。
 
本文永久更新地址:http://www.linuxdiyf.com/linux/31934.html