DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: rt_jpgraphlib

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Regis TEDONE
Changed:2007-09-01T16:23:44
Classification:JPGRAPH V2,2 Library for PHP5
Author:Regis TEDONE
Email:consulting@cmspaca.com
Info 3:
Info 4:

EXT: rt_jpgraphlib

Extension Key: my_extension_key

Copyright 2000-2007, Regis TEDONE, <consulting@cmspaca.com>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

EXT: rt_jpgraphlib 1

Introduction 1

What does it do? 1

Screenshots 2

Users manual 3

FAQ 3

Tutorial 4

Known problems 4

Changelog 4

Introduction

What does it do?

  • JpGraph library is an OO graph library which makes it easy to both draw a "quick and dirty" graph with a minimum of code and quite complex graphs which requires a very fine grain of control. The library tries to assign sensible default values for most parameters hence making the learning curve quite flat since for most of the time very few commands is required to draw graphs with a pleasing esthetic look.
  • Some highlights of available features are
  • Flexible scales, supports text-lin, text-log, lin-lin, lin-log, log- lin and log-log and integer scales.
  • Supports both PNG, GIF and JPG graphic formats. Note that the available formats are dependent on the specific PHP installation where the library is used.
  • Supports caching of generated graphs to lessen burden of a HTTP server.
  • Supports batch mode to only generate images to a file
  • Supports client side image maps which makes it easy to produce drill down images.
  • Intelligent auto-scaling which gravitates towards esthetic values, i.e. multiples of 2:s and 5:s
  • Fully supports manual scaling, with fine grain control of position of ticks.
  • Supports background images with different formatting options
  • Supports color and brightness adjustments of images directly in PHP.
  • User specified grace for auto-scaling
  • Supports up to two different y-scale, it is possible to have different left and right y-scale and add plots to both
  • Supports, line-plots, filled line-plots, accumulated line-plots, bar plots, accumulated bar plots, grouped bar plots, error plots, line error plots, scatter plots, gantt-charts, radar plots, 2D and 3D pie charts.
  • Supports unlimited number of plots in each graph, makes it easy to compose complex graph which consists of several plot types
  • User specified position of axis
  • Supports color gradient fill in seven styles
  • Designed as a flexible OO framework which makes it easy to add new types of plots
  • Supports automatic legend generation
  • Supports both vertical and horizontal grids
  • Supports anti-aliasing of lines
  • Supports background images as well as unlimited number of icons in the graph
  • Supports rotation of linear graphs
  • More then 400 named colors
  • Designed modularly - you don't have to include code which isn't used
  • ...and many many more features

In addition to these high level features the library has been designed to be orthogonal and consistent in its' naming convention. For example, to specify color each object (i.e. axis, grids, texts, titles etc) within the graph implements the method SetColor() with the same signature.

Screenshots

JPGraph library proposes a large panel of graph generation :

img-1

a

img-1

b

img-2

c

img-3

Bars, lines and alpha example

a

Bars, lines and alpha example

b

Date axis example

c

3D pie with legend example

img-4

a

img-4

b

img-5

c

img-6

Field scatter example

a

Field scatter example

b

Mathematical functions plot example

c

Lines and icon example

img-7

a

img-7

b

img-8

Impulse graph example

a

Impulse graph example

b

Graph in polar coordinates

img-11

a

img-11

b

img-12

c

img-13

Static bands and bars example

a

Static bands and bars example

b

Stock example

c

Line and bars with background example

Users manual

  • This extension only provides an OO PHP5 library that give the possibility to extension developers to add graphic generation to their Typo3 work.

  • The library is Copyright (C) 2001-2007 Aditus Consulting 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

    * Note: Due to a bug in PHP5 make sure that the compatibility mode for

    * PHP4 is disabled by setting (in php.ini)

    * zend.ze1_compatibility_mode = Off

By default, the extension generate graphic files in the “/fileadmin/jpgraph_storage/” folder which is created during the extension installation.

  • This storage folder can be changed using the Typo3 extension manager.
  • Other parameters can be changed in the “/typo3conf/ext/rt_jpgraphlib/jpgraph/jpg-config.inc.php” configuration file.
  • JPGRAPH Class reference : You will find in the <doc> folder of this extension a zip file called “ref.zip”. Decompress this zip file anywhere and launch the file “index.html”.

Tutorial

Known problems

For performance and quality reason background images are not rotated along with graphs in rotated graphs.

For an overview of current issues that have been reported and are unders investigation please see our DMS (Defect Management System) available at http://wwww.aditus.nu/bugtraq/

Changelog

- First version of this extension which includes the version 2.2 of the JPGraph Library.

EXT: rt_jpgraphlib - 4

img-14 img-15