Blame | Letzte Änderung | Log anzeigen | RSS feed
README FOR JPGRAPH==================This package contains JpGraph, an Object Oriented PHP4 Graph Plotting library.The library is Copyright (C) 2001-2007 Aditus Consulting andreleased under dual license QPL 1.0 for open source and educationaluse and JpGraph Professional License for commercial use.Please see full license details at http://www.aditus.nu/jpgraph/* --------------------------------------------------------------------* PHP5 IS NOT SUPPORTED IN THE 1.x SERIES* Please use the 2.x serie if PHP5 support is required* --------------------------------------------------------------------Included files--------------README This fileQPL.txt QPL 1.0 Licensee/srcChangelog Changelogjpg-config.inc.php Configuration setup for JpGraphjpgraph.php Base libraryjpgraph_errhandler.inc.php Base library. Error handler module.gd_image.inc.php Base library. GD interface classjpgraph_ttf.inc.php Base library. TTF font handlingjpgraph_led.php Extension: LED digits modulejpgraph_log.php Extension: logarithmic scalesjpgraph_date.php Extension: date/time scalesjpgraph_line.php Extension: line plotsjpgraph_bar.php Extension: bar plotsjpgraph_error.php Extension: error plotsjpgraph_scatter.php Extension: scatter/impulse plotsjpgraph_radar.php Extension: radar plotsjpgraph_pie.php Extension: pie plotsjpgraph_pie3d.php Extension: 3D pie plotsjpgraph_canvas.php Extension: drawing canvasjpgraph_canvtools.php Extension: utility classes for working with canvasjpgraph_gantt.php Extension: Gantt chartjpgraph_regstat.php Extension: Statistics and cubic splines.jpgraph_stock.php Extension: Stock and box plots.jpgraph_gradient.php Extension: Color gradient classjpgraph_gb2312.php Extension: Chinese GB2312 to Unicode translationjpgraph_plotmark.php Extension: Handle plotmarks in plotsjpgraph_imgtrans.php Extension: Basic image transformationjpgraph_flags.php Extension: Country flagsjpgraph_iconplot.php Extension: Use image icons in plotsjpgraph_plotband.php Extension: Plotbands in graphsjpgraph_plotmark.inc.php Extension: Using plotmarks in graphsjpgraph_antispam.php Extension: Antispam modulejpgraph_utils.inc.php Extension: Non mandatory Utility classesjpgraph_mgraph.php Extension: Multi graphimgdata_*.inc Extension: Encoded images for plot marksflags*.dat Raw Image data: Pre-compiled data for country flags./src/Examples A directory with example sripts.Run testsuit.php to get a list of allfiles and you can easily click on a file tosee the code and the resulting image./docs Directory with all documentation/docs/index.html Documentation portalRequirements:-------------Miminum:* PHP 4.3.5 or higher(earlier versions might work but is unsupported)* GD 1.8.x or GD 2.15 or higherRecommended:* PHP 4.4.0* PHP Builtin GD 2.28 libraryInstallation------------0. Make sure that the PHP version is compatible with the stated requirementsand that the PHP installation has support for the GD library.Please run phpinfo() to check if GD libraryis supported in the installation.If the GD library doesn't seem to be installedplease consult the PHP manual under section "Image" forinstructions on where to find this library. Please refer tothe manual section "Verifying your PHP installation"1. Unzip and copy the files to a directory of your choice where Yourhttpd sever can access them.For a global site installation you should copy the files tosomewhere in the PHP search path.2. Check that the default directory paths in jpg-config.incfor cache directory and TTF directory suits your installation.Note1: The default directories are different depending on ifthe library is running on Windows or UNIX.Note2: Apache/PHP must have write permission to your cachedirectory if you enable the cache feature. By default the cacheis disabled.3. Check that all rest of the DEFINE in jpg-config.incis setup to your preference. The default should be finefor most users. (See also Note 3. below)4. If any problems are encounted please start by reading the FAQ onhttp://www.aditus.nu/jpgraph/jpgraphfaq.php.Documentation-------------The installation includes HTML documentation and reference guide for thelibrary. The portal page for all the documentation is<YOUR-INSTALLATION-DIRECTORY>/docs/index.htmlTroubleshooting---------------0. Make sure your PHP installation has the minimum requirements and hasthe GD library enabled (most modern installations fulfills the minimmumrequirements). See chapter 3.1 in the manual.1. If an empty page is returned back when running an example checkthe followingi) Increase the maximum memory allowed by PHP (in php.ini) to at least 32MBii) Enable all error messages and notices in php.ini (error_reporting = E_ALL)III) Make sure output buffering is disabled in php.ini (output_buffering = Off)this will make it possible to see the errors more easilyIV) Disable any PHP accelerometer you may have installed (e.g. Zend Cache)Then try running the example again. Most likely an error message willnow be shown that will give further information on what is wrong.For further clarifiction on the casues for the error messages seethe FAQ section on the WEB site.2. If you are running IIS and Win2k and get the error "Can't findfont' when trying to use TTF fonts then try to change you pathsto UNIX style, i.e. "/usr/local/fonts/ttf/". Remember that thepath is absolute and not relative to the htdocs catalogue. Someversions of GD for Windows also need you to set the environmentvariable GDFONTPATH for GD to find the fonts.3. If you are using the cache please make sure that you haveset the permissions correctly for the cache directory so thatApache/PHP can write to that directory.Bug reports and suggestions---------------------------Should be reported in the issue tracker athttp://www.aditus.nu/bugtraqChange history:------------------------------------------------------------------------Date Ver Comment-----------------------------------------------------------------------2007-03-25 1.21 Feature release2006-09-24 1.20.5 Maintenance release2006-05-26 1.20.4a Maintenance release2006-02-18 1.20.3 Minor defect and feature release2005-12-04 1.20 Major feature enhancements2005-07-10 1.19 Various minor defects fixed2005-06-06 1.18 Date scale and guide-lines for Pie2005-01-16 1.17 Functional enhancement, bug fixes2004-11-02 1.17-beta2 Functional enhancement, bug fixes2004-09-12 1.17-beta Port to PHP5 in compatibility mode.2004-06-20 1.16 Minor defect fixes2004-05-04 1.15 Final 1.152004-04-19 1.15 BETA Defect fixes and code restructuring to makejpgraph.php smaller.2003-11-25 1.14 Additional error checking, country flags, icon etc2003-08-19 1.13 BETA Improved Gantt graphs various other changes and bug fixes2003-02-02 1.11 Stock charts and some minor oter changes.2002-12-16 1.10 Alpha blending, cubic splines and field plots2002-10-30 1.9.1 Fixed two stupid mistakes in 1.92002-10-25 1.9 TTF font change. Many small additional improvements2002-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 plot2002-04-07 1.6.1 Bug fixes for 3D pies and image maps for pie's2002-04-01 1.6 Functional improvments2002-04-01 1.6 BETA Beta candidate for 1.62002-03-01 1.5.3 Fix minor release problem in 1.5.22002-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 fixes2001-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 fixes2001-09-13 1.3 Major functional enhancements and minor bugfixes2001-04-29 1.2.2 Minor bug fixes. Addded background image support2001-03-29 1.2.1 Minor bug fixes. Experimental support for 3D pie plots2001-03-18 1.2 Second release see changes.txt2001-02-18 1.1 Second release see changes.txt2001-02-04 1.0 First public release-------------------------------------------------------------------------<EOF>