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库相关教程