Chart version 2.4.2

INSTALLING

The usual.

        perl Makefile.PL
        make
        make test
        make install

This should install to your site_perl directory. The test scripts also put samples of the different charts in the samples/ directory.


PREREQUISITES

Lincoln Stein's GD module version 2.0.36 or higher.


CHANGES
2.4.2 Changes done by R. Dassing, Michael Potter
      Base.pm:The
       values for 'true' resp. 'false' may be of the following
      true: TRUE, true, T, t, 1 and defined
      false: FALSE, false, F, f, 0 or undefined
      
      Base.pm:Added
       new options xlabel and xrange which is valid for xy_plot
      and Chart::Lines, Chart::Points, Chart::LinesPoints,
      Chart::Split, Chart::ErrorBars.
      
      In order to use the labels, the chart module needs to have 'xlabels' 
      AND 'xrange' set. Below is some example code for use: 
      @labels = (['Jan', 'Feb','Mar'], 
                 ['10','40','70']); 
      $chart->set( xlabels => \@labels, 
                   xrange => [0,100] ); 
      This options allow to set and position labels at the x-axis arbitrary.

      add_dataset() and app_pt() accepts now datasets as lists and as
          references to list like already mentioned in the docs

      Pie.pm:Optimized 
       organisation of the placement of the labels.
      Added flag to avoid plotting of legends at all
      Using GD Version 2.0.36 as this version supports 'filledArc'

      Composite.pm:Correction
       due to Request 23166
      write the endmost value of input array
      in imagemap_data array
      
      Lines.pm:Correction
       due to Request 23166: 
      write the endmost value of input array
      in imagemap_data array

2.4.1 Changes done by Christine Zilker, Gerhard Stuhlpfarrer, R. Dassing

        Added new Options:
             ring             Draw a ring instead of a Pie
             legend_lines     Connect Pie and the description with a line
             stepline         Connect Lines and LinesPoints by a stepped line
             stepline_mode    (thanks to Gerhard Stuhlpfarrer)
             brush_size1      Define Brush Size for Composite 1 
             brush_size2      and 2
        Color problem in Pie fixed
        Positioning of the description optimized in Pie
        Division by zero problem fixed in Pie
        Module 'Bars' checks for numeric data a input on y-axis
        New Function added to Base:
            minimum  - determine minimal value of an array of numeric values
            maximum  - determine maximal value of an array of numeric values
            arccos   - arccos
            arcsin   - arcsin
        Some small bugs corrected:
            Base::findyscale
            Base::findyrange   : check for numeric values
            Base::findxrange   : check for numeric values
        Latex sources for documentation included 
            (We hope to get a better documentation be a native english speaking person)

2.3 Changes done by Christine Zilker:

        Added new Options: 
             in Composite: 
                legendexample_height    changes thickness of the lines in the legend,
                fytick1, fytick2 analog to fytick 
                                         used for right and left y-axes
             in Direction: 
                pairs                    

        Added the possibility to add more datasets in Chart::Direction 
                           
        Fixed "label space" problem in Pie
        Fixed dataset order (in the legend) in StackedBars
        Fixed problem of getting the right values if round2Tick is used
        Fixed problem of datavalues in _findyscale
        Some minor bugfixes         

        Update of the Documentation (Documentation.pdf)

        The requested support of TruType fonts was currently dropped due to
        missing support in GD.pm (even in new versions)
        
        The print out of some hints and warnings where deleted not to confuse
        the user.

2.2: Composite.pm:imagemap_dump () repaired.

2.1: Changes done by Markus Brandl:

new Modules added: ErrorBars.pm, HorizontalBars.pm, Pareto.pm,

Pie.pm, Split.pm and Direction.pm

