pChart 2.13官方文档：PHP开发者的pChart库操作指南

5星 · 超过95%的资源需积分: 12 153 浏览量更新于2024-07-28 1 收藏 2.59MB PDF 举报

pChart是一款专为PHP开发设计的高级图表库，版本为2.13。该文档是官方提供的完整帮助资料，旨在指导用户深入了解pChart类库的基本操作和功能。pChart库允许开发者在Web应用中创建各种复杂的图形，包括线图、柱状图、饼图、散点图等，以清晰地呈现数据和信息。文档首先明确了版权信息，声明所有权利归pChart所有，且根据GNU许可协议提供，用户在全球范围内可以自由传播。在使用pChart时，开发者应理解并接受文档中提及的条款，即软件提供“按原样”（AS IS），不附带任何形式的明示或默示保证，包括适销性和特定用途的适用性。这意味着，虽然pChart是经过精心设计的，但使用者在使用过程中可能遇到的问题或不完善之处，版权持有者和贡献者不对任何直接或间接损失负责，无论是由于合同责任、严格责任还是侵权行为（如疏忽）造成的损害，包括但不限于经济损失、数据丢失或业务中断。文档中的例子中列举的人名、公司名、邮箱地址和URL都是虚构的，任何与现实存在的相似性纯属巧合。此外，文档还指出提及第三方产品和链接仅为信息参考，并非推荐或认可，仅用以展示可能的应用场景。要开始使用pChart 2.13，开发者需要了解如何安装、配置库，熟悉类库的API，以及如何通过代码实例化图表对象、设置样式、添加数据系列和绘制图形。此外，还包括了如何调整坐标轴、图例、标题等元素，以及如何实现交互式图表，如鼠标悬停提示、点击事件等。文档还涵盖了错误处理、性能优化和国际化支持等内容，确保开发者能够充分利用pChart的功能，同时避免常见的问题。为了进一步提高效率，pChart 2.13文档可能还会介绍如何与其他PHP框架或库集成，以及如何在服务器端渲染图表以减少页面加载时间。 pChart 2.13帮助文档是一个全面的指南，为PHP开发者提供了丰富的工具，帮助他们在项目中高效地生成专业水准的图表，提高用户体验。

• The background color can be set with BoxR, BoxG, BoxB.

• The background alpha can be set with BoxAlpha.

• You can draw rounded corners setting BoxRounded to TRUE.

• The corner radius can be set withRoundedRadius.

• You can specify if the box will have a border setting DrawBoxBorder to TRUE.

• You can specify a border surrounding factor with BoxSurrounding.

• The border color can be set with BoxBorderR, BoxBorderG, BoxBorderB.

• The border alpha can be set with BoxBorderAlpha.

Sample script

Code sample

/* pChart library inclusions */

include("../class/pDraw.class.php");

include("../class/pImage.class.php");

/* Create the pChart object */

$myPicture = new pImage(700,230);

/* Draw the background */

$Settings = array("R"=>170, "G"=>183, "B"=>87, "Dash"=>1, "DashR"=>190, "DashG"=>203, "DashB"=>107);

$myPicture->drawFilledRectangle(0,0,700,230,$Settings);

/* Overlay with a gradient */

$Settings = array("StartR"=>219, "StartG"=>231, "StartB"=>139, "EndR"=>1, "EndG"=>138, "EndB"=>68, "Alpha"=>50);

$myPicture->drawGradientArea(0,0,700,230,DIRECTION_VERTICAL,$Settings);

