以下是JpGraph库中Graph类(基础图表容器)的详细讲解:
一、核心功能
Graph类是所有图表的基础容器,负责管理图表整体布局和坐标系。主要功能包括:
管理图表尺寸和边距
维护X/Y轴坐标系系统
处理标题和图例位置
控制图像输出格式
二、构造方法
__construct($width, $height):创建指定尺寸的图表对象SetScale($aAxisType):设置坐标轴比例类型(线性/对数等)
三、样式配置方法
背景设置:
SetColor($aColor):设置背景色SetShadow($aShow=true, $aShadowWidth=5):设置阴影效果SetFrame($aFlg=true, $aColor=array(0,0,0)):设置边框样式标题设置:
title->Set($aTitle):主标题subtitle->Set($aTitle):副标题xaxis->title->Set($aTitle):X轴标题yaxis->title->Set($aTitle):Y轴标题
四、坐标轴控制
SetAxis($aXAxis, $aYAxis):绑定坐标轴对象SetMargin($lm, $rm, $tm, $bm):设置四周边距(像素)SetUserMargin($aLeft, $aRight, $aTop, $aBottom):百分比边距设置
五、绘图方法
Add($aPlot):添加图表元素(线图/柱状图等)Stroke($aFileName=null):输出图像到文件或浏览器DisplayCSIM($aAlt='', $aScriptName=''):生成客户端图像映射
六、高级功能
多Y轴支持:
SetYScale($aAxisNum, $aScale):添加额外Y轴SetY2Scale($aAxisNum, $aScale):右侧Y轴设置网格控制:
xgrid->Show():显示X轴网格ygrid->SetLineStyle($aStyle):设置网格线样式交互功能:
SetCSIMTarget($aTarget):设置图像映射目标SetCSIMAlt($aAlt):设置替代文本
七、典型使用流程
// 1. 创建图表对象
$graph = new Graph(800, 600);
// 2. 设置坐标轴和标题
$graph->SetScale("textlin");
$graph->title->Set("销售报表");
// 3. 添加图表元素
$lineplot = new LinePlot($ydata);
$graph->Add($lineplot);
// 4. 输出图像
$graph->Stroke();注意事项:
需先包含jpgraph.php基础文件
图表尺寸单位默认为像素
所有颜色参数使用RGB数组格式