README FOR JPGRAPH
==================

This is JpGraph 2.0beta an Object Oriented PHP4 Graph Plotting library.

The library is Copyright (C) 2001-2005 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/

* --------------------------------------------------------------------
* PHP4 IS NOT SUPPORTED IN THIS 2.x SERIE
* --------------------------------------------------------------------


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 5.0.3 or higher 
* GD 2.15 or higher

Recommended:
* PHP 5.0.3
* PHP Builtin GD library

Installation
------------
0. Make sure your PHP is 5.0.3 and that you have compiled PHP 
   with support for the 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. Please refer to
   the manual "Verifying your PHP installation"
   
1. Unzip and copy the files to a directory of your choice where Your
   httpd sever can access them. 
   For a global site 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. Read (really!) the FAQ on http://www.aditus.nu/jpgraph/jpg_faq.php.


Documentation
-------------
The installation includes HTML documentation and reference guide for the
library. The portal page for all the documentation is
<YOUR-INSTALLATION-DIRECTORY>/docs/index.html


Troubleshooting
---------------
1. 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.

2. 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.

3. 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 reported in the issue tracker at

http://www.aditus.nu/bugtraq


Change history:
------------------------------------------------------------------------
Date        Ver        Comment
------------------------------------------------------------------------
2005-05-13  2.0beta    Beta version of 2.0 serie for PHP5
-------------------------------------------------------------------------

<EOF>
