jpgraph-2.3.3使用文档

jpgraph-2.3.3使用文档
本文档同样适用于2.3.3临近版本
下载
在官方网站 http://www.aditus.nu/jpgraph/ 下载jpgraph，其中1.X系列是用于PHP4的，2.X系列是用于PHP5的。

安装
将下载的得到的jpgraph压缩文件解压至相应的路径。

配置
首先需要注意的是：要想适用jpgraph，你的PHP必须开启了GD2扩展。
在jpgraph.php中有以下这样一段代码是设置字体文件路径的
if (!defined('TTF_DIR')) {
       if (strstr( PHP_OS, 'WIN') ) {
       $sroot = getenv('SystemRoot');
           if( empty($sroot) ) {
           $t = new ErrMsgText();
           $msg = $t->Get(12,$file,$lineno);
           die($msg);
           }
       else {
       DEFINE('TTF_DIR', './fonts/fonts/');
           }
       } else {
       DEFINE('TTF_DIR','/usr/X11R6/lib/X11/fonts/truetype/');
       }
}


如果要支持中文需要用到simhei.ttf和simsun.ttc这两个字体，但是一般Linux下面是没有这两个字体的。
实际上，我们可以将字体文件路径设置到WEB目录里面，然后将Windows里面的这两个字体拷贝到字体文件目录中，这样不管是什么系统，都可以使用这两个字体了。也就是将上面的代码改成下面这样
if (!defined('TTF_DIR')) {
    DEFINE('TTF_DIR', JPA_ROOT.'fonts/');
}

在使用中文的时候需要使用SetFont(FF_SIMSUN,FS_BOLD)设置字体。

如果你的文件编码是gb2312,SetFont方法的第一个参数为FF_SIMSUN即可正常显示汉字
如果你的文件编码为utf-8,修改方法如下：
代码：
方法一，在程序中修改
$title="中国人";
$title = iconv("UTF-8", "gb2312", $title);
$graph->title->Set($title);
方法二，修改源文件jpgraph_ttf.inc.php
在第99-106行，改成下面这样子
    elseif( $aFF === FF_SIMSUN ) {
        // Do Chinese conversion
        /*
        if( $this->g2312 == null ) {
        include_once 'jpgraph_gb2312.php' ;
        $this->g2312 = new GB2312toUTF8();
        }
        return $this->g2312->gb2utf8($aTxt);
        */
        return $aTxt;
    }

jpgraph默认显示汉字时是把汉字编码认为gb2312,转化为utf-8以后再显示。
这样的话，如果你的文件编码是gb2312,SetFont方法的第一个参数为FF_SIMSUN即可。
如果你是utf-8编码你还需要先把汉字编码转化为gb2312，这样你的汉字才可以正常显示。

使用
可以参照jpgraph-2.3.3/src/Examples中的例子。下面是一些常用的：
$graph->title->Set(‘设置图表的标题’);
$graph->xaxis->title->Set("设置X轴的标题");
$graph->yaxis->title->Set("设置Y轴的标题");

//设置字体 如果是中文，第一个参数一般设置为FF_SIMSUN
SetFont(FF_SIMSUN,FS_BOLD,14);
//如设置图表标题的字体
$graph->title->SetFont(FF_SIMSUN,FS_BOLD,14);

//设置颜色
SetColor('red');

//设置输出格式
SetFormat('%d');

更多信息参考jpgraph官方手册及class参考（英文）。


作者：Mosee
网站：http://mosee.blogbus.com