Subdirectory "doc" contains a Acrobat Reader Documentation.pdf file.

        Function add_datafile() added. It is now possible to add a complete
        datafile.

        Added new Options: precision, xy_plot, minxticks, maxxticks,
        skipyticks, skip_int_ticks, legend_label_value, y_axes,
        scale, interval, start, interval_ticks, sort, same_error, point,
        line, arrow, angle_interval, min_circles, max_circles
        Also added: the 'title' and 'x_label' options in the colors option 

        Documentation (Documentation.pdf) added.

        _findxscale, _findxrange and drawxnumberticks added to make 
        xy_plots possible.

        sortdata has now a body. 

        Fixed integer ticks problem by adding the skip_int_ticks option
        Fixed fxticks and fyticks problem in Composite
        Fixed negative value problem in Bars
        Fixed min_val and max_val problem in draw_data function of all modules:
        Now, Chart plots the data only if the data is in the area of min_val and
        max_val! The border of bars in Bars, HorizontalBars and StackedBars will
        be plotted pink (not misccolor) if the data isn't in the min_val-max_val
        interval.
        Fixed customxticks problem in _drawxticks
        Some other bugfixes.
        Updates in _findyscale, _round2tick, _calcTickInterval 

1.1: Changes done by David Pottage:

        Plot scales can now have any magnitude. 
        It does not matter if the data covers a range of 100000000000 units
        or 0.00000000001 units, the scale will be correctly calculated.

        Ticks on plot scales are now plotted on 'round' numbers. 
        The number & spacing of ticks is chosen based on the data range.

        False zero graphs are now explicitly supported, and will be 
        generated if the data range merits it. 
        The instance field 'include_zero' should be set to zero to suppress this.

        Added: include_zero, minyticks, maxyticks, integer_ticks_only

1.0.1:

Fixed drawbottom_legend in Base.pm

0.99c-pre3 - 1.0:

        Fixed drawdata in Lines.pm:lines  are limited to the frame
        Added fxtick, fytick
        Added jpeg(), cgi_jpeg() to produce the format jpeg
        Delete GIF support, added PNG and JPEG instead

0.99b - 0.99c-pre3:

        James F Miner <jfm@winternet.com>:
        Added Mountain chart type
        Added Patterns.  See t/mountain.t for details
        Bugfix for drifting x tick
        Improved internal color handling

        Richard Dice  <rdice@shadnet.shad.ca>:
        Added brush shapes for Points, LinesPoints
        Added scalar_gif

0.99a - 0.99b:

        Fixed left legend in composite charts
        Fixed no color problem when using composite charts w/ no legend
        Fixed color handling for datasets
        Added option for http header Pragma: no-cache
                Netscape 4.5 has a bug that breaks it, but it works with
                other browsers.  Any ideas for a workaround?

0.99 - 0.99a:

        Added use of undef() values to represent 'no data' for line breaks
        Added ylabel*color options
        Added xgrid_lines, y_grid_lines & y2_grid_lines , and color options for each
        Cache disabling in cgi header: Reiner Nippes <nippes.r@gmx.de>
        Restored grid_lines option: Heinz-Guenter Kontny <hek@kronos.nic.dtag.de>
        Fixed a typo that broke imagemap data storage in Lines charts

0.94 - 0.99:

        Modified the 'title' option to correctly process newlines
        Deprecated the 'subtitle' option, will remove it in next release
        Changed the API for specifying colors
        Added support for printing to file handles
        Added Chart::Composite
        Added 'spaced_bars' to make it easy to differentiate the bars
        Added 'grey_background' to make plot background grey
        Added support for negative values in the datasets
        Added methods to remember and dump imagemap pixel information
        Included rgb.txt with distribution for WinXX users

0.93 - 0.94:

        Moved the legend down to be flush with the chart
        Fixed the long decimal y-tick label problem
        Fixed (for the last time, hopefully) the pre-5.004 compilation problem
        Fixed handling of undefined data points
        Added more colors for the default data colors
        Added the transparent gif option
        Added the option for user-specified colors
        Added the grid_lines option

0.92 - 0.93:

        Fixed the sort problem
        Fixed the y-axis label centering problem
        Fixed pre-5.004 compilation problem
        Added StackedBars charts

MAINTAINER

Chart-Group (chart@fs.wettzell.de)


COPYRIGHT

Copyright(c) 1997-1998 David Bonner, 1999 Peter Clark, 2001 Chart-Group at BKG. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.