[Sommaire] [Imprimer]

   1  README FOR JPGRAPH
   2  ==================
   3  
   4  This package contains JpGraph, an Object Oriented PHP5 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  * PHP4 IS NOT SUPPORTED IN THIS 2.x SERIE
  14  * --------------------------------------------------------------------
  15  
  16  * --------------------------------------------------------------------
  17  * Note: Due to a bug in PHP5 make sure that the compatibility mode for
  18  *       PHP4 is disabled by setting (in php.ini)
  19  *
  20  *       zend.ze1_compatibility_mode = Off
  21  * --------------------------------------------------------------------
  22  
  23  
  24  Included files
  25  --------------
  26  README                    This file
  27  QPL.txt                 QPL 1.0  Licensee
  28  
  29  /src
  30    jpg-config.inc.php        Configuration setup for JpGraph
  31    jpgraph.php            Base library
  32    jpgraph_ttf.inc.php        Base library. TTF font handling
  33    jpgraph_errhandler.inc.php    Base library. Error handler module.
  34  
  35    jpgraph_log.php        Extension: logarithmic scales
  36    jpgraph_line.php        Extension: line plots 
  37    jpgraph_bar.php        Extension: bar plots
  38    jpgraph_date.php        Extension: date scale
  39    jpgraph_flags.php        Extension: Country flags
  40    jpgraph_error.php        Extension: error plots
  41    jpgraph_scatter.php        Extension: scatter/impulse plots
  42    jpgraph_radar.php        Extension: radar plots
  43    jpgraph_pie.php        Extension: pie plots
  44    jpgraph_canvas.php        Extension: drawing canvas
  45    jpgraph_canvtools.php        Extension: utility classes for working with canvas
  46    jpgraph_pie3d.php        Extension: 3D pie plots
  47    jpgraph_gantt.php        Extension: Gantt chart
  48    jpgraph_regstat.php        Extension: Statistics and cubic splines.
  49    jpgraph_stock.php        Extension: Stock and box plots.
  50    jpgraph_gradient.php        Extension: Color gradient class
  51    jpgraph_gb2312.php        Extension: Chinese GB2312 to Unicode translation
  52    jpgraph_imgtrans.php        Extension: Basic image transformation
  53    jpgraph_flags.php        Extension: Country flags
  54    jpgraph_iconplot.php        Extension: Use image icons in plots
  55    jpgraph_polar.php        Extension: Polar plots
  56    jpgraph_plotband.php        Extension: Plotbands in graphs
  57    jpgraph_plotmark.inc.php    Extension: Using plotmarks in graphs
  58    jpgraph_mgraph.php        Extension: Multi graph extension
  59    jpgraph_utils.inc.php        Extension: Various non-mandatory utility classes
  60    jprgaph_led.php        Extension: 7x4 LED Digits module
  61    imgdata_*.inc.php        Extension: Encoded images for plot marks
  62    flags*.dat            Image data: Pre-compiled data for country flags.
  63  
  64  /src/Examples        A directory with example sripts.
  65              Run testsuit.php to get a list of all
  66              files and you can easily click on a file to
  67              see the code and the resulting image.
  68          
  69  /docs            Directory with all documentation                
  70  /docs/index.html    Documentation portal
  71  
  72              
  73  Requirements:
  74  -------------
  75  Miminum:
  76  * PHP 5.1.0 or higher 
  77  * GD 2.28 or higher
  78  Note: Earlier versions might work but is unsupported.
  79  
  80  Recommended:
  81  * PHP 5.1.2
  82  * PHP Builtin GD library
  83  
  84  Installation
  85  ------------
  86  0. Make sure that the PHP version is compatible with the stated requirements
  87     and that the PHP installation has support for the GD library. 
  88     Please run phpinfo() to check if GD library
  89     is supported in the installation. 
  90     If the GD library doesn't seem to be installed 
  91     please consult the PHP manual under section "Image" for
  92     instructions on where to find this library. Please refer to
  93     the manual section "Verifying your PHP installation"
  94     
  95  1. Unzip and copy the files to a directory of your choice where Your
  96     httpd sever can access them. 
  97     For a global site installation you should copy the files to 
  98     somewhere in the PHP search path. 
  99  
 100  2. Check that the default directory paths in jpg-config.inc
 101     for cache directory and TTF directory suits your installation. 
 102     Note1: The default directories are different depending on if
 103     the library is running on Windows or UNIX.
 104     Note2: Apache/PHP must have write permission to your cache 
 105     directory if you enable the cache feature. By default the cache
 106     is disabled.
 107  
 108  3. Check that all rest of the DEFINE in jpg-config.inc 
 109     is setup to your preference. The default should be fine
 110     for most users. (See also Note 3. below)
 111     
 112  
 113  Documentation
 114  -------------
 115  The installation includes HTML documentation and reference guide for the
 116  library. The portal page for all the documentation is
 117  <YOUR-INSTALLATION-DIRECTORY>/docs/index.html
 118  
 119  
 120  Troubleshooting
 121  ---------------
 122  1. If an empty page is returned back when running an example check
 123     the following
 124  
 125        i) Make sure output_buffer is disabled in php.ini
 126       ii) Increase the maximum memory allowed by PHP (in php.ini) to at least
 127           32MB
 128      iii) Enable all error messages and notices in php.ini (error_reporting = E_ALL)
 129  
 130     Then try running the example again. Most likely an error message will
 131     now be shown that will give further information on what is wrong.
 132     For further clarifiction on the casues for the error messages see
 133     the FAQ section on the WEB site.
 134  
 135  1. If you are running IIS and Win2k and get the error "Can't find
 136     font' when trying to use TTF fonts then try to change you paths
 137     to UNIX style, i.e. "/usr/local/fonts/ttf/". Remember that the
 138     path is absolute and not relative to the htdocs catalogue. Some 
 139     versions of GD for Windows also need you to set the environment
 140     variable GDFONTPATH for GD to find the fonts.
 141  
 142  2. If you are using the cache please make sure that you have
 143     set the permissions correctly for the cache directory so that
 144     Apache/PHP can write to that directory.
 145  
 146  3. Some windows installations seems to have a problem with a PHP
 147     script ending in a newline (This newline seems to be sent to the
 148     browser and will cause a Header already sent error). 
 149     If you have this problem try remove all trailing newlines in the
 150     jpgraph* files 
 151  
 152  
 153  Bug reports and suggestions
 154  ---------------------------
 155  Should be reported in the issue tracker at
 156  
 157  http://www.aditus.nu/bugtraq
 158  
 159  <EOF>