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