jpgraph中文使用手册:使用jpgraph生成图片概念介绍-php手册-php.cn

　　在介绍完php jpgraph安装配置教程以及第一个jpgraph实例教程后，为了更好的使用jpgraph，我们需要整理思路，了解一下使用php jpgraph编写生成图片代码时通常需要哪些步骤？用命令行是否可以生成图片？HTML标签如何来调用图像生成脚本？如何将图像写入文件？这些问题正是本教程需要解答的。即使你熟悉PHP也强烈建议你快速游览本教程以了解相关概念。

　　使用命令行生成动态图片

　　jpgraph类库可以直接使用PHP命令行方式来生成图片。其和游览器生成图片是类似的工作方式。生成的图片数据为二进制。

　　这种方式是一种使网站在固定时间间隔内高效、自动创建图片的有效方法。这会避免访问者访问网站时每次重新生成图片以增加服务器负担。

　　需要确保你的PHP命令行版本是cli版本。使用CGI/ISAPI版本的PHP由于会产生HTTP header而不能工作。

　　jpgraph使用提示：如果使用的是CGI版本，可以通过添加-q选项来抑制HTTP header的产生。推荐：PHP命令行参数使用与说明教程

　　你可以在命令行方式下通过

1	php --version

命令来查看你的PHP命令行版本是否为cli。然后，通过

1	php myimage.php > image.png

命令来生成图片，文件扩展名必须与生成的图片格式匹配。

　　如何使用jpgraph类库生成图片

　　在WEB页面上创建和使用图片共同的步骤主要有

　　1、创建一个脚本，其涵盖如下内容：通过获得数据并指定图片应如何构建、图形大小多少、使用什么颜色和字体并在图形上扩充其他东西

　　2、在应该显示图形的HTML页面上需要增加一个或多个img标签来连接PHP图像程序。当然，也完全可以通过在游览器中直接调用这些图像程序来显示。使用img标签这种方法可以在WEB页面上包含任何数量的图像。

　　需要注意的是通过正常的HTTP GET/POST方式可以传递参数给图像程序。比如

jpgraph中文使用手册:使用jpgraph生成图片概念介绍

　　这段代码可能是用来控制图像外观或传递数据到图片中应该显示的地方。注意，这可能不是最好的发送数据进行图形绘制的方法。对于有大量数据要求的图像，可以通过从数据库中获取图像脚本所需要的所有数据

　　使用jpgraph创建图形的标准步骤详解

　　当你准备使用php jpgraph类库创建你的PHP图形脚本时，一般有以下几个步骤

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

// 包含必要的类库文件
require_once 'jpgraph.php';
require_once '....';

// 创建Graph类实例
$graph = new Graph($width,$height, ...);

// 设定尺度类型
$graph->SetScale('...');

// 构建图形的细节和图形模型对象

// 将一个或多个图形模型对象添加到图形上
$graph->Add(..);

// 将图形送至游览器显示
$graph->Stroke();
?>

　　jpgraph是完全面向对象的，所以所有调用都是针对类的具体实例的。其中的基础类就是Graph，其代表整个图表。

　　在创建了Graph对象后，所有代码的添加都是为了构造图的细节。脚本中最后调用的方法Graph::Stroke()是为了将已构造好的图发送到游览器上。如果图表支持CSIM,则此方法需要修改为Graph::StrokeCSIM()

　　除了这些标准用法外，你也可以选择

　　1、直接将图表发送到文件中。这是通过指定一个文件名作为参数传递到调用的Stroke()方法中

　　2、访问GD图片处理程序

　　3、使用内置的缓存系统将之前生成的图片送出。注意：缓存系统默认是禁止的，你需要在jpg-config.inc中进行适当的设置以启用缓存系统。

　　4、使用MGraph()类在同一个图片中结合几个图形。

　　jpgraph图像压缩格式的选择

　　jpgraph类库默认是以PNG、JPEG、GIF的顺序自动选择图片格式的。哪种可用取决于安装jpgraph类库的系统。

　　有两种方法可以改变图片格式

　　1、改变jpgraph配置文件jpg-config.inc.php中定义的默认图像格式，即

1	DEFINE('DEFAULT_GFORMAT','auto')

　　如果你希望你所有的图片都是以JPG编码格式产生，你需要将其修改为

1	DEFINE('DEFAULT_GFORMAT','jpg')

　　2、在脚本中动态选择希望压缩的格式，主要通过调用Image::SetImgFormat()方法实现，比如你希望使用JPEG格式发送图片至游览器

1
2
3

$graph->img->SetImgFormat('jpeg')
?>

　　几乎所有的图表程序，最后一行都是$graph->Stroke();

　　这一行开始实际的图表创作。所有方法调用到这个阶段已经设置类库场景并指定所有必要的参数(感觉类似于photoshop的场景)。当你调用Stroke()方法时开始构建图片。假设当图片生成时没有发现任何错误，则原则上按照以下步骤

　　1、开始在内存中建立图片。这是通过分析指定的参数以及提供的数据来创建各种已指定的图形模式。

　　2、检查需要发送什么header，比如图形使用哪种图像压缩格式，然后将header发送到客户端。

　　3、发送实际的图片数据至客户端

　　图片直接写入文件说明

　　除了将图片文件流送至游览器外，也可以直接将图片写入命名的文件中。文件名必须以参数形式传递给Graph::Stroke()方法，即

1
2
3

$graph->Stroke('/tmp/myimage.png');
?>

　　有三点需要注意

　　1、PHP程序必须有你试图写入文件的目录的写入权限。如果你通过游览器运行PHP。那意味着HTTP服务器必须具有在该目录写入的权限。

　　2、文件的扩展名必须与指定的图像压缩格式匹配。

　　3、如果图片直接传输至文件，而没有送至游览器，脚本可以返回普通文本。

　　将图片写入文件同时返回到游览器中的实例说明

　　在这个jpgraph实例中，正常应该使用jpgraph类库2.5版本中的Graph::StrokeStore($aFileName)方法来替代。如果你使用的是之前的版本，由于各种原因无法升级更新，可以使用下面的绝招来实现，即使用_IMG_HANDLER选项来强迫Graph::Stroke()方法返回图像句柄(handler)并停止。然后人工首先将图像发送至选定的文件，其次将文件流使用类库中的内部方法送至游览器。即

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

//包含必要的类库文件

$graph = new Graph(400,300);

// 编写生成图片的代码

// 通过_IMG_HANDLER参数阻止图片送至游览器
$gdImgHandler = $graph->Stroke(_IMG_HANDLER);

// 默认的图片文件格式为PNG，并将图片传输至指定的文件中
$fileName = "/tmp/imagefile.png";
$graph->img->Stream($fileName);

//然后将图片送至游览器
$graph->img->Headers();
$graph->img->Stream();
?>