1------------------------------------------------------------------------
2Chart version 2.4.10
3------------------------------------------------------------------------
4
5
6----------
7INSTALLING
8----------
9
10The usual.
11
12 perl Makefile.PL
13 make
14 make test
15 make install
16
17This should install to your site_perl directory. The test scripts also
18put samples of the different charts in the samples/ directory.
19
20
21-------------
22PREREQUISITES
23-------------
24
25Lincoln Stein's GD module version 2.0.36 or higher.
26
27-------
28CHANGES
29-------
302.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
31 for a new upload.
32
332.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
34 for a new upload.
35
362.4.8 Bug repaired: rt.cpan.org #81171::Composite w/two ::Lines and xy_plot ==> undefined value when drawing ticks
37 (t/composite_7.t and t/composite_8.t are showing the differences)
38 Base.pm: defined(@array)
39 Chart.pod corrected for deprecated @ARR->[$i]
40
412.4.7 Not published
42
432.4.6 Number of named colors extended
44 Documentation.pdf explains the use of colors (Appendix added)
45 Corrections in base.pm, routines
46 _draw_bottom_legends, _draw_x_number_ticks
47 in LinesPoints.pm, routines _draw_data
48
492.4.5 Typo in _draw_x_ticks corrected
50 Methods scalar_png(), scalar_jpeg() corrected for result.
51 Test routine t/scalarImage.t added
52 Chart.pod corrected
53
542.4.4 The brush styles to points and linespoints are extended.
55 Not only circles represent the points but a number of different
56 brush styles, linke donut, Star and so on.
57
582.4.3 Corrections to imagemap production in Composite.pm and Lines.pm
59
602.4.2 Changes done by R. Dassing, Michael Potter
61 Base.pm:
62 The values for 'true' resp. 'false' may be of the following
63 true: TRUE, true, T, t, 1 and defined
64 false: FALSE, false, F, f, 0 or undefined
65
66 Base.pm:
67 Added new options xlabel and xrange which is valid for xy_plot
68 and Chart::Lines, Chart::Points, Chart::LinesPoints,
69 Chart::Split, Chart::ErrorBars.
70
71 In order to use the labels, the chart module needs to have 'xlabels'
72 AND 'xrange' set. Below is some example code for use:
73 @labels = (['Jan', 'Feb','Mar'],
74 ['10','40','70']);
75 $chart->set( xlabels => \@labels,
76 xrange => [0,100] );
77 This options allow to set and position labels at the x-axis arbitrary.
78
79 add_dataset() and app_pt() accepts now datasets as lists and as
80 references to list like already mentioned in the docs
81
82
83 Pie.pm:
84 Optimized organisation of the placement of the labels.
85 Added flag to avoid plotting of legends at all
86 Using GD Version 2.0.36 as this version supports 'filledArc'
87
88 Composite.pm:
89 Correction due to Request 23166
90 write the endmost value of input array
91 in imagemap_data array
92
93 Lines.pm:
94 Correction due to Request 23166:
95 write the endmost value of input array
96 in imagemap_data array
97
98
99
1002.4.1 Changes done by Christine Zilker, Gerhard Stuhlpfarrer, R. Dassing
101 Added new Options:
102 ring Draw a ring instead of a Pie
103 legend_lines Connect Pie and the description with a line
104 stepline Connect Lines and LinesPoints by a stepped line
105 stepline_mode (thanks to Gerhard Stuhlpfarrer)
106 brush_size1 Define Brush Size for Composite 1
107 brush_size2 and 2
108 Color problem in Pie fixed
109 Positioning of the description optimized in Pie
110 Division by zero problem fixed in Pie
111 Module 'Bars' checks for numeric data a input on y-axis
112 New Function added to Base:
113 minimum - determine minimal value of an array of numeric values
114 maximum - determine maximal value of an array of numeric values
115 arccos - arccos
116 arcsin - arcsin
117 Some small bugs corrected:
118 Base::_find_y_scale
119 Base::_find_y_range : check for numeric values
120 Base::_find_x_range : check for numeric values
121 Latex sources for documentation included
122 (We hope to get a better documentation be a native english speaking person)
123
1242.3 Changes done by Christine Zilker:
125 Added new Options:
126 in Composite:
127 legend_example_height changes thickness of the lines in the legend,
128 f_y_tick1, f_y_tick2 analog to f_y_tick
129 used for right and left y-axes
130 in Direction:
131 pairs
132
133 Added the possibility to add more datasets in Chart::Direction
134
135 Fixed "label space" problem in Pie
136 Fixed dataset order (in the legend) in StackedBars
137 Fixed problem of getting the right values if round2Tick is used
138 Fixed problem of datavalues in _find_y_scale
139 Some minor bugfixes
140
141 Update of the Documentation (Documentation.pdf)
142
143 The requested support of TruType fonts was currently dropped due to
144 missing support in GD.pm (even in new versions)
145
146 The print out of some hints and warnings where deleted not to confuse
147 the user.
148
1492.2: Composite.pm: imagemap_dump() repaired.
150
1512.1: Changes done by Markus Brandl:
152 new Modules added: ErrorBars.pm, HorizontalBars.pm, Pareto.pm,
153
154 Pie.pm, Split.pm and Direction.pm
155
156 Subdirectory "doc" contains a Acrobat Reader Documentation.pdf file.
157
158 Function add_datafile() added. It is now possible to add a complete
159 datafile.
160
161 Added new Options: precision, xy_plot, min_x_ticks, max_x_ticks,
162 skip_y_ticks, skip_int_ticks, legend_label_value, y_axes,
163 scale, interval, start, interval_ticks, sort, same_error, point,
164 line, arrow, angle_interval, min_circles, max_circles
165 Also added: the 'title' and 'x_label' options in the colors option
166
167 Documentation (Documentation.pdf) added.
168
169 _find_x_scale, _find_x_range and _draw_x_number_ticks added to make
170 xy_plots possible.
171
172 _sort_data has now a body.
173
174 Fixed integer ticks problem by adding the skip_int_ticks option
175 Fixed f_x_ticks and f_y_ticks problem in Composite
176 Fixed negative value problem in Bars
177 Fixed min_val and max_val problem in draw_data function of all modules:
178 Now, Chart plots the data only if the data is in the area of min_val and
179 max_val! The border of bars in Bars, HorizontalBars and StackedBars will
180 be plotted pink (not misccolor) if the data isn't in the min_val-max_val
181 interval.
182 Fixed custom_x_ticks problem in _draw_x_ticks
183 Some other bugfixes.
184 Updates in _find_y_scale, _round2tick, _calcTickInterval
185
186
1871.1: Changes done by David Pottage:
188 Plot scales can now have any magnitude.
189 It does not matter if the data covers a range of 100000000000 units
190 or 0.00000000001 units, the scale will be correctly calculated.
191
192 Ticks on plot scales are now plotted on 'round' numbers.
193 The number & spacing of ticks is chosen based on the data range.
194
195 False zero graphs are now explicitly supported, and will be
196 generated if the data range merits it.
197 The instance field 'include_zero' should be set to zero to suppress this.
198
199 Added: include_zero, min_y_ticks, max_y_ticks, integer_ticks_only
200
2011.0.1:
202 Fixed _draw_bottom_legend in Base.pm
203
2040.99c-pre3 - 1.0:
205 Fixed _draw_data in Lines.pm: lines are limited to the frame
206 Added f_x_tick, f_y_tick
207 Added jpeg(), cgi_jpeg() to produce the format jpeg
208 Delete GIF support, added PNG and JPEG instead
209
2100.99b - 0.99c-pre3:
211 James F Miner <jfm@winternet.com>:
212 Added Mountain chart type
213 Added Patterns. See t/mountain.t for details
214 Bugfix for drifting x tick
215 Improved internal color handling
216
217 Richard Dice <rdice@shadnet.shad.ca>:
218 Added brush shapes for Points, LinesPoints
219 Added scalar_gif
220
2210.99a - 0.99b:
222 Fixed left legend in composite charts
223 Fixed no color problem when using composite charts w/ no legend
224 Fixed color handling for datasets
225 Added option for http header Pragma: no-cache
226 Netscape 4.5 has a bug that breaks it, but it works with
227 other browsers. Any ideas for a workaround?
228
2290.99 - 0.99a:
230 Added use of undef() values to represent 'no data' for line breaks
231 Added ylabel*_color options
232 Added x_grid_lines, y_grid_lines & y2_grid_lines , and color options for each
233 Cache disabling in cgi header: Reiner Nippes <nippes.r@gmx.de>
234 Restored grid_lines option: Heinz-Guenter Kontny <hek@kronos.nic.dtag.de>
235 Fixed a typo that broke imagemap data storage in Lines charts
236
2370.94 - 0.99:
238 Modified the 'title' option to correctly process newlines
239 Deprecated the 'subtitle' option, will remove it in next release
240 Changed the API for specifying colors
241 Added support for printing to file handles
242 Added Chart::Composite
243 Added 'spaced_bars' to make it easy to differentiate the bars
244 Added 'grey_background' to make plot background grey
245 Added support for negative values in the datasets
246 Added methods to remember and dump imagemap pixel information
247 Included rgb.txt with distribution for WinXX users
248
2490.93 - 0.94:
250 Moved the legend down to be flush with the chart
251 Fixed the long decimal y-tick label problem
252 Fixed (for the last time, hopefully) the pre-5.004 compilation problem
253 Fixed handling of undefined data points
254 Added more colors for the default data colors
255 Added the transparent gif option
256 Added the option for user-specified colors
257 Added the grid_lines option
258
2590.92 - 0.93:
260 Fixed the sort problem
261 Fixed the y-axis label centering problem
262 Fixed pre-5.004 compilation problem
263 Added StackedBars charts
264
265------
266MAINTAINER
267------
268
269Chart-Group (chart@fs.wettzell.de)
270
271---------
272COPYRIGHT
273---------
274
275Copyright(c) 1997-1998 David Bonner, 1999 Peter Clark,
2762001-2012 Chart-Group at BKG.
277All rights reserved.
278This program is free software; you can redistribute it and/or modify it under
279the same terms as Perl itself.
280