fix the version update test and update some versions
[imager-graph.git] / lib / Imager / Graph / Horizontal.pm
CommitLineData
f0b01a81 1package Imager::Graph::Horizontal;
2
3=head1 NAME
4
5 Imager::Graph::Horizontal - A super class for line/bar charts
6
0625a02f
TC
7=head1 DESCRIPTION
8
9This is a base class that implements base functionality for line and
10bar charts.
11
12The sub-classes, Imager::Graph::Bar and Imager::Graph::Line simply
13provide default data series types.
14
f0b01a81 15=cut
16
17use strict;
18use vars qw(@ISA);
19use Imager::Graph;
20@ISA = qw(Imager::Graph);
21
22use constant STARTING_MIN_VALUE => 99999;
23
172d0769 24our $VERSION = "0.11";
e26d9fde 25
0625a02f
TC
26=head1 METHODS
27
28=over
f0b01a81 29
30=item add_data_series(\@data, $series_name)
31
32Add a data series to the graph, of the default type.
33
34=cut
35
36sub add_data_series {
37 my $self = shift;
38 my $data_ref = shift;
39 my $series_name = shift;
40
41 my $series_type = $self->_get_default_series_type();
42 $self->_add_data_series($series_type, $data_ref, $series_name);
43
44 return;
45}
46
86f73dc2 47=item add_bar_data_series(\@data, $series_name)
f0b01a81 48
86f73dc2 49Add a bar data series to the graph.
f0b01a81 50
51=cut
52
86f73dc2 53sub add_bar_data_series {
f0b01a81 54 my $self = shift;
55 my $data_ref = shift;
56 my $series_name = shift;
57
86f73dc2 58 $self->_add_data_series('bar', $data_ref, $series_name);
f0b01a81 59
60 return;
61}
62
63=item add_line_data_series(\@data, $series_name)
64
65Add a line data series to the graph.
66
67=cut
68
69sub add_line_data_series {
70 my $self = shift;
71 my $data_ref = shift;
72 my $series_name = shift;
73
74 $self->_add_data_series('line', $data_ref, $series_name);
75
76 return;
77}
78
79=item set_column_padding($int)
80
81Sets the number of pixels that should go between columns of data.
82
83=cut
84
85sub set_column_padding {
86 $_[0]->{'custom_style'}->{'column_padding'} = $_[1];
87}
88
89=item set_negative_background($color)
90
dbc6b6e3 91Sets the background color or fill used below the y axis.
f0b01a81 92
93=cut
94
95sub set_negative_background {
96 $_[0]->{'custom_style'}->{'negative_bg'} = $_[1];
97}
98
99=item draw()
100
101Draw the graph
102
103=cut
104
105sub draw {
106 my ($self, %opts) = @_;
107
108 if (!$self->_valid_input()) {
109 return;
110 }
111
112 $self->_style_setup(\%opts);
113
114 my $style = $self->{_style};
115
56b495c0
TC
116 $self->_make_img
117 or return;
118
f0b01a81 119 my $img = $self->_get_image()
120 or return;
121
122 my @image_box = ( 0, 0, $img->getwidth-1, $img->getheight-1 );
123 $self->_set_image_box(\@image_box);
124
125 my @chart_box = ( 0, 0, $img->getwidth-1, $img->getheight-1 );
126 $self->_draw_legend(\@chart_box);
127 if ($style->{title}{text}) {
128 $self->_draw_title($img, \@chart_box)
129 or return;
130 }
131
132 # Scale the graph box down to the widest graph that can cleanly hold the # of columns.
133 return unless $self->_get_data_range();
86f73dc2 134 $self->_remove_tics_from_chart_box(\@chart_box, \%opts);
f0b01a81 135 my $column_count = $self->_get_column_count();
136
137 my $width = $self->_get_number('width');
138 my $height = $self->_get_number('height');
139
140 my $graph_width = $chart_box[2] - $chart_box[0];
141 my $graph_height = $chart_box[3] - $chart_box[1];
142
95289584 143 my $col_height = ($graph_height - 1) / $column_count;
144 if ($col_height > 1) {
145 $graph_height = int($col_height) * $column_count + 1;
146 }
147 else {
148 $graph_height = $col_height * $column_count + 1;
149 }
f0b01a81 150
151 my $tic_count = $self->_get_x_tics();
152 my $tic_distance = int(($graph_width -1) / ($tic_count - 1));
153 $graph_width = $tic_distance * ($tic_count - 1);
154
86f73dc2 155 my $top = $chart_box[1];
f0b01a81 156 my $left = $chart_box[0];
157
158 $self->{'_style'}{'graph_width'} = $graph_width;
159 $self->{'_style'}{'graph_height'} = $graph_height;
160
86f73dc2
TC
161 my @graph_box = ($left, $top, $left + $graph_width, $top + $graph_height);
162
f0b01a81 163 $self->_set_graph_box(\@graph_box);
164
86f73dc2
TC
165 my @fill_box = @graph_box;
166
167 if ($self->_feature_enabled("graph_outline")) {
168 my @line = $self->_get_line("graph.outline")
169 or return;
170
171 $self->_box(
172 @line,
173 box => \@fill_box,
174 img => $img,
175 );
176 ++$fill_box[0];
177 ++$fill_box[1];
178 --$fill_box[2];
179 --$fill_box[3];
180 }
f0b01a81 181
4cb01c6b
TC
182 {
183 my @back_fill = $self->_get_fill("graph.fill", \@fill_box)
184 or return;
185 $img->box(
186 @back_fill,
187 box => \@fill_box,
188 );
189 }
f0b01a81 190
191 my $min_value = $self->_get_min_value();
192 my $max_value = $self->_get_max_value();
193 my $value_range = $max_value - $min_value;
194
195 my $zero_position;
196 if ($value_range) {
4cb01c6b 197 $zero_position = $left + (-1*$min_value / $value_range) * ($graph_width-1);
f0b01a81 198 }
199
200 if ($min_value < 0) {
4cb01c6b
TC
201 my @neg_box = ( $left+1, $top+1, $zero_position, $top+$graph_height - 1 );
202 my @neg_fill = $self->_get_fill('negative_bg', \@neg_box)
203 or return;
204
f0b01a81 205 $img->box(
4cb01c6b
TC
206 @neg_fill,
207 box => \@neg_box,
f0b01a81 208 );
209 $img->line(
210 x1 => $zero_position,
86f73dc2 211 y1 => $top,
f0b01a81 212 x2 => $zero_position,
86f73dc2 213 y2 => $top + $graph_height,
f0b01a81 214 color => $self->_get_color('outline.line'),
215 );
216 }
217
86f73dc2
TC
218 $self->_reset_series_counter();
219
f0b01a81 220 if ($self->_get_data_series()->{'bar'}) {
221 $self->_draw_bars();
222 }
09bdc58c 223 if ($self->_get_data_series()->{'line'}) {
224 $self->_draw_lines();
225 }
f0b01a81 226
227 if ($self->_get_x_tics()) {
228 $self->_draw_x_tics();
229 }
86f73dc2
TC
230 if ($self->_get_labels(\%opts)) {
231 $self->_draw_y_tics(\%opts);
f0b01a81 232 }
233
234 return $self->_get_image();
235}
236
237sub _get_data_range {
238 my $self = shift;
239
240 my $max_value = 0;
241 my $min_value = 0;
242 my $column_count = 0;
243
244 my ($b_min, $b_max, $b_cols) = $self->_get_bar_range();
09bdc58c 245 my ($l_min, $l_max, $l_cols) = $self->_get_line_range();
f0b01a81 246
09bdc58c 247 $min_value = $self->_min(STARTING_MIN_VALUE, $b_min, $l_min);
248 $max_value = $self->_max(0, $b_max, $l_max);
249 $column_count = $self->_max(0, $b_cols, $l_cols);
267997be 250
251 my $config_min = $self->_get_number('x_min');
252 my $config_max = $self->_get_number('x_max');
253
254 if (defined $config_max && $config_max < $max_value) {
255 $config_max = undef;
256 }
257 if (defined $config_min && $config_min > $min_value) {
258 $config_min = undef;
259 }
260
261 my $range_padding = $self->_get_number('range_padding');
262 if (defined $config_min) {
263 $min_value = $config_min;
264 }
265 else {
266 if ($min_value > 0) {
267 $min_value = 0;
268 }
269 if ($range_padding && $min_value < 0) {
270 my $difference = $min_value * $range_padding / 100;
271 if ($min_value < -1 && $difference > -1) {
272 $difference = -1;
273 }
274 $min_value += $difference;
275 }
276 }
277 if (defined $config_max) {
278 $max_value = $config_max;
279 }
280 else {
281 if ($range_padding && $max_value > 0) {
282 my $difference = $max_value * $range_padding / 100;
283 if ($max_value > 1 && $difference < 1) {
284 $difference = 1;
285 }
286 $max_value += $difference;
287 }
288 }
f0b01a81 289
290 if ($self->_get_number('automatic_axis')) {
291 # In case this was set via a style, and not by the api method
292 eval { require Chart::Math::Axis; };
293 if ($@) {
294 return $self->_error("Can't use automatic_axis - $@");
295 }
296
297 my $axis = Chart::Math::Axis->new();
298 $axis->include_zero();
299 $axis->add_data($min_value, $max_value);
300 $max_value = $axis->top;
301 $min_value = $axis->bottom;
302 my $ticks = $axis->ticks;
303 # The +1 is there because we have the bottom tick as well
304 $self->set_x_tics($ticks+1);
305 }
306
307 $self->_set_max_value($max_value);
308 $self->_set_min_value($min_value);
309 $self->_set_column_count($column_count);
310
311 return 1;
312}
313
314sub _min {
315 my $self = shift;
316 my $min = shift;
317
318 foreach my $value (@_) {
319 next unless defined $value;
320 if ($value < $min) { $min = $value; }
321 }
322 return $min;
323}
324
325sub _max {
326 my $self = shift;
327 my $min = shift;
328
329 foreach my $value (@_) {
330 next unless defined $value;
331 if ($value > $min) { $min = $value; }
332 }
333 return $min;
334}
335
09bdc58c 336sub _get_line_range {
337 my $self = shift;
338 my $series = $self->_get_data_series()->{'line'};
339 return (undef, undef, 0) unless $series;
340
341 my $max_value = 0;
342 my $min_value = STARTING_MIN_VALUE;
343 my $column_count = 0;
344
345 my @series = @{$series};
346 foreach my $series (@series) {
347 my @data = @{$series->{'data'}};
348
349 if (scalar @data > $column_count) {
350 $column_count = scalar @data;
351 }
352
353 foreach my $value (@data) {
354 if ($value > $max_value) { $max_value = $value; }
355 if ($value < $min_value) { $min_value = $value; }
356 }
357 }
358
359 return ($min_value, $max_value, $column_count);
360}
361
362
363
f0b01a81 364sub _get_bar_range {
365 my $self = shift;
366
367 my $series = $self->_get_data_series()->{'bar'};
368 return (undef, undef, 0) unless $series;
369
370 my $max_value = 0;
371 my $min_value = STARTING_MIN_VALUE;
372 my $column_count = 0;
373
374 my @series = @{$series};
375 foreach my $series (@series) {
376 my @data = @{$series->{'data'}};
377
378 foreach my $value (@data) {
379 $column_count++;
380 if ($value > $max_value) { $max_value = $value; }
381 if ($value < $min_value) { $min_value = $value; }
382 }
383 }
384
385 return ($min_value, $max_value, $column_count);
386}
387
388
389sub _draw_legend {
390 my $self = shift;
391 my $chart_box = shift;
392 my $style = $self->{'_style'};
393
394 my @labels;
395 my $img = $self->_get_image();
396 if (my $series = $self->_get_data_series()->{'bar'}) {
397 push @labels, map { $_->{'series_name'} } @$series;
398 }
399
400 if ($style->{features}{legend} && (scalar @labels)) {
401 $self->SUPER::_draw_legend($self->_get_image(), \@labels, $chart_box)
402 or return;
403 }
404 return;
405}
406
407sub _draw_flat_legend {
408 return 1;
409}
410
411sub _draw_lines {
412 my $self = shift;
413 my $style = $self->{'_style'};
414
415 my $img = $self->_get_image();
416
417 my $max_value = $self->_get_max_value();
418 my $min_value = $self->_get_min_value();
419 my $column_count = $self->_get_column_count();
420
421 my $value_range = $max_value - $min_value;
422
423 my $width = $self->_get_number('width');
424 my $height = $self->_get_number('height');
425
426 my $graph_width = $self->_get_number('graph_width');
427 my $graph_height = $self->_get_number('graph_height');
428
429 my $line_series = $self->_get_data_series()->{'line'};
430 my $series_counter = $self->_get_series_counter() || 0;
431
432 my $has_columns = (defined $self->_get_data_series()->{'column'} || $self->_get_data_series->{'stacked_column'}) ? 1 : 0;
433
09bdc58c 434 my $col_height = int($graph_height / $column_count) -1;
f0b01a81 435
436 my $graph_box = $self->_get_graph_box();
437 my $left = $graph_box->[0] + 1;
438 my $bottom = $graph_box->[1];
439
09bdc58c 440 my $zero_position = $left + $graph_width - (-1*$min_value / $value_range) * ($graph_width - 1);
f0b01a81 441
442 my $line_aa = $self->_get_number("lineaa");
443 foreach my $series (@$line_series) {
444 my @data = @{$series->{'data'}};
445 my $data_size = scalar @data;
446
447 my $interval;
448 if ($has_columns) {
09bdc58c 449 $interval = $graph_height / ($data_size);
f0b01a81 450 }
451 else {
09bdc58c 452 $interval = $graph_height / ($data_size - 1);
f0b01a81 453 }
454 my $color = $self->_data_color($series_counter);
455
456 # We need to add these last, otherwise the next line segment will overwrite half of the marker
457 my @marker_positions;
458 for (my $i = 0; $i < $data_size - 1; $i++) {
09bdc58c 459 my $y1 = $bottom + $i * $interval;
460 my $y2 = $bottom + ($i + 1) * $interval;
f0b01a81 461
09bdc58c 462 $y1 += $has_columns * $interval / 2;
463 $y2 += $has_columns * $interval / 2;
f0b01a81 464
09bdc58c 465 my $x1 = $left + ($value_range - $data[$i] + $min_value)/$value_range * $graph_width;
466 my $x2 = $left + ($value_range - $data[$i + 1] + $min_value)/$value_range * $graph_width;
f0b01a81 467
468 push @marker_positions, [$x1, $y1];
469 $img->line(x1 => $x1, y1 => $y1, x2 => $x2, y2 => $y2, aa => $line_aa, color => $color) || die $img->errstr;
470 }
471
f0b01a81 472
09bdc58c 473 my $y2 = $bottom + ($data_size - 1) * $interval;
474 $y2 += $has_columns * $interval / 2;
475
476 my $x2 = $left + ($value_range - $data[$data_size - 1] + $min_value)/$value_range * $graph_width;
f0b01a81 477
0c2d2199
TC
478 if ($self->_feature_enabled("linemarkers")) {
479 push @marker_positions, [$x2, $y2];
480 foreach my $position (@marker_positions) {
481 $self->_draw_line_marker($position->[0], $position->[1], $series_counter);
482 }
f0b01a81 483 }
484 $series_counter++;
485 }
486
487 $self->_set_series_counter($series_counter);
488 return;
489}
490
f0b01a81 491sub _draw_bars {
492 my $self = shift;
493 my $style = $self->{'_style'};
494
495 my $img = $self->_get_image();
496
497 my $max_value = $self->_get_max_value();
498 my $min_value = $self->_get_min_value();
499 my $column_count = $self->_get_column_count();
500
501 my $value_range = $max_value - $min_value;
502
503 my $width = $self->_get_number('width');
504 my $height = $self->_get_number('height');
505
506 my $graph_width = $self->_get_number('graph_width');
507 my $graph_height = $self->_get_number('graph_height');
508
509
510 my $graph_box = $self->_get_graph_box();
511 my $bottom = $graph_box->[1] + 1;
512 my $left = $graph_box->[0];
513
514 my $zero_position = int($left + (-1*$min_value / $value_range) * ($graph_width-1));
515
95289584 516 my $bar_height = $graph_height / $column_count;
f0b01a81 517
518 my $outline_color;
519 if ($style->{'features'}{'outline'}) {
520 $outline_color = $self->_get_color('outline.line');
521 }
522
523 my $series_counter = $self->_get_series_counter() || 0;
524 my $col_series = $self->_get_data_series()->{'bar'};
525 my $column_padding = $self->_get_number('column_padding') || 0;
526
527 # 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.
528 my $column_series = 0;
529
530 for (my $series_pos = 0; $series_pos < scalar @$col_series; $series_pos++) {
531 my $series = $col_series->[$series_pos];
532 my @data = @{$series->{'data'}};
533 my $data_size = scalar @data;
f0b01a81 534 for (my $i = 0; $i < $data_size; $i++) {
535
95289584 536 my $part1 = $bar_height * (scalar @$col_series * $i);
537 my $part2 = ($series_pos) * $bar_height;
538 my $y1 = int($bottom + $part1 + $part2);
f0b01a81 539
95289584 540 my $y2 = int($y1 + $bar_height - $column_padding)-1;
541 # Special case for when bar_height is less than 1.
542 if ($y2 < $y1) {
543 $y2 = $y1;
544 }
f0b01a81 545
546 my $x1 = int($left - ($min_value - $data[$i]) / $value_range * $graph_width);
547
548 my $color = $self->_data_color($series_counter);
549
f0b01a81 550 if ($data[$i] > 0) {
7422650e 551 my @fill = $self->_data_fill($series_counter, [$zero_position+1, $y1, $x1, $y2]);
552 $img->box(xmax => $x1, xmin => $zero_position+1, ymin => $y1, ymax => $y2, @fill);
f0b01a81 553 if ($style->{'features'}{'outline'}) {
554 $img->box(xmax => $x1, xmin => $zero_position, ymin => $y1, ymax => $y2, color => $outline_color);
555 }
556 }
557 elsif ($data[$i] == 0) {
558 }
559 else {
7422650e 560 my @fill = $self->_data_fill($series_counter, [$x1, $y1, $zero_position, $y2]);
561 $img->box(xmax => $zero_position , xmin => $x1, ymin => $y1, ymax => $y2, @fill);
f0b01a81 562 if ($style->{'features'}{'outline'}) {
563 $img->box(xmax => $zero_position, xmin => $x1, ymin => $y1, ymax => $y2, color => $outline_color);
564 }
565 }
566 }
567
568 $series_counter++;
569 $column_series++;
570 }
571 $self->_set_series_counter($series_counter);
572 return;
573}
574
575sub _add_data_series {
576 my $self = shift;
577 my $series_type = shift;
578 my $data_ref = shift;
579 my $series_name = shift;
580
581 my $graph_data = $self->{'graph_data'} || {};
582
583 my $series = $graph_data->{$series_type} || [];
584
585 push @$series, { data => $data_ref, series_name => $series_name };
586
587 $graph_data->{$series_type} = $series;
588
589 $self->{'graph_data'} = $graph_data;
590 return;
591}
592
f0b01a81 593=item show_vertical_gridlines()
594
595Shows vertical gridlines at the y-tics.
596
86f73dc2
TC
597Feature: vertical_gridlines
598
f0b01a81 599=cut
600
601sub show_vertical_gridlines {
56b495c0 602 $_[0]->{'custom_style'}{features}{'vertical_gridlines'} = 1;
f0b01a81 603}
604
86f73dc2
TC
605=item set_vertical_gridline_style(color => ..., style => ...)
606
607Set the color and style of the lines drawn for gridlines.
608
609Style equivalent: vgrid
610
611=cut
612
613sub set_vertical_gridline_style {
614 my ($self, %opts) = @_;
615
616 $self->{custom_style}{vgrid} ||= {};
617 @{$self->{custom_style}{vgrid}}{keys %opts} = values %opts;
618
619 return 1;
620}
621
0c2d2199
TC
622=item show_line_markers()
623
624=item show_line_markers($value)
625
626Feature: linemarkers.
627
628If $value is missing or true, draw markers on a line data series.
629
630Note: line markers are drawn by default.
631
632=cut
633
634sub show_line_markers {
635 my ($self, $value) = @_;
636
637 @_ > 1 or $value = 1;
638
639 $self->{custom_style}{features}{linemarkers} = $value;
640
641 return 1;
642}
643
f0b01a81 644=item use_automatic_axis()
645
646Automatically 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.
647
648=cut
649
650sub use_automatic_axis {
651 eval { require Chart::Math::Axis; };
652 if ($@) {
653 return $_[0]->_error("use_automatic_axis - $@\nCalled from ".join(' ', caller)."\n");
654 }
655 $_[0]->{'custom_style'}->{'automatic_axis'} = 1;
656 return 1;
657}
658
659
660=item set_x_tics($count)
661
662Set the number of X tics to use. Their value and position will be determined by the data range.
663
664=cut
665
666sub set_x_tics {
667 $_[0]->{'x_tics'} = $_[1];
668}
669
670sub _get_x_tics {
671 return $_[0]->{'x_tics'} || 0;
672}
673
674sub _remove_tics_from_chart_box {
86f73dc2 675 my ($self, $chart_box, $opts) = @_;
f0b01a81 676
677 # XXX - bad default
86f73dc2 678 my $tic_width = $self->_get_y_tic_width($opts) || 10;
f0b01a81 679 my @y_tic_box = ($chart_box->[0], $chart_box->[1], $chart_box->[0] + $tic_width, $chart_box->[3]);
680
681 # XXX - bad default
682 my $tic_height = $self->_get_x_tic_height() || 10;
683 my @x_tic_box = ($chart_box->[0], $chart_box->[3] - $tic_height, $chart_box->[2], $chart_box->[3]);
684
685 $self->_remove_box($chart_box, \@y_tic_box);
686 $self->_remove_box($chart_box, \@x_tic_box);
687
688 # If there's no title, the y-tics will be part off-screen. Half of the x-tic height should be more than sufficient.
689 my @y_tic_tops = ($chart_box->[0], $chart_box->[1], $chart_box->[2], $chart_box->[1] + int($tic_height / 2));
690 $self->_remove_box($chart_box, \@y_tic_tops);
691
267997be 692 if (my @box = $self->_text_bbox($self->_get_max_value(), 'legend')) {
693 my @remove_box = ($chart_box->[2] - int($box[2] / 2) - 1,
694 $chart_box->[1],
695 $chart_box->[2],
696 $chart_box->[3]
697 );
698
699 $self->_remove_box($chart_box, \@remove_box);
700 }
701
702
f0b01a81 703}
704
705sub _get_y_tic_width {
86f73dc2 706 my ($self, $opts) = @_;
f0b01a81 707
86f73dc2 708 my $labels = $self->_get_labels($opts);
43c5d51b 709
710 if (!$labels) {
711 return;
712 }
713
714 my %text_info = $self->_text_style('legend')
715 or return;
716
f0b01a81 717 my $max_width = 0;
718 foreach my $label (@$labels) {
719 my @box = $self->_text_bbox($label, 'legend');
720 my $width = $box[2] + 5;
721 # For the tic itself...
722 $width += 10;
723 if ($width > $max_width) {
724 $max_width = $width;
725 }
726 }
727 return $max_width;
728}
729
730sub _get_x_tic_height {
731 my $self = shift;
732
733 my $min = $self->_get_min_value();
734 my $max = $self->_get_max_value();
735 my $tic_count = $self->_get_x_tics();
736
737 my $interval = ($max - $min) / ($tic_count - 1);
738
739 my %text_info = $self->_text_style('legend')
740 or return;
741
742 my $max_height = 0;
743 for my $count (0 .. $tic_count - 1) {
744 my $value = sprintf("%.2f", ($count*$interval)+$min);
745
746 my @box = $self->_text_bbox($value, 'legend');
747 my $height = $box[3] - $box[1];
748
749 # For the tic width
750 $height += 10;
751 if ($height > $max_height) {
752 $max_height = $height;
753 }
754 }
755
756
757 return $max_height;
758}
759
760sub _draw_y_tics {
86f73dc2 761 my ($self, $opts) = @_;
f0b01a81 762
763 my $img = $self->_get_image();
764 my $graph_box = $self->_get_graph_box();
765 my $image_box = $self->_get_image_box();
766
86f73dc2 767 my $labels = $self->_get_labels($opts);
f0b01a81 768
769 my $tic_count = (scalar @$labels) - 1;
770
771 my $has_columns = defined $self->_get_data_series()->{'bar'};
772
773 # If we have columns, we want the x-ticks to show up in the middle of the column, not on the left edge
774 my $denominator = $tic_count;
775 if ($has_columns) {
776 $denominator ++;
777 }
778 my $tic_distance = ($graph_box->[3] - $graph_box->[1]) / ($denominator);
779 my %text_info = $self->_text_style('legend')
780 or return;
781
782 for my $count (0 .. $tic_count) {
783 my $label = $labels->[$count];
784
785 my $x1 = $graph_box->[0] - 5;
786 my $x2 = $graph_box->[0] + 5;
787
788 my $y1 = $graph_box->[1] + ($tic_distance * $count);
789
790 if ($has_columns) {
791 $y1 += $tic_distance / 2;
792 }
793
794 $img->line(x1 => $x1, x2 => $x2, y1 => $y1, y2 => $y1, aa => 1, color => '000000');
795
796 my @box = $self->_text_bbox($label, 'legend')
797 or return;
798
799 my $width = $box[2];
800 my $height = $box[3];
801
802 $img->string(%text_info,
803 x => ($x1 - ($width + 5)),
804 y => ($y1 + ($height / 2)),
805 text => $label
806 );
807
808 }
809
810}
811
812sub _draw_x_tics {
813 my $self = shift;
814
815 my $img = $self->_get_image();
816 my $graph_box = $self->_get_graph_box();
817 my $image_box = $self->_get_image_box();
818
819 my $tic_count = $self->_get_x_tics();
820 my $min = $self->_get_min_value();
821 my $max = $self->_get_max_value();
822 my $interval = ($max - $min) / ($tic_count - 1);
823
824 # If we have columns, we want the x-ticks to show up in the middle of the column, not on the left edge
825 my $tic_distance = ($graph_box->[2] - $graph_box->[0]) / ($tic_count -1);
826
827 my %text_info = $self->_text_style('legend')
828 or return;
829
56b495c0
TC
830 my $show_gridlines = $self->{_style}{features}{'vertical_gridlines'};
831 my @grid_line = $self->_get_line("vgrid");
f0b01a81 832 for my $count (0 .. $tic_count-1) {
833 my $x1 = $graph_box->[0] + ($tic_distance * $count);
834
835 my $y1 = $graph_box->[3] + 5;
836 my $y2 = $graph_box->[3] - 5;
837
838 my $value = ($count*$interval)+$min;
839
840 $img->line(x1 => $x1, x2 => $x1, y1 => $y1, y2 => $y2, aa => 1, color => '000000');
841
842 my @box = $self->_text_bbox($value, 'legend')
843 or return;
844
845 my $width = $box[2];
846 my $height = $box[3];
847
848 $img->string(%text_info,
849 x => ($x1 - ($width / 2)),
850 y => ($y1 + $height + 5),
851 text => $value
852 );
853
56b495c0
TC
854 if ($show_gridlines && $x1 != $graph_box->[0] && $x1 != $graph_box->[2]) {
855 $self->_line(x1 => $x1, x2 => $x1,
86f73dc2 856 y1 => $graph_box->[1], y2 => $graph_box->[3],
56b495c0
TC
857 img => $img,
858 @grid_line);
f0b01a81 859 }
860 }
861}
862
863sub _valid_input {
864 my $self = shift;
865
866 if (!defined $self->_get_data_series() || !keys %{$self->_get_data_series()}) {
867 return $self->_error("No data supplied");
868 }
869
870 my $data = $self->_get_data_series();
871 if (defined $data->{'line'} && !scalar @{$data->{'line'}->[0]->{'data'}}) {
872 return $self->_error("No values in data series");
873 }
874 if (defined $data->{'column'} && !scalar @{$data->{'column'}->[0]->{'data'}}) {
875 return $self->_error("No values in data series");
876 }
877 if (defined $data->{'stacked_column'} && !scalar @{$data->{'stacked_column'}->[0]->{'data'}}) {
878 return $self->_error("No values in data series");
879 }
880
881 return 1;
882}
883
884sub _set_column_count { $_[0]->{'column_count'} = $_[1]; }
885sub _set_min_value { $_[0]->{'min_value'} = $_[1]; }
886sub _set_max_value { $_[0]->{'max_value'} = $_[1]; }
887sub _set_image_box { $_[0]->{'image_box'} = $_[1]; }
888sub _set_graph_box { $_[0]->{'graph_box'} = $_[1]; }
889sub _set_series_counter { $_[0]->{'series_counter'} = $_[1]; }
890sub _get_column_count { return $_[0]->{'column_count'} }
891sub _get_min_value { return $_[0]->{'min_value'} }
892sub _get_max_value { return $_[0]->{'max_value'} }
893sub _get_image_box { return $_[0]->{'image_box'} }
894sub _get_graph_box { return $_[0]->{'graph_box'} }
86f73dc2 895sub _reset_series_counter { $_[0]->{series_counter} = 0 }
f0b01a81 896sub _get_series_counter { return $_[0]->{'series_counter'} }
897
86f73dc2
TC
898sub _style_defs {
899 my ($self) = @_;
900
901 my %work = %{$self->SUPER::_style_defs()};
0c2d2199 902 push @{$work{features}}, qw/graph_outline graph_fill linemarkers/;
86f73dc2
TC
903 $work{vgrid} =
904 {
905 color => "lookup(fg)",
906 style => "solid",
907 };
908
909 return \%work;
910}
911
56b495c0
TC
912sub _composite {
913 my ($self) = @_;
914 return ( $self->SUPER::_composite(), "graph", "vgrid" );
915}
916
f0b01a81 9171;
918
64403ed0 919=back
0625a02f
TC
920
921=head1 AUTHOR
922
923Patrick Michaud, Tony Cook
924
925=cut