------------------------------------------------------------------------
Chart version 2.4.10
------------------------------------------------------------------------
----------
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.10 Upload to pause.perl.org failed for version 2.4.9. Therefore, the version 2.4.9 was renamed to 2.4.10
for a new upload.
2.4.9 Upload to pause.perl.org failed for version 2.4.8. Therefore, the version 2.4.8 was renamed to 2.4.9
for a new upload.
2.4.8 Bug repaired: rt.cpan.org #81171::Composite w/two ::Lines and xy_plot ==> undefined value when drawing ticks
(t/composite_7.t and t/composite_8.t are showing the differences)
Base.pm: defined(@array)
Chart.pod corrected for deprecated @ARR->[$i]
2.4.7 Not published
2.4.6 Number of named colors extended
Documentation.pdf explains the use of colors (Appendix added)
Corrections in base.pm, routines
_draw_bottom_legends, _draw_x_number_ticks
in LinesPoints.pm, routines _draw_data
2.4.5 Typo in _draw_x_ticks corrected
Methods scalar_png(), scalar_jpeg() corrected for result.
Test routine t/scalarImage.t added
Chart.pod corrected
2.4.4 The brush styles to points and linespoints are extended.
Not only circles represent the points but a number of different
brush styles, linke donut, Star and so on.
2.4.3 Corrections to imagemap production in Composite.pm and Lines.pm
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::_find_y_scale
Base::_find_y_range : check for numeric values
Base::_find_x_range : 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:
legend_example_height changes thickness of the lines in the legend,
f_y_tick1, f_y_tick2 analog to f_y_tick
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 _find_y_scale
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, min_x_ticks, max_x_ticks,
skip_y_ticks, 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.
_find_x_scale, _find_x_range and _draw_x_number_ticks added to make
xy_plots possible.
_sort_data has now a body.
Fixed integer ticks problem by adding the skip_int_ticks option
Fixed f_x_ticks and f_y_ticks 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 custom_x_ticks problem in _draw_x_ticks
Some other bugfixes.
Updates in _find_y_scale, _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, min_y_ticks, max_y_ticks, integer_ticks_only
1.0.1:
Fixed _draw_bottom_legend in Base.pm
0.99c-pre3 - 1.0:
Fixed _draw_data in Lines.pm: lines are limited to the frame
Added f_x_tick, f_y_tick
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 :
Added Mountain chart type
Added Patterns. See t/mountain.t for details
Bugfix for drifting x tick
Improved internal color handling
Richard Dice :
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 x_grid_lines, y_grid_lines & y2_grid_lines , and color options for each
Cache disabling in cgi header: Reiner Nippes
Restored grid_lines option: Heinz-Guenter Kontny
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-2012 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.