php jpgraph中文使用手册之jpgraph字体安装与配置方法

jpgraph类库支持两种类型的字体：bitmap和TTF字体。bitmap字体的优势是jpgraph类库自身就支持并不需要再配置。而TTF字体需要一些配置也可能需要安装一些真实的TTF字体文件。

另一方面使用bitmap字体也有缺点，比如

bitmap字体不支持italic字体类型

bitmap字体仅支持7比特的ASCII字符

仅支持0到90度的旋转字体

jpgraph配置TTF字体

注意：这是一个可选的部分，因为jpgraph即使没有TTF字体支持也可以正常工作，不过，还是强烈建议支持配置TTF字体。

下面我们假设FreeType类库已启用并通过了验证。（主要通过phpinfo函数并对GD库进行验证具体可参考jpgraph安装教程:验证系统支持jpgraph安装的方法）

由于各方面的法律问题TTF字体没有包含在JpGraph发行版中，因为许多常用的TTF字体文件受版权保护。由于最常用的WEB-字体（微软核心字体）的地位不明确。多年来虽然微软免费发布这些字体但已不能从微软的主页下载。你可以从http://corefonts.sourceforge.net/网址下载这些字体。

由于有很多高质量的TTF字体可以免费使用。就需要针对jpgraph字体进行配置，为了让jpgraph类库能够找到TTF字体文件，第一步需要确保在jpgraph类库配置文件jpg-config.inc.php中的字体路径定义正确，方法如下：

1、打开jpgraph类库配置文件jpg-config.inc.php

2、定位并找到TTF_DIR（这个定义可能根据系统的不同需要更新）。默认的字体path有几种值，其取决于jpgraph类库是安装在Windows系统下还是Unix系统下。

3、如果是在Windows平台上，jpgraph类库中的TTF字体路径需要使用标准的Windows字体目录（C:\windows\fonts\）

4、如果是在Unix平台上，可能不会有任何TTF字体安装，你可以从http://corefonts.sourceforge.net/下载并安装。许多Linux版本也可以自动安装这些字体。

5、你也可以选择从http://www.gnome.org/fonts/安装可用的Vera Bitstream TTF字体

6、你也可以选择从http://sourceforge.net/projects/dejavu安装DejaVu TTF字体

JpGraph使用标准的命名约定以便能够找到正确的特定的TTF字体文件。

如果jpgraph类库安装在运行Windows系统的计算机上，推荐使用Windows上已存在的字体文件（即C:\WINDOWS\FONTS目录下）

如果jpgraph类库安装在Unix版本的系统上，根据Unix版本和分支的不同。Unix常用的安装字体的目录是/usr/share/fonts/truetype/，如果运行在X11上，通常TrueType字体存放在/usr/X11R6/lib/X11/fonts/truetype/目录下。

最后，我们注意到jpgraph类库可以使用SetUserFont()方法安装其本身不支持的字体。（从理论上讲，还可以修改jpgraph类库源文件以支持其他字体文件，因为这需要的库代码的修改，我们不在这里进一步讨论。）

jpgraph类库使用非拉丁字体

除了欧洲的字体，还可以使用诸如西里尔文，日本，中文，希伯来文和希腊非拉丁语的字体。对于这些语言的TTF字体，jpgraph类库必须支持。

对于西里尔文的支持，必须定义jpgraph类库配置文件jpg-config.php中的LANGUAGE_CYRILLIC为True。然后可以使用Cyrillic字体替代普通字体。此设置结合CYRILLIC_FROM_WINDOWS和LANGUAGE_CHARSET可用于微调处理Cyrillic的输入。

1、如果LANGUAGE_CYRILLIC设定为Flase，将不会针对Cyrillic字符进行处理。

2、如果CYRILLIC_FROM_WINDOWS设定为True，则意味着假定输入的字符编码默认使用WINDOWS-1251。转换是通过调用convert_cyr_string($aTxt,’w',’k')函数进行。其中$aTxt代表需要进行编码的输入字符串。

3、如果CYRILLIC_FROM_WINDOWS设定为False，则意味着输入的字符编码默认使用KOI8-R。转换需要通过下列顺序进行

从而获得正确的UTF8内部编码。(jpgraph类库内部只使用UTF8编码)

4、当使用Cyrillic字符时，LANGUAGE_CHARSET选项可以用来动态转换输入的字符集。如果LANGUAGE_CYRILLIC=true，这个常量可以自动检测是否必须进行Cyrillic的转换。这个常量也可以设定为一个可变的包含当前可用输入字符的集合。一个典型的字符串是UTF-8或utf-8（不区分大小写），如果字符集既不是koi8-r也不是windows-1251的衍生，则不需要转换。

对于中文字符集，jpgraph类库支持BIG5和GB2312编码。对于BIG5编码，PHP运行环境必须支持iconv()函数。此外，定义CHINESE_TTF_FONT时必须设置为使用的BIG5字体的名称。默认设置为bkai00mp.ttf。要想在脚本中数据BIG5字体，这些字体必须为FF_CHINESE字体系列。

为了使用simsun.ttc和simhei.ttf（GB2312编码）字体，唯一的步骤是需要在正常TTF字体目录下安装这些字体，并且必须是FF_SIMSUN字体系列，当字体类型为FS_BLOD时使用simhei.ttf字体。

至此，jpgraph类库的字体配置就介绍完了。