| 1 |
lars |
1 |
README FOR JPGRAPH
|
|
|
2 |
==================
|
|
|
3 |
|
|
|
4 |
This package contains JpGraph, an Object Oriented PHP4 Graph Plotting library.
|
|
|
5 |
|
|
|
6 |
The library is Copyright (C) 2001-2007 Aditus Consulting and
|
|
|
7 |
released under dual license QPL 1.0 for open source and educational
|
|
|
8 |
use and JpGraph Professional License for commercial use.
|
|
|
9 |
|
|
|
10 |
Please see full license details at http://www.aditus.nu/jpgraph/
|
|
|
11 |
|
|
|
12 |
* --------------------------------------------------------------------
|
|
|
13 |
* PHP5 IS NOT SUPPORTED IN THE 1.x SERIES
|
|
|
14 |
* Please use the 2.x serie if PHP5 support is required
|
|
|
15 |
* --------------------------------------------------------------------
|
|
|
16 |
|
|
|
17 |
|
|
|
18 |
Included files
|
|
|
19 |
--------------
|
|
|
20 |
README This file
|
|
|
21 |
QPL.txt QPL 1.0 Licensee
|
|
|
22 |
|
|
|
23 |
/src
|
|
|
24 |
Changelog Changelog
|
|
|
25 |
jpg-config.inc.php Configuration setup for JpGraph
|
|
|
26 |
jpgraph.php Base library
|
|
|
27 |
jpgraph_errhandler.inc.php Base library. Error handler module.
|
|
|
28 |
gd_image.inc.php Base library. GD interface class
|
|
|
29 |
jpgraph_ttf.inc.php Base library. TTF font handling
|
|
|
30 |
|
|
|
31 |
jpgraph_led.php Extension: LED digits module
|
|
|
32 |
jpgraph_log.php Extension: logarithmic scales
|
|
|
33 |
jpgraph_date.php Extension: date/time scales
|
|
|
34 |
jpgraph_line.php Extension: line plots
|
|
|
35 |
jpgraph_bar.php Extension: bar plots
|
|
|
36 |
jpgraph_error.php Extension: error plots
|
|
|
37 |
jpgraph_scatter.php Extension: scatter/impulse plots
|
|
|
38 |
jpgraph_radar.php Extension: radar plots
|
|
|
39 |
jpgraph_pie.php Extension: pie plots
|
|
|
40 |
jpgraph_pie3d.php Extension: 3D pie plots
|
|
|
41 |
jpgraph_canvas.php Extension: drawing canvas
|
|
|
42 |
jpgraph_canvtools.php Extension: utility classes for working with canvas
|
|
|
43 |
jpgraph_gantt.php Extension: Gantt chart
|
|
|
44 |
jpgraph_regstat.php Extension: Statistics and cubic splines.
|
|
|
45 |
jpgraph_stock.php Extension: Stock and box plots.
|
|
|
46 |
jpgraph_gradient.php Extension: Color gradient class
|
|
|
47 |
jpgraph_gb2312.php Extension: Chinese GB2312 to Unicode translation
|
|
|
48 |
jpgraph_plotmark.php Extension: Handle plotmarks in plots
|
|
|
49 |
jpgraph_imgtrans.php Extension: Basic image transformation
|
|
|
50 |
jpgraph_flags.php Extension: Country flags
|
|
|
51 |
jpgraph_iconplot.php Extension: Use image icons in plots
|
|
|
52 |
jpgraph_plotband.php Extension: Plotbands in graphs
|
|
|
53 |
jpgraph_plotmark.inc.php Extension: Using plotmarks in graphs
|
|
|
54 |
jpgraph_antispam.php Extension: Antispam module
|
|
|
55 |
jpgraph_utils.inc.php Extension: Non mandatory Utility classes
|
|
|
56 |
jpgraph_mgraph.php Extension: Multi graph
|
|
|
57 |
imgdata_*.inc Extension: Encoded images for plot marks
|
|
|
58 |
flags*.dat Raw Image data: Pre-compiled data for country flags.
|
|
|
59 |
|
|
|
60 |
/src/Examples A directory with example sripts.
|
|
|
61 |
Run testsuit.php to get a list of all
|
|
|
62 |
files and you can easily click on a file to
|
|
|
63 |
see the code and the resulting image.
|
|
|
64 |
|
|
|
65 |
/docs Directory with all documentation
|
|
|
66 |
/docs/index.html Documentation portal
|
|
|
67 |
|
|
|
68 |
|
|
|
69 |
Requirements:
|
|
|
70 |
-------------
|
|
|
71 |
Miminum:
|
|
|
72 |
* PHP 4.3.5 or higher
|
|
|
73 |
(earlier versions might work but is unsupported)
|
|
|
74 |
* GD 1.8.x or GD 2.15 or higher
|
|
|
75 |
|
|
|
76 |
Recommended:
|
|
|
77 |
* PHP 4.4.0
|
|
|
78 |
* PHP Builtin GD 2.28 library
|
|
|
79 |
|
|
|
80 |
Installation
|
|
|
81 |
------------
|
|
|
82 |
0. Make sure that the PHP version is compatible with the stated requirements
|
|
|
83 |
and that the PHP installation has support for the GD library.
|
|
|
84 |
Please run phpinfo() to check if GD library
|
|
|
85 |
is supported in the installation.
|
|
|
86 |
If the GD library doesn't seem to be installed
|
|
|
87 |
please consult the PHP manual under section "Image" for
|
|
|
88 |
instructions on where to find this library. Please refer to
|
|
|
89 |
the manual section "Verifying your PHP installation"
|
|
|
90 |
|
|
|
91 |
1. Unzip and copy the files to a directory of your choice where Your
|
|
|
92 |
httpd sever can access them.
|
|
|
93 |
For a global site installation you should copy the files to
|
|
|
94 |
somewhere in the PHP search path.
|
|
|
95 |
|
|
|
96 |
2. Check that the default directory paths in jpg-config.inc
|
|
|
97 |
for cache directory and TTF directory suits your installation.
|
|
|
98 |
Note1: The default directories are different depending on if
|
|
|
99 |
the library is running on Windows or UNIX.
|
|
|
100 |
Note2: Apache/PHP must have write permission to your cache
|
|
|
101 |
directory if you enable the cache feature. By default the cache
|
|
|
102 |
is disabled.
|
|
|
103 |
|
|
|
104 |
3. Check that all rest of the DEFINE in jpg-config.inc
|
|
|
105 |
is setup to your preference. The default should be fine
|
|
|
106 |
for most users. (See also Note 3. below)
|
|
|
107 |
|
|
|
108 |
4. If any problems are encounted please start by reading the FAQ on
|
|
|
109 |
http://www.aditus.nu/jpgraph/jpgraphfaq.php.
|
|
|
110 |
|
|
|
111 |
|
|
|
112 |
Documentation
|
|
|
113 |
-------------
|
|
|
114 |
The installation includes HTML documentation and reference guide for the
|
|
|
115 |
library. The portal page for all the documentation is
|
|
|
116 |
<YOUR-INSTALLATION-DIRECTORY>/docs/index.html
|
|
|
117 |
|
|
|
118 |
|
|
|
119 |
Troubleshooting
|
|
|
120 |
---------------
|
|
|
121 |
0. Make sure your PHP installation has the minimum requirements and has
|
|
|
122 |
the GD library enabled (most modern installations fulfills the minimmum
|
|
|
123 |
requirements). See chapter 3.1 in the manual.
|
|
|
124 |
|
|
|
125 |
1. If an empty page is returned back when running an example check
|
|
|
126 |
the following
|
|
|
127 |
|
|
|
128 |
i) Increase the maximum memory allowed by PHP (in php.ini) to at least 32MB
|
|
|
129 |
ii) Enable all error messages and notices in php.ini (error_reporting = E_ALL)
|
|
|
130 |
III) Make sure output buffering is disabled in php.ini (output_buffering = Off)
|
|
|
131 |
this will make it possible to see the errors more easily
|
|
|
132 |
IV) Disable any PHP accelerometer you may have installed (e.g. Zend Cache)
|
|
|
133 |
|
|
|
134 |
Then try running the example again. Most likely an error message will
|
|
|
135 |
now be shown that will give further information on what is wrong.
|
|
|
136 |
For further clarifiction on the casues for the error messages see
|
|
|
137 |
the FAQ section on the WEB site.
|
|
|
138 |
|
|
|
139 |
2. If you are running IIS and Win2k and get the error "Can't find
|
|
|
140 |
font' when trying to use TTF fonts then try to change you paths
|
|
|
141 |
to UNIX style, i.e. "/usr/local/fonts/ttf/". Remember that the
|
|
|
142 |
path is absolute and not relative to the htdocs catalogue. Some
|
|
|
143 |
versions of GD for Windows also need you to set the environment
|
|
|
144 |
variable GDFONTPATH for GD to find the fonts.
|
|
|
145 |
|
|
|
146 |
3. If you are using the cache please make sure that you have
|
|
|
147 |
set the permissions correctly for the cache directory so that
|
|
|
148 |
Apache/PHP can write to that directory.
|
|
|
149 |
|
|
|
150 |
|
|
|
151 |
Bug reports and suggestions
|
|
|
152 |
---------------------------
|
|
|
153 |
Should be reported in the issue tracker at
|
|
|
154 |
|
|
|
155 |
http://www.aditus.nu/bugtraq
|
|
|
156 |
|
|
|
157 |
|
|
|
158 |
Change history:
|
|
|
159 |
------------------------------------------------------------------------
|
|
|
160 |
Date Ver Comment
|
|
|
161 |
-----------------------------------------------------------------------
|
|
|
162 |
2007-03-25 1.21 Feature release
|
|
|
163 |
2006-09-24 1.20.5 Maintenance release
|
|
|
164 |
2006-05-26 1.20.4a Maintenance release
|
|
|
165 |
2006-02-18 1.20.3 Minor defect and feature release
|
|
|
166 |
2005-12-04 1.20 Major feature enhancements
|
|
|
167 |
2005-07-10 1.19 Various minor defects fixed
|
|
|
168 |
2005-06-06 1.18 Date scale and guide-lines for Pie
|
|
|
169 |
2005-01-16 1.17 Functional enhancement, bug fixes
|
|
|
170 |
2004-11-02 1.17-beta2 Functional enhancement, bug fixes
|
|
|
171 |
2004-09-12 1.17-beta Port to PHP5 in compatibility mode.
|
|
|
172 |
2004-06-20 1.16 Minor defect fixes
|
|
|
173 |
2004-05-04 1.15 Final 1.15
|
|
|
174 |
2004-04-19 1.15 BETA Defect fixes and code restructuring to make
|
|
|
175 |
jpgraph.php smaller.
|
|
|
176 |
2003-11-25 1.14 Additional error checking, country flags, icon etc
|
|
|
177 |
2003-08-19 1.13 BETA Improved Gantt graphs various other changes and bug fixes
|
|
|
178 |
2003-02-02 1.11 Stock charts and some minor oter changes.
|
|
|
179 |
2002-12-16 1.10 Alpha blending, cubic splines and field plots
|
|
|
180 |
2002-10-30 1.9.1 Fixed two stupid mistakes in 1.9
|
|
|
181 |
2002-10-25 1.9 TTF font change. Many small additional improvements
|
|
|
182 |
2002-09-17 1.8 Documentation update.
|
|
|
183 |
2002-09-09 1.8 BETA Functional improvements.
|
|
|
184 |
2002-07-05 1.7 Functional improvements. Rotated bar graphs.
|
|
|
185 |
2002-06-17 1.7 BETA Functional improvements.
|
|
|
186 |
2002-05-15 1.6.3 Enhancements to Gantt graphs anbd minor bug fixes.
|
|
|
187 |
2002-04-19 1.6.2 Addition of image maps for line and scatter plot
|
|
|
188 |
2002-04-07 1.6.1 Bug fixes for 3D pies and image maps for pie's
|
|
|
189 |
2002-04-01 1.6 Functional improvments
|
|
|
190 |
2002-04-01 1.6 BETA Beta candidate for 1.6
|
|
|
191 |
2002-03-01 1.5.3 Fix minor release problem in 1.5.2
|
|
|
192 |
2002-02-29 1.5.2 Minor bug fixes.
|
|
|
193 |
2002-02-11 1.5.1 Minor bug fixes.
|
|
|
194 |
2002-01-27 1.5 Functional improvements. Gantt charts.
|
|
|
195 |
2002-01-17 1.5-BETA2 Functional improvements, bug fixes
|
|
|
196 |
2001-12-16 1.5-BETA Functional improvements, gantt-charts, bug fixes.
|
|
|
197 |
2001-11-12 1.4 Functional improvements, bug fixes.
|
|
|
198 |
2001-09-23 1.3.1 Minor bug fixes
|
|
|
199 |
2001-09-13 1.3 Major functional enhancements and minor bugfixes
|
|
|
200 |
2001-04-29 1.2.2 Minor bug fixes. Addded background image support
|
|
|
201 |
2001-03-29 1.2.1 Minor bug fixes. Experimental support for 3D pie plots
|
|
|
202 |
2001-03-18 1.2 Second release see changes.txt
|
|
|
203 |
2001-02-18 1.1 Second release see changes.txt
|
|
|
204 |
2001-02-04 1.0 First public release
|
|
|
205 |
-------------------------------------------------------------------------
|
|
|
206 |
|
|
|
207 |
<EOF>
|