win32下FreeType2的编译

其实网络上已经有很多关于这方面的知识了，这篇文章的目的也只在于加深印象，积累经验，有人告诉我，写文章对自己也是一种很好的帮助。希望这篇文章对其它人也有一点帮助，由于文笔水平不好，表述不清楚之与错误之处，还请见详。
关于FreeType2L的介绍我不多说了，网上的文章还是比较多的。还有，本文只介绍我的安装经历，不对FreeType2库的使用做介绍，如有需要，大家自己看参考手册。

开篇：

从http://www.freetype.org下载源代码。

FreeType2库源码包中包含多种环境与编译器下的make文件，其中还包含vc的项目文件。

我用的是VC，所以首先找到VC环境的项目文件。该文件在 /builder/win32/visualc目录下面，该目录包含vc6与vs2005的项目文件。不过好像它的vc6版本的项目文件有点问题，我用vc6是不能正确打开的，不过vs2005可以很好的工作。打开vs2005的项目进行编译就可以了，没有错误的放就会在/objs目录下产生相应的lib静态库文件。以上过程是通常的方法。

但是现在遇到一个问题是，因为官方所给的项目文件只能产生静态链接库文件(LIB)，如果你想产生动态链接库(DLL)文件的话，那你就得自己想办法了。我的的重点也在于讲如何编译成DLL文件。
我的工作环境是VC6，但由于官方给出的vc6文件是有问题，我也懒得去看到底是什么问题了，所以我倾向于重建自己的项目文件。

解决：
Freetype2是一个高度可定制化的库，而FreeType2包内的文档也足够让我做到我想做的事情。
第一步：
我参考的第一个文档是/doc目录下的INSTALL.ANY。该文档其实已经把标准编译所要包含的文件及它们的作用说得很清楚了，那我现在要做的就是新建一个vc6 win32DLL工程，选择empty工程选项，产生一个空dll工程了，然后按照INSTALL.ANY的说明把需要加入的文件加入工程内，INSTALL.ANY文件内有一很明显的提醒：“DO NOT COMPILE ALL C FILES!”，就是不要编译所有的C文件，这点应该注意。
第二步：
第二个参照和修改的文件是ftoption.h，该文件在/include/freetype/config目录下，该目录主要存放一些配置头文件。ftoption.h文件里对每一可定制项目都有很详细的解释，而且还给出了使用ftoption.h配置FreeType2库的三种手段。那我用的方法不知道是不是其中之一：
一、首先备份一下ftoption.h，如，另存为ftoption_bak.h文件。
二、根据ftoption.h在"DLL export compilation"项里的描述，FreeType2库在需要导出的函数前都使用了FT_EXPORT(用在函数定义处)，FT_EXPORT_DEF(用在函数声明处）两个宏，因此我只需要重新定义这两个宏就OK了。FreeType2库对于FT_EXPORT和FT_EXPORT_DEF宏的缺省定义在ftconfig.h文件中。

我的做法是，在ftopion.h的该处重新定义自己的FT_EXPORT和FT_EXPORT_DEF,如下所示：

#ifdef FT2_DLL     //因为在静态库与动态中都使用该文件，所以区别使用该指示字，使用FT2_DLL表示要编译为DLL动态库。
#ifdef FT2_EXPORTS   //按照微软的标准做法，定义__declspec(dllexport)与__declspec(dllimport)
   #define FT_EXPORT( x ) __declspec(dllexport) x
   #define FT_EXPORT_DEF( x ) x
#else      //按照微软的说法，其它__declspec(dllimport)也可以不要的，但这样做更有效率并且如果不这么做时，在导出变量时有时会出现问题，so!照他说的做吧。
   #define FT_EXPORT( x ) __declspec(dllimport) x
   #define FT_EXPORT_DEF( x ) x
#endif
#endif

编译DLL需要做的就已经完成了，另还要需要注意的是：因为是重建的项目文件，所以参照官方项目文件，在ftoption.h中的"Debug level "项修改如下：

#ifdef _DEBUG
#define FT_DEBUG_LEVEL_ERROR
#define FT_DEBUG_LEVEL_TRACE
#endif

三、在vc6项目文件中需要定义FT_DLL（我们在前面定义的）,FT_EXPORT（我们在前面定义的）,FT2_BUILD_LIBRARY（编译成库文件所需要的）预定义标志。然后再按常规DLL的方法定义输出目录，其它预编译指令之类，就可以生成DLL文件了，注：同时还会生成.LIB和.EXP文件。
四、我们也可以按照同样的方法新建一个空win32静态链接库项目，但预定义标志与Freetype2为相关只需要FT2_BUILD_LIBRARY（编译成库文件所需要）预定义标志。

五、建一个空工程文件包含这两个项目文件，最后一步就OK了。

FreeType2是一个灵活，可定制性高及性能很不错的库，关于更多的定制，比如模块的选择，系统接口的定制，可以参照它的安装文档，文档里都有说明。

另1：可以顺便提一下FTGL库，这个一个基于利用FreeType实现在OpenGL下字体绘制的库，因为作者没有考虑（或解决）FreeType动态库的问题，所以只包含使用FreeType2静态库的的项目文件，用FTGL库的朋友也可以根据以下思路进行更改，重建自己的项目文件。

另2：关于vc DLL使用的三种线程库：原官方FreeType2的vc项目文件的六个配置分别对应于发布和调试版本的三种线程库。单线程：指的将LIBC.lib静态链接到本库中，多线程：指的将LIBCMT.lib静态链接到本库中，多线程DLL：指的是将MSVCRT.dll动态链接到本库中。因此，使用本库的项目也要使用相应的线程库。