README FOR JPGRAPH
==================
This is JpGraph 1.16 an Object Oriented PHP4 Graph Plotting library.
The library is Copyright (C) 2001,2002,2003,2004 Johan Persson and
released under dual license QPL 1.0 for open source and educational
use and JpGraph Professional License for commercial use.
Please see full license details at http://www.aditus.nu/jpgraph/
**********************************************************************
-------------------------------IMPORTANT------------------------------
NOTE 1: All configuration defines has been moved from the file
'jpgraph.php' to a new separate file 'jpg-config.inc'
NOTE 2: IconPlots has been moved to a separate file
jpgraph_iconplot.php which you must include if you plan on creating
IconPlots
NOTE 3: PlotBands have been moved to a separate file
jpgraph_plotband.php which you must add to your scripts if you are
using plotbands.
***********************************************************************
Included files
--------------
README This file
QPL.txt QPL 1.0 Licensee
/src
Changelog Changelog
jpg-config.inc Configuration setup for JpGraph
jpgraph.php Base library
jpgraph_log.php Extension: logarithmic scales
jpgraph_line.php Extension: line plots
jpgraph_bar.php Extension: bar plots
jpgraph_error.php Extension: error plots
jpgraph_scatter.php Extension: scatter/impulse plots
jpgraph_radar.php Extension: radar plots
jpgraph_pie.php Extension: pie plots
jpgraph_canvas.php Extension: drawing canvas
jpgraph_canvtools.php Extension: utility classes for working with canvas
jpgraph_pie3d.php Extension: 3D pie plots
jpgraph_gantt.php Extension: Gantt chart
jpgraph_regstat.php Extension: Statistics and cubic splines.
jpgraph_stock.php Extension: Stock and box plots.
jpgraph_gradient.php Extension: Color gradient class
jpgraph_gb2312.php Extension: Chinese GB2312 to Unicode translation
jpgraph_plotmark.php Extension: Handle plotmarks in plots
jpgraph_imgtrans.php Extension: Basic image transformation
jpgraph_flags.php Extension: Country flags
jpgraph_iconplot.php Extension: Use image icons in plots
jpgraph_plotband.php Extension: Plotbands in graphs
jpgraph_plotmark.inc Extension: Using plotmarks in graphs
imgdata_*.inc Extension: Encoded images for plot marks
flags*.dat Image data: Pre-compiled data for country flags.
/src/Examples A directory with around 290 example graphs with source.
Run testsuit.php to get a list of all
files and you can easily click on a file to
see the code and the resulting image.
/docs/index.html Documentation portal
Requirements:
-------------
Miminum:
* PHP 4.3 or higher
(earlier versions might work but is not actively tested)
* GD 1.8.x or GD 2.15 or higher
Recommended:
* PHP 4.3.7
* Builtin GD library in PHP 4.3.x
Installation
------------
0. Make sure your PHP is 4.3 (preferable 4.3.7)
and that you have compiled support for GD library.
You must make absolutely sure that you have GD working.
Please run phpinfo() to check if GD library
is supported in your installation. If you don't have the GD library
please consult the PHP manual under section "Image" for
instructions on where to find this library.
1. Unzip and copy the files to a directory of your choice. For
a global installation you should copy the files to
somewhere in the PHP search path.
2. Check that the default directory paths in jpg-config.inc
for cache directory and TTF directory suits your installation.
Note1: The default directories are different depending on if
the library is running on Windows or UNIX.
Note2: Apache/PHP must have write permission to your cache
directory if you enable the cache feature. By default the cache
is disabled.
3. Check that all rest of the DEFINE in jpg-config.inc
is setup to your preference. The default should be fine
for most users. (See also Note 3. below)
4. Make sure PHP have write privileges to your cache directory if
you plan on using the cache feature.
5. Read (really!) the FAQ on http://www.aditus.nu/jpgraph/jpg_faq.php.
Troubleshooting
---------------
1. If you don't get any background images (but rather a solid black
box) you are using GD 2.x but have forgotten to enable truecolor
support. Correct this by enabling the USE_TRUECOLOR define.
2. If background images does not work make sure the settings of
USE_GD2_LIBRARY corresponds to your installation, i.e. If you
don't have GD2 then this define must be false!
3. If you are running IIS and Win2k and get the error "Can't find
font' when trying to use TTF fonts then try to change you paths
to UNIX style, i.e. "/usr/local/fonts/ttf/". Remember that the
path is absolute and not relative to the htdocs catalogue. Some
versions of GD for Windows also need you to set the environment
variable GDFONTPATH for GD to find the fonts.
4. If you are using the cache please make sure that you have
set the permissions correctly for the cache directory so that
Apache/PHP can write to that directory.
5. Some windows installations seems to have a problem with a PHP
script ending in a newline (This newline seems to be sent to the
browser and will cause a Header already sent error).
If you have this problem try remove all trailing newlines in the
jpgraph* files
Bug reports and suggestions
---------------------------
Should be sent to (jpgraph aditus nu) [insert at and dot]
Change history:
------------------------------------------------------------------------
Date Ver Comment
------------------------------------------------------------------------
2004-06-20 1.16 Minor defect fixes
2004-05-04 1.15 Final 1.15
2004-04-19 1.15 BETA Defect fixes and code restructuring to make
jpgraph.php smaller.
2003-11-25 1.14 Additional error checking, country flags, icon etc
2003-08-19 1.13 BETA Improved Gantt graphs various other changes and bug fixes
2003-02-02 1.11 Stock charts and some minor oter changes.
2002-12-16 1.10 Alpha blending, cubic splines and field plots
2002-10-30 1.9.1 Fixed two stupid mistakes in 1.9
2002-10-25 1.9 TTF font change. Many small additional improvements
2002-09-17 1.8 Documentation update.
2002-09-09 1.8 BETA Functional improvements.
2002-07-05 1.7 Functional improvements. Rotated bar graphs.
2002-06-17 1.7 BETA Functional improvements.
2002-05-15 1.6.3 Enhancements to Gantt graphs anbd minor bug fixes.
2002-04-19 1.6.2 Addition of image maps for line and scatter plot
2002-04-07 1.6.1 Bug fixes for 3D pies and image maps for pie's
2002-04-01 1.6 Functional improvments
2002-04-01 1.6 BETA Beta candidate for 1.6
2002-03-01 1.5.3 Fix minor release problem in 1.5.2
2002-02-29 1.5.2 Minor bug fixes.
2002-02-11 1.5.1 Minor bug fixes.
2002-01-27 1.5 Functional improvements. Gantt charts.
2002-01-17 1.5-BETA2 Functional improvements, bug fixes
2001-12-16 1.5-BETA Functional improvements, gantt-charts, bug fixes.
2001-11-12 1.4 Functional improvements, bug fixes.
2001-09-23 1.3.1 Minor bug fixes
2001-09-13 1.3 Major functional enhancements and minor bugfixes
2001-04-29 1.2.2 Minor bug fixes. Addded background image support
2001-03-29 1.2.1 Minor bug fixes. Experimental support for 3D pie plots
2001-03-18 1.2 Second release see changes.txt
2001-02-18 1.1 Second release see changes.txt
2001-02-04 1.0 First public release
-------------------------------------------------------------------------
Stockholm/London 2004-04-19
Johan Persson (jpgraph aditus nu) [insert at and dot]
Aditus Consulting
<EOF>