$myPicture->drawGradientArea(0,0,700,20,DIRECTION_VERTICAL,array("StartR"=>0,"StartG"=>0,"StartB"=>0,"EndR"=>50,"EndG"=>50,"EndB"=>50,"

Alpha"=>80));

/* Add a border to the picture */

$myPicture->drawRectangle(0,0,699,229,array("R"=>0,"G"=>0,"B"=>0));

/* Write the picture title */

$myPicture->setFontProperties(array("FontName"=>"../fonts/Silkscreen.ttf","FontSize"=>6));

$myPicture->drawText(10,13,"drawText() - add some text to your charts",array("R"=>255,"G"=>255,"B"=>255));

/* Enable shadow computing */

$myPicture->setShadow(TRUE,array("X"=>1,"Y"=>1,"R"=>0,"G"=>0,"B"=>0,"Alpha"=>20));

/* Write some text */

$myPicture->setFontProperties(array("FontName"=>"../fonts/advent_light.ttf","FontSize"=>20));

$TextSettings = array("R"=>255,"G"=>255,"B"=>255,"Angle"=>10);

Page 16

$myPicture->drawText(60,115,"10 degree text",$TextSettings);

/* Write some text */

$TextSettings = array("R"=>0,"G"=>0,"B"=>0,"Angle"=>0,"FontSize"=>40);

$myPicture->drawText(220,130,"Simple text",$TextSettings);

/* Write some text */

$TextSettings = array("R"=>200,"G"=>100,"B"=>0,"Angle"=>90,"FontSize"=>14);

$myPicture->drawText(500,170,"Vertical Text",$TextSettings);

/* Write some text */

$myPicture->setFontProperties(array("FontName"=>"../fonts/Bedizen.ttf","FontSize"=>6));

$TextSettings = array("DrawBox"=>TRUE,"BoxRounded"=>TRUE,"R"=>0,"G"=>0,"B"=>0,"Angle"=>0,"FontSize"=>10);

$myPicture->drawText(220,160,"Encapsulated text",$TextSettings);

/* Write some text */

$myPicture->setFontProperties(array("FontName"=>"../fonts/Forgotte.ttf","FontSize"=>6));

$TextSettings = array("DrawBox"=>TRUE,"R"=>0,"G"=>0,"B"=>0,"Angle"=>0,"FontSize"=>10);

$myPicture->drawText(220,195,"Text in a box",$TextSettings);

/* Render the picture (choose the best way) */

$myPicture->autoOutput("pictures/example.drawText.png");

drawGradientArea - Rectangular gradient area

This function allows you to draw rectangular gradient areas. Most of the time, you‘ll use this function to build your image background. It

is possible to tune the rendering by playing with the $Format array. To learn more about this please read the Format array guide. This

functions are supporting anti-alias and shadows.

Calling this function

drawGradientArea($X1,$Y1,$X2,$Y2,$Direction,$Format="");

Where :

• X1,Y1 are the start coordinate of the rectangle.

• X2,Y2 are the end coordinate of the rectangle.

• Direction is either DIRECTION_VERTICAL or DIRECTION_HORIZONTAL .

• Format is an array containing the drawing parameters.

Customisation array - Tune up your gradient area!

It is possible to customize the rendering by playing with this array. Providing a detailled configuration is not mandatory, by default the

gradient will be drawn with grey levels and no transparency.

• The start color can be set with StartR, StartG, StartB.

• The end color can be set with EndR, EndG, EndB.

• The alpha transparency factor can be set with Alpha.

• If Levels is specified, this will override the end colors by adding this value to the start colors. Levels can be either a positive or negative integer.

Sample script

Page 17

Code sample

/* Left areas*/

$GradientSettings = array("StartR"=>181,"StartG"=>209,"StartB"=>27,"Alpha"=>100,"Levels"=>-50);

$myPicture->drawGradientArea(20,60,400,170,DIRECTION_HORIZONTAL,$GradientSettings);

$GradientSettings = array("StartR"=>209,"StartG"=>134,"StartB"=>27,"Alpha"=>30,"Levels"=>-50);

$myPicture->drawGradientArea(30,30,200,200,DIRECTION_VERTICAL,$GradientSettings);

/* Right areas*/

$GradientSettings = array("StartR"=>209,"StartG"=>31,"StartB"=>27,"Alpha"=>100,"Levels"=>50);

$myPicture->drawGradientArea(480,50,650,80,DIRECTION_HORIZONTAL,$GradientSettings);

$GradientSettings = array("StartR"=>209,"StartG"=>125,"StartB"=>27,"Alpha"=>100,"Levels"=>50);

$myPicture->drawGradientArea(480,90,650,120,DIRECTION_VERTICAL,$GradientSettings);

$GradientSettings = array("StartR"=>209,"StartG"=>198,"StartB"=>27,"Alpha"=>100,"Levels"=>50);

$myPicture->drawGradientArea(480,130,650,160,DIRECTION_HORIZONTAL,$GradientSettings);

$GradientSettings = array("StartR"=>134,"StartG"=>209,"StartB"=>27,"Alpha"=>100,"Levels"=>50);

$myPicture->drawGradientArea(480,170,650,200,DIRECTION_HORIZONTAL,$GradientSettings);

This will draw 5 gradient areas with different directions and alpha factors.

drawCircle - Circles

This function allows you to draw circles. It is possible to tune the rendering by playing with the $Format array. To learn more about this

please read the Format array guide. This functions are supporting anti-alias and shadows.

Calling this function

drawCircle($X1,$Y1,$Width,$Height,$Format="");

Where :

• X1,Y1 are the center coordinate of the circle.

• Width is the width of the circle.

• Height is the heightof the circle.

• Format is an array containing the drawing parameters.

Information

This function can draw an ellipse by using different values for width and height.

Customisation array - Tune up your circle!

It is possible to customize the circle rendering by playing with this array. Providing a detailled configuration is not mandatory, by default

the circles will be drawn black with no transparency.

• The border color can be set with R, G, B.

• The alpha transparency factor can be set with Alpha.

• You can draw dashed lines using the Ticks parameter.

Page 18

Sample script

Code sample

/* Left circles with different alpha transparency */

$myPicture->drawCircle(100,125,50,50,array("R"=>213,"G"=>226,"B"=>0,"Alpha"=>100));

$myPicture->drawCircle(140,125,50,50,array("R"=>213,"G"=>226,"B"=>0,"Alpha"=>70));

$myPicture->drawCircle(180,125,50,50, array("R"=>213,"G"=>226,"B"=>0,"Alpha"=>40));

$myPicture->drawCircle(220,125,50,50,array("R"=>213,"G"=>226,"B"=>0,"Alpha"=>20));

/* Active shadow support */

$myPicture->setShadow(TRUE,array("X"=>1,"Y"=>1,"R"=>0,"G"=>0,"B"=>0,"Alpha"=>20));

/* Right circles */

$CircleSettings = array("R"=>209,"G"=>31,"B"=>27,"Alpha"=>100);

$myPicture->drawCircle(480,60,20,20,$CircleSettings );

$CircleSettings = array("R"=>209,"G"=>125,"B"=>27,"Alpha"=>100);

$myPicture->drawCircle(480,100,30,20,$CircleSettings );

$CircleSettings = array("R"=>209,"G"=>198,"B"=>27,"Alpha"=>100,"Ticks"=>4);

$myPicture->drawCircle(480,140,40,20,$CircleSettings );

$CircleSettings = array("R"=>134,"G"=>209,"B"=>27,"Alpha"=>100,"Ticks"=>4);

$myPicture->drawCircle(480,180,50,20,$CircleSettings );

This will draw some transparency test on the left side of the picture and 4 colored boxes on the right. Shadow support is enabled on a

(+1,+1) basis.

drawRoundedRectangle - boxes with rounded corners

This function allows you to draw rectangles with rounded corners. It is possible to tune the rendering by playing with the $Format

array. To learn more about this please read the Format array guide. This functions are supporting anti-alias and shadows.

Calling this function

drawRoundedRectangle($X1,$Y1,$X2,$Y2,$Radius,$Format="");

Where :

• X1,Y1 are the start coordinate of the rectangle.

• X2,Y2 are the end coordinate of the rectangle.

• Radius is the radius of the rounded corners.

• Format is an array containing the drawing parameters.

Customisation array - Tune up your box!

It is possible to customize the rendering by playing with this array. Providing a detailled configuration is not mandatory, by default the

rectangle will be drawn black with no transparency.

• The line color can be set with R, G, B.

Page 19

• The alpha transparency factor can be set with Alpha.

Sample script

Code sample

/* Enable shadow support */

$myPicture->setShadow(TRUE,array("X"=>1,"Y"=>1,"R"=>0,"G"=>0,"B"=>0,"Alpha"=>20));

/* Left green box */

$RectangleSettings = array("R"=>181,"G"=>209,"B"=>27,"Alpha"=>100);

$myPicture->drawRoundedRectangle(20,60,400,170,10,$RectangleSettings);

/* Left orange surrounding box with an alpha factor of 30% */

$RectangleSettings = array("R"=>209,"G"=>134,"B"=>27,"Alpha"=>30);

$myPicture->drawRoundedRectangle(30,30,200,200,10,$RectangleSettings);

/* Right Red box */

$RectangleSettings = array("R"=>209,"G"=>31,"B"=>27,"Alpha"=>100);

$myPicture->drawRoundedRectangle(480,50,650,80,5,$RectangleSettings);

/* Right Orange box */

$RectangleSettings = array("R"=>209,"G"=>125,"B"=>27,"Alpha"=>100);

$myPicture->drawRoundedRectangle(480,90,650,120,5,$RectangleSettings);

/* Right Yellow box */

$RectangleSettings = array("R"=>209,"G"=>198,"B"=>27,"Alpha"=>100);

$myPicture->drawRoundedRectangle(480,130,650,160,5,$RectangleSettings);

/* Right Green box */

$RectangleSettings = array("R"=>134,"G"=>209,"B"=>27,"Alpha"=>100);

$myPicture->drawRoundedRectangle(480,170,650,200,5,$RectangleSettings);

This will draw some transparency test on the left side of the picture and 4 colored boxes on the right. Shadow support is enabled on a

(+1,+1) basis.

drawAntialiasPixel - Drawing alpha pixels

This function allows you to draw aliased alpha pixels on your pictures. It is possible to tune the rendering by playing with the $Format

array. To learn more about this please read the Format array guide. Pixels like all simple drawing functions are supporting anti-alias

and shadows.

drawAntialiasPixel is a core function of pChart. A lot of internal drawing methods are based on it as the whole antialiasing processing

is done trough it. Antialias can only be done on a pixel unit. To learn more on antialiasing, read this article.

Calling this function

drawAntialiasPixel($X,$Y,$Format="");

Where :

• X,Y are the coordinate of the pixel.

Page 20

剩余216页未读，继续阅读

feitian19873000

粉丝: 7
资源: 72

pChart 2.13官方文档：PHP开发者的pChart库操作指南

pChart 1.27

c-pchart, 将Composer支持和PSR标准引入 pChart 2.0库的项目.zip

php图表类pchart

wampserver 安装 pChart

pChart wmapserver

pChart 画双y轴 qt

show me an example of pChart

CClientDC dc(m_pChart); CRect rect; m_pChart->GetClientRect(&rect);这句是什么意思

CBCGPChartLongSeries* pSeries = DYNAMIC_DOWNCAST(CBCGPChartLongSeries, pChart->GetSeries(0)); 为什么pSeries是空

php 画k线图

最新资源