]>
Commit | Line | Data |
---|---|---|
2eac77fc | 1 | package Imager::Graph::Vertical; |
2 | ||
3 | =head1 NAME | |
4 | ||
5 | Imager::Graph::Vertical- A super class for line/bar/column charts | |
6 | ||
7 | =cut | |
8 | ||
9 | use strict; | |
10 | use vars qw(@ISA); | |
11 | use Imager::Graph; | |
12 | @ISA = qw(Imager::Graph); | |
13 | ||
23a3585a | 14 | use constant STARTING_MIN_VALUE => 99999; |
2eac77fc | 15 | =over 4 |
16 | ||
17 | =item add_data_series(\@data, $series_name) | |
18 | ||
19 | Add a data series to the graph, of the default type. | |
20 | ||
21 | =cut | |
22 | ||
23 | sub add_data_series { | |
24 | my $self = shift; | |
25 | my $data_ref = shift; | |
26 | my $series_name = shift; | |
27 | ||
28 | my $series_type = $self->_get_default_series_type(); | |
29 | $self->_add_data_series($series_type, $data_ref, $series_name); | |
30 | ||
31 | return; | |
32 | } | |
33 | ||
34 | =item add_column_data_series(\@data, $series_name) | |
35 | ||
36 | Add a column data series to the graph. | |
37 | ||
38 | =cut | |
39 | ||
40 | sub add_column_data_series { | |
41 | my $self = shift; | |
42 | my $data_ref = shift; | |
43 | my $series_name = shift; | |
44 | ||
45 | $self->_add_data_series('column', $data_ref, $series_name); | |
46 | ||
47 | return; | |
48 | } | |
49 | ||
50 | =item add_stacked_column_data_series(\@data, $series_name) | |
51 | ||
52 | Add a stacked column data series to the graph. | |
53 | ||
54 | =cut | |
55 | ||
56 | sub add_stacked_column_data_series { | |
57 | my $self = shift; | |
58 | my $data_ref = shift; | |
59 | my $series_name = shift; | |
60 | ||
61 | $self->_add_data_series('stacked_column', $data_ref, $series_name); | |
62 | ||
63 | return; | |
64 | } | |
65 | ||
66 | =item add_line_data_series(\@data, $series_name) | |
67 | ||
68 | Add a line data series to the graph. | |
69 | ||
70 | =cut | |
71 | ||
72 | sub add_line_data_series { | |
73 | my $self = shift; | |
74 | my $data_ref = shift; | |
75 | my $series_name = shift; | |
76 | ||
77 | $self->_add_data_series('line', $data_ref, $series_name); | |
78 | ||
79 | return; | |
80 | } | |
81 | ||
23a3585a TC |
82 | =item set_y_max($value) |
83 | ||
84 | Sets the maximum y value to be displayed. This will be ignored if the y_max is lower than the highest value. | |
85 | ||
86 | =cut | |
87 | ||
88 | sub set_y_max { | |
89 | $_[0]->{'custom_style'}->{'y_max'} = $_[1]; | |
90 | } | |
91 | ||
92 | =item set_y_min($value) | |
93 | ||
94 | Sets the minimum y value to be displayed. This will be ignored if the y_min is higher than the lowest value. | |
95 | ||
96 | =cut | |
97 | ||
98 | sub set_y_min { | |
99 | $_[0]->{'custom_style'}->{'y_min'} = $_[1]; | |
100 | } | |
101 | ||
2eac77fc | 102 | =item set_range_padding($percentage) |
103 | ||
104 | Sets the padding to be used, as a percentage. For example, if your data ranges from 0 to 10, and you have a 20 percent padding, the y axis will go to 12. | |
105 | ||
23a3585a | 106 | Defaults to 10. This attribute is ignored for positive numbers if set_y_max() has been called, and ignored for negative numbers if set_y_min() has been called. |
2eac77fc | 107 | |
108 | =cut | |
109 | ||
110 | sub set_range_padding { | |
111 | $_[0]->{'custom_style'}->{'range_padding'} = $_[1]; | |
112 | } | |
113 | ||
23a3585a TC |
114 | =item set_negative_background($color) |
115 | ||
116 | Sets the background color used below the x axis. | |
117 | ||
118 | =cut | |
119 | ||
120 | sub set_negative_background { | |
121 | $_[0]->{'custom_style'}->{'negative_bg'} = $_[1]; | |
122 | } | |
123 | ||
2eac77fc | 124 | =item draw() |
125 | ||
126 | Draw the graph | |
127 | ||
128 | =cut | |
129 | ||
130 | sub draw { | |
131 | my ($self, %opts) = @_; | |
132 | ||
133 | if (!$self->_valid_input()) { | |
134 | return; | |
135 | } | |
136 | ||
137 | $self->_style_setup(\%opts); | |
138 | ||
139 | my $style = $self->{_style}; | |
140 | ||
141 | my $img = $self->_get_image() | |
142 | or return; | |
143 | ||
144 | my @image_box = ( 0, 0, $img->getwidth-1, $img->getheight-1 ); | |
145 | $self->_set_image_box(\@image_box); | |
146 | ||
c2c2cb9e | 147 | my @chart_box = ( 0, 0, $img->getwidth-1, $img->getheight-1 ); |
148 | $self->_draw_legend(\@chart_box); | |
149 | if ($style->{title}{text}) { | |
150 | $self->_draw_title($img, \@chart_box) | |
151 | or return; | |
152 | } | |
153 | ||
2eac77fc | 154 | # Scale the graph box down to the widest graph that can cleanly hold the # of columns. |
e554917f | 155 | return unless $self->_get_data_range(); |
c2c2cb9e | 156 | $self->_remove_tics_from_chart_box(\@chart_box); |
2eac77fc | 157 | my $column_count = $self->_get_column_count(); |
158 | ||
159 | my $width = $self->_get_number('width'); | |
160 | my $height = $self->_get_number('height'); | |
2eac77fc | 161 | |
c2c2cb9e | 162 | my $graph_width = $chart_box[2] - $chart_box[0]; |
163 | my $graph_height = $chart_box[3] - $chart_box[1]; | |
2eac77fc | 164 | |
c2c2cb9e | 165 | my $col_width = int(($graph_width - 1) / $column_count) -1; |
166 | $graph_width = $col_width * $column_count + 1; | |
2eac77fc | 167 | |
c2c2cb9e | 168 | my $tic_count = $self->_get_y_tics(); |
169 | my $tic_distance = int(($graph_height-1) / ($tic_count - 1)); | |
170 | $graph_height = $tic_distance * ($tic_count - 1); | |
171 | ||
172 | my $bottom = $chart_box[1]; | |
173 | my $left = $chart_box[0]; | |
2eac77fc | 174 | |
c2c2cb9e | 175 | $self->{'_style'}{'graph_width'} = $graph_width; |
176 | $self->{'_style'}{'graph_height'} = $graph_height; | |
177 | ||
178 | my @graph_box = ($left, $bottom, $left + $graph_width, $bottom + $graph_height); | |
179 | $self->_set_graph_box(\@graph_box); | |
2eac77fc | 180 | |
181 | $img->box( | |
182 | color => $self->_get_color('outline.line'), | |
183 | xmin => $left, | |
184 | xmax => $left+$graph_width, | |
185 | ymin => $bottom, | |
c2c2cb9e | 186 | ymax => $bottom+$graph_height, |
2eac77fc | 187 | ); |
188 | ||
189 | $img->box( | |
190 | color => $self->_get_color('bg'), | |
191 | xmin => $left + 1, | |
192 | xmax => $left+$graph_width - 1, | |
193 | ymin => $bottom + 1, | |
c2c2cb9e | 194 | ymax => $bottom+$graph_height-1 , |
2eac77fc | 195 | filled => 1, |
196 | ); | |
197 | ||
198 | my $min_value = $self->_get_min_value(); | |
199 | my $max_value = $self->_get_max_value(); | |
200 | my $value_range = $max_value - $min_value; | |
201 | ||
202 | my $zero_position; | |
203 | if ($value_range) { | |
c2c2cb9e | 204 | $zero_position = $bottom + $graph_height - (-1*$min_value / $value_range) * ($graph_height-1); |
2eac77fc | 205 | } |
206 | ||
207 | if ($min_value < 0) { | |
208 | $img->box( | |
209 | color => $self->_get_color('negative_bg'), | |
210 | xmin => $left + 1, | |
211 | xmax => $left+$graph_width- 1, | |
212 | ymin => $zero_position, | |
c2c2cb9e | 213 | ymax => $bottom+$graph_height - 1, |
2eac77fc | 214 | filled => 1, |
215 | ); | |
216 | $img->line( | |
217 | x1 => $left+1, | |
218 | y1 => $zero_position, | |
219 | x2 => $left + $graph_width, | |
220 | y2 => $zero_position, | |
221 | color => $self->_get_color('outline.line'), | |
222 | ); | |
223 | } | |
224 | ||
225 | if ($self->_get_data_series()->{'stacked_column'}) { | |
226 | $self->_draw_stacked_columns(); | |
227 | } | |
228 | if ($self->_get_data_series()->{'column'}) { | |
229 | $self->_draw_columns(); | |
230 | } | |
231 | if ($self->_get_data_series()->{'line'}) { | |
232 | $self->_draw_lines(); | |
233 | } | |
c2c2cb9e | 234 | |
235 | if ($self->_get_y_tics()) { | |
236 | $self->_draw_y_tics(); | |
237 | } | |
238 | if ($self->_get_labels()) { | |
239 | $self->_draw_x_tics(); | |
240 | } | |
241 | ||
2eac77fc | 242 | return $self->_get_image(); |
243 | } | |
244 | ||
245 | sub _get_data_range { | |
246 | my $self = shift; | |
247 | ||
248 | my $max_value = 0; | |
249 | my $min_value = 0; | |
250 | my $column_count = 0; | |
251 | ||
252 | my ($sc_min, $sc_max, $sc_cols) = $self->_get_stacked_column_range(); | |
253 | my ($c_min, $c_max, $c_cols) = $self->_get_column_range(); | |
254 | my ($l_min, $l_max, $l_cols) = $self->_get_line_range(); | |
255 | ||
256 | # These are side by side... | |
257 | $sc_cols += $c_cols; | |
258 | ||
23a3585a | 259 | $min_value = $self->_min(STARTING_MIN_VALUE, $sc_min, $c_min, $l_min); |
2eac77fc | 260 | $max_value = $self->_max(0, $sc_max, $c_max, $l_max); |
261 | ||
23a3585a TC |
262 | my $config_min = $self->_get_number('y_min'); |
263 | my $config_max = $self->_get_number('y_max'); | |
264 | ||
265 | if (defined $config_max && $config_max < $max_value) { | |
266 | $config_max = undef; | |
267 | } | |
268 | if (defined $config_min && $config_min > $min_value) { | |
269 | $config_min = undef; | |
270 | } | |
271 | ||
2eac77fc | 272 | my $range_padding = $self->_get_number('range_padding'); |
23a3585a TC |
273 | if (defined $config_min) { |
274 | $min_value = $config_min; | |
275 | } | |
276 | else { | |
277 | if ($min_value > 0) { | |
278 | $min_value = 0; | |
279 | } | |
280 | if ($range_padding && $min_value < 0) { | |
281 | my $difference = $min_value * $range_padding / 100; | |
282 | if ($min_value < -1 && $difference > -1) { | |
283 | $difference = -1; | |
284 | } | |
285 | $min_value += $difference; | |
2eac77fc | 286 | } |
2eac77fc | 287 | } |
23a3585a TC |
288 | if (defined $config_max) { |
289 | $max_value = $config_max; | |
290 | } | |
291 | else { | |
292 | if ($range_padding && $max_value > 0) { | |
293 | my $difference = $max_value * $range_padding / 100; | |
294 | if ($max_value > 1 && $difference < 1) { | |
295 | $difference = 1; | |
296 | } | |
297 | $max_value += $difference; | |
2eac77fc | 298 | } |
2eac77fc | 299 | } |
2eac77fc | 300 | $column_count = $self->_max(0, $sc_cols, $l_cols); |
301 | ||
c2c2cb9e | 302 | if ($self->_get_number('automatic_axis')) { |
303 | # In case this was set via a style, and not by the api method | |
e554917f | 304 | eval { require Chart::Math::Axis; }; |
c2c2cb9e | 305 | if ($@) { |
e554917f | 306 | return $self->_error("Can't use automatic_axis - $@"); |
c2c2cb9e | 307 | } |
308 | ||
309 | my $axis = Chart::Math::Axis->new(); | |
310 | $axis->add_data($min_value, $max_value); | |
311 | $max_value = $axis->top; | |
312 | $min_value = $axis->bottom; | |
313 | my $ticks = $axis->ticks; | |
314 | # The +1 is there because we have the bottom tick as well | |
315 | $self->set_y_tics($ticks+1); | |
316 | } | |
317 | ||
2eac77fc | 318 | $self->_set_max_value($max_value); |
319 | $self->_set_min_value($min_value); | |
320 | $self->_set_column_count($column_count); | |
e554917f | 321 | |
322 | return 1; | |
2eac77fc | 323 | } |
324 | ||
325 | sub _min { | |
326 | my $self = shift; | |
327 | my $min = shift; | |
328 | ||
329 | foreach my $value (@_) { | |
23a3585a | 330 | next unless defined $value; |
2eac77fc | 331 | if ($value < $min) { $min = $value; } |
332 | } | |
333 | return $min; | |
334 | } | |
335 | ||
336 | sub _max { | |
337 | my $self = shift; | |
338 | my $min = shift; | |
339 | ||
340 | foreach my $value (@_) { | |
23a3585a | 341 | next unless defined $value; |
2eac77fc | 342 | if ($value > $min) { $min = $value; } |
343 | } | |
344 | return $min; | |
345 | } | |
346 | ||
347 | sub _get_line_range { | |
348 | my $self = shift; | |
349 | my $series = $self->_get_data_series()->{'line'}; | |
23a3585a | 350 | return (undef, undef, 0) unless $series; |
2eac77fc | 351 | |
352 | my $max_value = 0; | |
23a3585a | 353 | my $min_value = STARTING_MIN_VALUE; |
2eac77fc | 354 | my $column_count = 0; |
355 | ||
356 | my @series = @{$series}; | |
357 | foreach my $series (@series) { | |
358 | my @data = @{$series->{'data'}}; | |
359 | ||
360 | if (scalar @data > $column_count) { | |
361 | $column_count = scalar @data; | |
362 | } | |
363 | ||
364 | foreach my $value (@data) { | |
365 | if ($value > $max_value) { $max_value = $value; } | |
366 | if ($value < $min_value) { $min_value = $value; } | |
367 | } | |
368 | } | |
369 | ||
370 | return ($min_value, $max_value, $column_count); | |
371 | } | |
372 | ||
373 | sub _get_column_range { | |
374 | my $self = shift; | |
375 | ||
376 | my $series = $self->_get_data_series()->{'column'}; | |
23a3585a | 377 | return (undef, undef, 0) unless $series; |
2eac77fc | 378 | |
379 | my $max_value = 0; | |
23a3585a | 380 | my $min_value = STARTING_MIN_VALUE; |
2eac77fc | 381 | my $column_count = 0; |
382 | ||
383 | my @series = @{$series}; | |
384 | foreach my $series (@series) { | |
385 | my @data = @{$series->{'data'}}; | |
386 | ||
387 | foreach my $value (@data) { | |
388 | $column_count++; | |
389 | if ($value > $max_value) { $max_value = $value; } | |
390 | if ($value < $min_value) { $min_value = $value; } | |
391 | } | |
392 | } | |
393 | ||
394 | return ($min_value, $max_value, $column_count); | |
395 | } | |
396 | ||
397 | sub _get_stacked_column_range { | |
398 | my $self = shift; | |
399 | ||
400 | my $max_value = 0; | |
23a3585a | 401 | my $min_value = STARTING_MIN_VALUE; |
2eac77fc | 402 | my $column_count = 0; |
403 | ||
23a3585a | 404 | return (undef, undef, 0) unless $self->_get_data_series()->{'stacked_column'}; |
2eac77fc | 405 | my @series = @{$self->_get_data_series()->{'stacked_column'}}; |
406 | ||
407 | my @max_entries; | |
408 | my @min_entries; | |
409 | for (my $i = scalar @series - 1; $i >= 0; $i--) { | |
410 | my $series = $series[$i]; | |
411 | my $data = $series->{'data'}; | |
412 | ||
413 | for (my $i = 0; $i < scalar @$data; $i++) { | |
414 | my $value = 0; | |
415 | if ($data->[$i] > 0) { | |
416 | $value = $data->[$i] + ($max_entries[$i] || 0); | |
417 | $data->[$i] = $value; | |
418 | $max_entries[$i] = $value; | |
419 | } | |
420 | elsif ($data->[$i] < 0) { | |
421 | $value = $data->[$i] + ($min_entries[$i] || 0); | |
422 | $data->[$i] = $value; | |
423 | $min_entries[$i] = $value; | |
424 | } | |
425 | if ($value > $max_value) { $max_value = $value; } | |
426 | if ($value < $min_value) { $min_value = $value; } | |
427 | } | |
428 | if (scalar @$data > $column_count) { | |
429 | $column_count = scalar @$data; | |
430 | } | |
431 | } | |
432 | ||
433 | return ($min_value, $max_value, $column_count); | |
434 | } | |
435 | ||
436 | sub _draw_legend { | |
437 | my $self = shift; | |
c2c2cb9e | 438 | my $chart_box = shift; |
2eac77fc | 439 | my $style = $self->{'_style'}; |
440 | ||
441 | my @labels; | |
442 | my $img = $self->_get_image(); | |
443 | if (my $series = $self->_get_data_series()->{'stacked_column'}) { | |
444 | push @labels, map { $_->{'series_name'} } @$series; | |
445 | } | |
446 | if (my $series = $self->_get_data_series()->{'column'}) { | |
447 | push @labels, map { $_->{'series_name'} } @$series; | |
448 | } | |
449 | if (my $series = $self->_get_data_series()->{'line'}) { | |
450 | push @labels, map { $_->{'series_name'} } @$series; | |
451 | } | |
452 | ||
453 | if ($style->{features}{legend} && (scalar @labels)) { | |
c2c2cb9e | 454 | $self->SUPER::_draw_legend($self->_get_image(), \@labels, $chart_box) |
2eac77fc | 455 | or return; |
456 | } | |
457 | return; | |
458 | } | |
459 | ||
460 | sub _draw_flat_legend { | |
461 | return 1; | |
462 | } | |
463 | ||
464 | sub _draw_lines { | |
465 | my $self = shift; | |
466 | my $style = $self->{'_style'}; | |
467 | ||
468 | my $img = $self->_get_image(); | |
469 | ||
470 | my $max_value = $self->_get_max_value(); | |
471 | my $min_value = $self->_get_min_value(); | |
472 | my $column_count = $self->_get_column_count(); | |
473 | ||
474 | my $value_range = $max_value - $min_value; | |
475 | ||
476 | my $width = $self->_get_number('width'); | |
477 | my $height = $self->_get_number('height'); | |
2eac77fc | 478 | |
c2c2cb9e | 479 | my $graph_width = $self->_get_number('graph_width'); |
480 | my $graph_height = $self->_get_number('graph_height'); | |
2eac77fc | 481 | |
482 | my $line_series = $self->_get_data_series()->{'line'}; | |
483 | my $series_counter = $self->_get_series_counter() || 0; | |
484 | ||
485 | my $has_columns = (defined $self->_get_data_series()->{'column'} || $self->_get_data_series->{'stacked_column'}) ? 1 : 0; | |
486 | ||
c2c2cb9e | 487 | my $col_width = int($graph_width / $column_count) -1; |
488 | ||
489 | my $graph_box = $self->_get_graph_box(); | |
490 | my $left = $graph_box->[0] + 1; | |
491 | my $bottom = $graph_box->[1]; | |
492 | ||
493 | my $zero_position = $bottom + $graph_height - (-1*$min_value / $value_range) * ($graph_height - 1); | |
494 | ||
2eac77fc | 495 | |
49a35584 | 496 | my $line_aa = $self->_get_number("lineaa"); |
2eac77fc | 497 | foreach my $series (@$line_series) { |
498 | my @data = @{$series->{'data'}}; | |
499 | my $data_size = scalar @data; | |
500 | ||
501 | my $interval; | |
502 | if ($has_columns) { | |
503 | $interval = $graph_width / ($data_size); | |
504 | } | |
505 | else { | |
506 | $interval = $graph_width / ($data_size - 1); | |
507 | } | |
2eac77fc | 508 | my $color = $self->_data_color($series_counter); |
8e140388 TC |
509 | |
510 | # We need to add these last, otherwise the next line segment will overwrite half of the marker | |
511 | my @marker_positions; | |
2eac77fc | 512 | for (my $i = 0; $i < $data_size - 1; $i++) { |
513 | my $x1 = $left + $i * $interval; | |
514 | my $x2 = $left + ($i + 1) * $interval; | |
515 | ||
516 | $x1 += $has_columns * $interval / 2; | |
517 | $x2 += $has_columns * $interval / 2; | |
518 | ||
c2c2cb9e | 519 | my $y1 = $bottom + ($value_range - $data[$i] + $min_value)/$value_range * $graph_height; |
520 | my $y2 = $bottom + ($value_range - $data[$i + 1] + $min_value)/$value_range * $graph_height; | |
2eac77fc | 521 | |
8e140388 | 522 | push @marker_positions, [$x1, $y1]; |
49a35584 | 523 | $img->line(x1 => $x1, y1 => $y1, x2 => $x2, y2 => $y2, aa => $line_aa, color => $color) || die $img->errstr; |
2eac77fc | 524 | } |
525 | ||
526 | my $x2 = $left + ($data_size - 1) * $interval; | |
527 | $x2 += $has_columns * $interval / 2; | |
528 | ||
c2c2cb9e | 529 | my $y2 = $bottom + ($value_range - $data[$data_size - 1] + $min_value)/$value_range * $graph_height; |
2eac77fc | 530 | |
8e140388 TC |
531 | push @marker_positions, [$x2, $y2]; |
532 | foreach my $position (@marker_positions) { | |
533 | $self->_draw_line_marker($position->[0], $position->[1], $series_counter); | |
534 | } | |
2eac77fc | 535 | $series_counter++; |
536 | } | |
537 | ||
538 | $self->_set_series_counter($series_counter); | |
539 | return; | |
540 | } | |
541 | ||
8e140388 TC |
542 | sub _line_marker { |
543 | my ($self, $index) = @_; | |
544 | ||
545 | my $markers = $self->{'_style'}{'line_markers'}; | |
546 | if (!$markers) { | |
547 | return; | |
548 | } | |
549 | my $marker = $markers->[$index % @$markers]; | |
550 | ||
551 | return $marker; | |
552 | } | |
553 | ||
554 | sub _draw_line_marker { | |
555 | my $self = shift; | |
556 | my ($x1, $y1, $series_counter) = @_; | |
557 | ||
558 | my $img = $self->_get_image(); | |
559 | ||
560 | my $style = $self->_line_marker($series_counter); | |
561 | return unless $style; | |
562 | ||
563 | my $type = $style->{'shape'}; | |
564 | my $radius = $style->{'radius'}; | |
565 | ||
49a35584 TC |
566 | my $line_aa = $self->_get_number("lineaa"); |
567 | my $fill_aa = $self->_get_number("fill.aa"); | |
8e140388 TC |
568 | if ($type eq 'circle') { |
569 | my @fill = $self->_data_fill($series_counter, [$x1 - $radius, $y1 - $radius, $x1 + $radius, $y1 + $radius]); | |
49a35584 | 570 | $img->circle(x => $x1, y => $y1, r => $radius, aa => $fill_aa, filled => 1, @fill); |
8e140388 TC |
571 | } |
572 | elsif ($type eq 'square') { | |
573 | my @fill = $self->_data_fill($series_counter, [$x1 - $radius, $y1 - $radius, $x1 + $radius, $y1 + $radius]); | |
574 | $img->box(xmin => $x1 - $radius, ymin => $y1 - $radius, xmax => $x1 + $radius, ymax => $y1 + $radius, @fill); | |
575 | } | |
576 | elsif ($type eq 'diamond') { | |
577 | # The gradient really doesn't work for diamond | |
578 | my $color = $self->_data_color($series_counter); | |
579 | $img->polygon( | |
580 | points => [ | |
581 | [$x1 - $radius, $y1], | |
582 | [$x1, $y1 + $radius], | |
583 | [$x1 + $radius, $y1], | |
584 | [$x1, $y1 - $radius], | |
585 | ], | |
49a35584 | 586 | filled => 1, color => $color, aa => $fill_aa); |
8e140388 TC |
587 | } |
588 | elsif ($type eq 'triangle') { | |
589 | # The gradient really doesn't work for triangle | |
590 | my $color = $self->_data_color($series_counter); | |
591 | $img->polygon( | |
592 | points => [ | |
593 | [$x1 - $radius, $y1 + $radius], | |
594 | [$x1 + $radius, $y1 + $radius], | |
595 | [$x1, $y1 - $radius], | |
596 | ], | |
49a35584 | 597 | filled => 1, color => $color, aa => $fill_aa); |
8e140388 TC |
598 | |
599 | } | |
600 | elsif ($type eq 'x') { | |
601 | my $color = $self->_data_color($series_counter); | |
49a35584 TC |
602 | $img->line(x1 => $x1 - $radius, y1 => $y1 -$radius, x2 => $x1 + $radius, y2 => $y1+$radius, aa => $line_aa, color => $color) || die $img->errstr; |
603 | $img->line(x1 => $x1 + $radius, y1 => $y1 -$radius, x2 => $x1 - $radius, y2 => $y1+$radius, aa => $line_aa, color => $color) || die $img->errstr; | |
8e140388 TC |
604 | } |
605 | elsif ($type eq 'plus') { | |
606 | my $color = $self->_data_color($series_counter); | |
49a35584 TC |
607 | $img->line(x1 => $x1, y1 => $y1 -$radius, x2 => $x1, y2 => $y1+$radius, aa => $line_aa, color => $color) || die $img->errstr; |
608 | $img->line(x1 => $x1 + $radius, y1 => $y1, x2 => $x1 - $radius, y2 => $y1, aa => $line_aa, color => $color) || die $img->errstr; | |
8e140388 TC |
609 | } |
610 | } | |
611 | ||
2eac77fc | 612 | sub _draw_columns { |
613 | my $self = shift; | |
614 | my $style = $self->{'_style'}; | |
615 | ||
616 | my $img = $self->_get_image(); | |
617 | ||
618 | my $max_value = $self->_get_max_value(); | |
619 | my $min_value = $self->_get_min_value(); | |
620 | my $column_count = $self->_get_column_count(); | |
621 | ||
622 | my $value_range = $max_value - $min_value; | |
623 | ||
624 | my $width = $self->_get_number('width'); | |
625 | my $height = $self->_get_number('height'); | |
2eac77fc | 626 | |
c2c2cb9e | 627 | my $graph_width = $self->_get_number('graph_width'); |
628 | my $graph_height = $self->_get_number('graph_height'); | |
2eac77fc | 629 | |
2eac77fc | 630 | |
c2c2cb9e | 631 | my $graph_box = $self->_get_graph_box(); |
632 | my $left = $graph_box->[0] + 1; | |
633 | my $bottom = $graph_box->[1]; | |
634 | my $zero_position = int($bottom + $graph_height - (-1*$min_value / $value_range) * ($graph_height -1)); | |
2eac77fc | 635 | |
c2c2cb9e | 636 | my $bar_width = int($graph_width / $column_count - 1); |
2eac77fc | 637 | |
638 | my $outline_color; | |
639 | if ($style->{'features'}{'outline'}) { | |
640 | $outline_color = $self->_get_color('outline.line'); | |
641 | } | |
642 | ||
643 | my $series_counter = $self->_get_series_counter() || 0; | |
644 | my $col_series = $self->_get_data_series()->{'column'}; | |
645 | ||
646 | # This tracks the series we're in relative to the starting series - this way colors stay accurate, but the columns don't start out too far to the right. | |
647 | my $column_series = 0; | |
648 | ||
649 | # If there are stacked columns, non-stacked columns need to start one to the right of where they would otherwise | |
650 | my $has_stacked_columns = (defined $self->_get_data_series()->{'stacked_column'} ? 1 : 0); | |
651 | ||
652 | for (my $series_pos = 0; $series_pos < scalar @$col_series; $series_pos++) { | |
653 | my $series = $col_series->[$series_pos]; | |
654 | my @data = @{$series->{'data'}}; | |
655 | my $data_size = scalar @data; | |
656 | my $color = $self->_data_color($series_counter); | |
657 | for (my $i = 0; $i < $data_size; $i++) { | |
658 | my $x1 = int($left + $bar_width * (scalar @$col_series * $i + $series_pos)) + scalar @$col_series * $i + $series_pos; | |
659 | if ($has_stacked_columns) { | |
660 | $x1 += ($i + 1) * $bar_width + $i + 1; | |
661 | } | |
662 | my $x2 = $x1 + $bar_width; | |
663 | ||
c2c2cb9e | 664 | my $y1 = int($bottom + ($value_range - $data[$i] + $min_value)/$value_range * $graph_height); |
2eac77fc | 665 | |
666 | my $color = $self->_data_color($series_counter); | |
667 | ||
668 | # my @fill = $self->_data_fill($series_counter, [$x1, $y1, $x2, $zero_position]); | |
669 | if ($data[$i] > 0) { | |
670 | $img->box(xmin => $x1, xmax => $x2, ymin => $y1, ymax => $zero_position-1, color => $color, filled => 1); | |
671 | if ($style->{'features'}{'outline'}) { | |
672 | $img->box(xmin => $x1, xmax => $x2, ymin => $y1, ymax => $zero_position, color => $outline_color); | |
673 | } | |
674 | } | |
675 | else { | |
676 | $img->box(xmin => $x1, xmax => $x2, ymin => $zero_position+1, ymax => $y1, color => $color, filled => 1); | |
677 | if ($style->{'features'}{'outline'}) { | |
678 | $img->box(xmin => $x1, xmax => $x2, ymin => $zero_position+1, ymax => $y1+1, color => $outline_color); | |
679 | } | |
680 | } | |
681 | } | |
682 | ||
683 | $series_counter++; | |
684 | $column_series++; | |
685 | } | |
686 | $self->_set_series_counter($series_counter); | |
687 | return; | |
688 | } | |
689 | ||
690 | sub _draw_stacked_columns { | |
691 | my $self = shift; | |
692 | my $style = $self->{'_style'}; | |
693 | ||
694 | my $img = $self->_get_image(); | |
695 | ||
696 | my $max_value = $self->_get_max_value(); | |
697 | my $min_value = $self->_get_min_value(); | |
698 | my $column_count = $self->_get_column_count(); | |
699 | my $value_range = $max_value - $min_value; | |
700 | ||
701 | my $graph_box = $self->_get_graph_box(); | |
702 | my $left = $graph_box->[0] + 1; | |
703 | my $bottom = $graph_box->[1]; | |
2eac77fc | 704 | |
c2c2cb9e | 705 | my $graph_width = $self->_get_number('graph_width'); |
706 | my $graph_height = $self->_get_number('graph_height'); | |
2eac77fc | 707 | |
c2c2cb9e | 708 | my $bar_width = int($graph_width / $column_count -1); |
2eac77fc | 709 | my $column_series = 0; |
710 | if (my $column_series_data = $self->_get_data_series()->{'column'}) { | |
711 | $column_series = (scalar @$column_series_data); | |
712 | } | |
713 | $column_series++; | |
714 | ||
715 | my $outline_color; | |
716 | if ($style->{'features'}{'outline'}) { | |
717 | $outline_color = $self->_get_color('outline.line'); | |
718 | } | |
719 | ||
c2c2cb9e | 720 | my $zero_position = $bottom + $graph_height - (-1*$min_value / $value_range) * ($graph_height -1); |
2eac77fc | 721 | my $col_series = $self->_get_data_series()->{'stacked_column'}; |
722 | my $series_counter = $self->_get_series_counter() || 0; | |
723 | foreach my $series (@$col_series) { | |
724 | my @data = @{$series->{'data'}}; | |
725 | my $data_size = scalar @data; | |
726 | my $color = $self->_data_color($series_counter); | |
727 | for (my $i = 0; $i < $data_size; $i++) { | |
728 | my $x1 = int($left + $bar_width * ($column_series * $i)) + $column_series * $i; | |
2eac77fc | 729 | my $x2 = $x1 + $bar_width; |
730 | ||
c2c2cb9e | 731 | my $y1 = $bottom + ($value_range - $data[$i] + $min_value)/$value_range * $graph_height; |
2eac77fc | 732 | |
733 | if ($data[$i] > 0) { | |
734 | $img->box(xmin => $x1, xmax => $x2, ymin => $y1, ymax => $zero_position-1, color => $color, filled => 1); | |
735 | if ($style->{'features'}{'outline'}) { | |
736 | $img->box(xmin => $x1, xmax => $x2, ymin => $y1, ymax => $zero_position, color => $outline_color); | |
737 | } | |
738 | } | |
739 | else { | |
740 | $img->box(xmin => $x1, xmax => $x2, ymin => $zero_position+1, ymax => $y1, color => $color, filled => 1); | |
741 | if ($style->{'features'}{'outline'}) { | |
742 | $img->box(xmin => $x1, xmax => $x2, ymin => $zero_position+1, ymax => $y1+1, color => $outline_color); | |
743 | } | |
744 | } | |
745 | } | |
746 | ||
747 | $series_counter++; | |
748 | } | |
749 | $self->_set_series_counter($series_counter); | |
750 | return; | |
751 | } | |
752 | ||
753 | sub _add_data_series { | |
754 | my $self = shift; | |
755 | my $series_type = shift; | |
756 | my $data_ref = shift; | |
757 | my $series_name = shift; | |
758 | ||
759 | my $graph_data = $self->{'graph_data'} || {}; | |
760 | ||
761 | my $series = $graph_data->{$series_type} || []; | |
762 | ||
763 | push @$series, { data => $data_ref, series_name => $series_name }; | |
764 | ||
765 | $graph_data->{$series_type} = $series; | |
766 | ||
767 | $self->{'graph_data'} = $graph_data; | |
768 | return; | |
769 | } | |
770 | ||
771 | =over | |
772 | ||
c2c2cb9e | 773 | =item show_horizontal_gridlines() |
774 | ||
775 | Shows horizontal gridlines at the y-tics. | |
776 | ||
777 | =cut | |
778 | ||
779 | sub show_horizontal_gridlines { | |
780 | $_[0]->{'custom_style'}->{'horizontal_gridlines'} = 1; | |
781 | } | |
782 | ||
783 | =item use_automatic_axis() | |
784 | ||
e554917f | 785 | Automatically scale the Y axis, based on L<Chart::Math::Axis>. If Chart::Math::Axis isn't installed, this sets an error and returns undef. Returns 1 if it is installed. |
c2c2cb9e | 786 | |
787 | =cut | |
788 | ||
789 | sub use_automatic_axis { | |
e554917f | 790 | eval { require Chart::Math::Axis; }; |
c2c2cb9e | 791 | if ($@) { |
e554917f | 792 | return $_[0]->_error("use_automatic_axis - $@\nCalled from ".join(' ', caller)."\n"); |
c2c2cb9e | 793 | } |
794 | $_[0]->{'custom_style'}->{'automatic_axis'} = 1; | |
e554917f | 795 | return 1; |
c2c2cb9e | 796 | } |
797 | ||
798 | ||
2eac77fc | 799 | =item set_y_tics($count) |
800 | ||
801 | Set the number of Y tics to use. Their value and position will be determined by the data range. | |
802 | ||
803 | =cut | |
804 | ||
805 | sub set_y_tics { | |
806 | $_[0]->{'y_tics'} = $_[1]; | |
807 | } | |
808 | ||
809 | sub _get_y_tics { | |
28acfd43 | 810 | return $_[0]->{'y_tics'} || 0; |
2eac77fc | 811 | } |
812 | ||
c2c2cb9e | 813 | sub _remove_tics_from_chart_box { |
814 | my $self = shift; | |
815 | my $chart_box = shift; | |
816 | ||
817 | # XXX - bad default | |
818 | my $tic_width = $self->_get_y_tic_width() || 10; | |
819 | my @y_tic_box = ($chart_box->[0], $chart_box->[1], $chart_box->[0] + $tic_width, $chart_box->[3]); | |
820 | ||
821 | # XXX - bad default | |
822 | my $tic_height = $self->_get_x_tic_height() || 10; | |
823 | my @x_tic_box = ($chart_box->[0], $chart_box->[3] - $tic_height, $chart_box->[2], $chart_box->[3]); | |
824 | ||
825 | $self->_remove_box($chart_box, \@y_tic_box); | |
826 | $self->_remove_box($chart_box, \@x_tic_box); | |
827 | } | |
828 | ||
829 | sub _get_y_tic_width{ | |
830 | my $self = shift; | |
831 | my $min = $self->_get_min_value(); | |
832 | my $max = $self->_get_max_value(); | |
833 | my $tic_count = $self->_get_y_tics(); | |
834 | ||
835 | my $img = $self->_get_image(); | |
836 | my $graph_box = $self->_get_graph_box(); | |
837 | my $image_box = $self->_get_image_box(); | |
838 | ||
839 | my $interval = ($max - $min) / ($tic_count - 1); | |
840 | ||
841 | my %text_info = $self->_text_style('legend') | |
842 | or return; | |
843 | ||
844 | my $max_width = 0; | |
845 | for my $count (0 .. $tic_count - 1) { | |
846 | my $value = sprintf("%.2f", ($count*$interval)+$min); | |
847 | ||
848 | my @box = $self->_text_bbox($value, 'legend'); | |
849 | my $width = $box[2] - $box[0]; | |
850 | ||
851 | # For the tic width | |
852 | $width += 10; | |
853 | if ($width > $max_width) { | |
854 | $max_width = $width; | |
855 | } | |
856 | } | |
857 | ||
858 | return $max_width; | |
859 | } | |
860 | ||
861 | sub _get_x_tic_height { | |
862 | my $self = shift; | |
863 | ||
864 | my $labels = $self->_get_labels(); | |
865 | ||
866 | my $tic_count = (scalar @$labels) - 1; | |
867 | ||
868 | my %text_info = $self->_text_style('legend') | |
869 | or return; | |
870 | ||
871 | my $max_height = 0; | |
872 | for my $count (0 .. $tic_count) { | |
873 | my $label = $labels->[$count]; | |
874 | ||
875 | my @box = $self->_text_bbox($label, 'legend'); | |
876 | ||
877 | my $height = $box[3] - $box[1]; | |
878 | ||
879 | # Padding + the tic | |
880 | $height += 10; | |
881 | if ($height > $max_height) { | |
882 | $max_height = $height; | |
883 | } | |
884 | } | |
885 | ||
886 | return $max_height; | |
887 | } | |
888 | ||
2eac77fc | 889 | sub _draw_y_tics { |
890 | my $self = shift; | |
891 | my $min = $self->_get_min_value(); | |
892 | my $max = $self->_get_max_value(); | |
893 | my $tic_count = $self->_get_y_tics(); | |
894 | ||
895 | my $img = $self->_get_image(); | |
896 | my $graph_box = $self->_get_graph_box(); | |
897 | my $image_box = $self->_get_image_box(); | |
898 | ||
899 | my $interval = ($max - $min) / ($tic_count - 1); | |
900 | ||
901 | my %text_info = $self->_text_style('legend') | |
902 | or return; | |
903 | ||
c2c2cb9e | 904 | my $show_gridlines = $self->_get_number('horizontal_gridlines'); |
905 | my $tic_distance = int(($graph_box->[3] - $graph_box->[1]) / ($tic_count - 1)); | |
2eac77fc | 906 | for my $count (0 .. $tic_count - 1) { |
907 | my $x1 = $graph_box->[0] - 5; | |
908 | my $x2 = $graph_box->[0] + 5; | |
c2c2cb9e | 909 | my $y1 = $graph_box->[3] - ($count * $tic_distance); |
2eac77fc | 910 | |
c2c2cb9e | 911 | my $value = ($count*$interval)+$min; |
912 | if ($interval < 1 || ($value != int($value))) { | |
913 | $value = sprintf("%.2f", $value); | |
914 | } | |
23a3585a | 915 | |
2eac77fc | 916 | my @box = $self->_text_bbox($value, 'legend') |
917 | or return; | |
918 | ||
919 | $img->line(x1 => $x1, x2 => $x2, y1 => $y1, y2 => $y1, aa => 1, color => '000000'); | |
920 | ||
921 | my $width = $box[2]; | |
922 | my $height = $box[3]; | |
923 | ||
924 | $img->string(%text_info, | |
925 | x => ($x1 - $width - 3), | |
926 | y => ($y1 + ($height / 2)), | |
927 | text => $value | |
928 | ); | |
c2c2cb9e | 929 | |
930 | if ($show_gridlines) { | |
931 | # XXX - line styles! | |
932 | for (my $i = $graph_box->[0]; $i < $graph_box->[2]; $i += 6) { | |
933 | my $x1 = $i; | |
934 | my $x2 = $i + 2; | |
935 | if ($x2 > $graph_box->[2]) { $x2 = $graph_box->[2]; } | |
936 | $img->line(x1 => $x1, x2 => $x2, y1 => $y1, y2 => $y1, aa => 1, color => '000000'); | |
937 | } | |
938 | } | |
2eac77fc | 939 | } |
940 | ||
941 | } | |
942 | ||
943 | sub _draw_x_tics { | |
944 | my $self = shift; | |
945 | ||
946 | my $img = $self->_get_image(); | |
947 | my $graph_box = $self->_get_graph_box(); | |
948 | my $image_box = $self->_get_image_box(); | |
949 | ||
950 | my $labels = $self->_get_labels(); | |
951 | ||
952 | my $tic_count = (scalar @$labels) - 1; | |
953 | ||
954 | my $has_columns = (defined $self->_get_data_series()->{'column'} || defined $self->_get_data_series()->{'stacked_column'}); | |
955 | ||
956 | # If we have columns, we want the x-ticks to show up in the middle of the column, not on the left edge | |
957 | my $denominator = $tic_count; | |
958 | if ($has_columns) { | |
959 | $denominator ++; | |
960 | } | |
961 | my $tic_distance = ($graph_box->[2] - $graph_box->[0]) / ($denominator); | |
962 | my %text_info = $self->_text_style('legend') | |
963 | or return; | |
964 | ||
965 | for my $count (0 .. $tic_count) { | |
966 | my $label = $labels->[$count]; | |
967 | my $x1 = $graph_box->[0] + ($tic_distance * $count); | |
968 | ||
969 | if ($has_columns) { | |
970 | $x1 += $tic_distance / 2; | |
971 | } | |
972 | my $y1 = $graph_box->[3] + 5; | |
973 | my $y2 = $graph_box->[3] - 5; | |
974 | ||
975 | $img->line(x1 => $x1, x2 => $x1, y1 => $y1, y2 => $y2, aa => 1, color => '000000'); | |
976 | ||
977 | my @box = $self->_text_bbox($label, 'legend') | |
978 | or return; | |
979 | ||
980 | my $width = $box[2]; | |
981 | my $height = $box[3]; | |
982 | ||
983 | $img->string(%text_info, | |
984 | x => ($x1 - ($width / 2)), | |
985 | y => ($y1 + ($height + 5)), | |
986 | text => $label | |
987 | ); | |
988 | ||
989 | } | |
990 | } | |
991 | ||
992 | sub _valid_input { | |
993 | my $self = shift; | |
994 | ||
995 | if (!defined $self->_get_data_series() || !keys %{$self->_get_data_series()}) { | |
996 | return $self->_error("No data supplied"); | |
997 | } | |
998 | ||
999 | my $data = $self->_get_data_series(); | |
1000 | if (defined $data->{'line'} && !scalar @{$data->{'line'}->[0]->{'data'}}) { | |
1001 | return $self->_error("No values in data series"); | |
1002 | } | |
1003 | if (defined $data->{'column'} && !scalar @{$data->{'column'}->[0]->{'data'}}) { | |
1004 | return $self->_error("No values in data series"); | |
1005 | } | |
1006 | if (defined $data->{'stacked_column'} && !scalar @{$data->{'stacked_column'}->[0]->{'data'}}) { | |
1007 | return $self->_error("No values in data series"); | |
1008 | } | |
1009 | ||
1010 | return 1; | |
1011 | } | |
1012 | ||
1013 | sub _set_column_count { $_[0]->{'column_count'} = $_[1]; } | |
1014 | sub _set_min_value { $_[0]->{'min_value'} = $_[1]; } | |
1015 | sub _set_max_value { $_[0]->{'max_value'} = $_[1]; } | |
1016 | sub _set_image_box { $_[0]->{'image_box'} = $_[1]; } | |
1017 | sub _set_graph_box { $_[0]->{'graph_box'} = $_[1]; } | |
1018 | sub _set_series_counter { $_[0]->{'series_counter'} = $_[1]; } | |
1019 | sub _get_column_count { return $_[0]->{'column_count'} } | |
1020 | sub _get_min_value { return $_[0]->{'min_value'} } | |
1021 | sub _get_max_value { return $_[0]->{'max_value'} } | |
1022 | sub _get_image_box { return $_[0]->{'image_box'} } | |
1023 | sub _get_graph_box { return $_[0]->{'graph_box'} } | |
1024 | sub _get_series_counter { return $_[0]->{'series_counter'} } | |
1025 | ||
2eac77fc | 1026 | 1; |