.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Template::Plugin::GD::Graph::bars 3"
.TH Template::Plugin::GD::Graph::bars 3 2024-07-13 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Template::Plugin::GD::Graph::bars \- Create bar graphs with axes and legends
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&    [% USE g = GD.Graph.bars(x_size, y_size); %]
.Ve
.SH EXAMPLES
.IX Header "EXAMPLES"
.Vb 5
\&    [% FILTER null;
\&        data = [  
\&            ["1st","2nd","3rd","4th","5th","6th","7th", "8th", "9th"],
\&            [    1,    2,    5,    6,    3,  1.5,    1,     3,     4],
\&        ];
\&        
\&        USE my_graph = GD.Graph.bars();
\&        
\&        my_graph.set(
\&            x_label         => \*(AqX Label\*(Aq,
\&            y_label         => \*(AqY label\*(Aq,
\&            title           => \*(AqA Simple Bar Chart\*(Aq,
\&            y_max_value     => 8,
\&            y_tick_number   => 8, 
\&            y_label_skip    => 2,
\&
\&            # shadows
\&            bar_spacing     => 8,
\&            shadow_depth    => 4, 
\&            shadowclr       => \*(Aqdred\*(Aq,
\&
\&            transparent     => 0,
\&        );      
\&        my_graph.plot(data).png | stdout(1);
\&       END;
\&    \-%]
\&
\&    [% FILTER null;
\&        data = [
\&            ["1st","2nd","3rd","4th","5th","6th","7th", "8th", "9th"],
\&            [    5,   12,   24,   33,   19,    8,    6,    15,    21],
\&            [    1,    2,    5,    6,    3,  1.5,    1,     3,     4],
\&        ];      
\&        
\&        USE my_graph = GD.Graph.bars();
\&
\&        my_graph.set(
\&            x_label         => \*(AqX Label\*(Aq,
\&            y_label         => \*(AqY label\*(Aq,
\&            title           => \*(AqTwo data sets\*(Aq,
\&        
\&            # shadows
\&            bar_spacing     => 8,
\&            shadow_depth    => 4,
\&            shadowclr       => \*(Aqdred\*(Aq,
\&
\&            long_ticks      => 1,
\&            y_max_value     => 40,
\&            y_tick_number   => 8,
\&            y_label_skip    => 2,
\&            bar_spacing     => 3,
\&
\&            accent_treshold => 200,
\&
\&            transparent     => 0,
\&        );
\&        my_graph.set_legend( \*(AqData set 1\*(Aq, \*(AqData set 2\*(Aq );
\&        my_graph.plot(data).png | stdout(1);
\&       END;
\&    \-%]
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The GD.Graph.bars plugin provides an interface to the GD::Graph::bars
class defined by the GD::Graph module. It allows one or more (x,y) data
sets to be plotted with each point represented by a bar, in addition
to axes and legends.
.PP
See GD::Graph for more details.
.SH AUTHOR
.IX Header "AUTHOR"
Thomas Boutell wrote the GD graphics library.
.PP
Lincoln D. Stein wrote the Perl GD modules that interface to it.
.PP
Martien Verbruggen wrote the GD::Graph module.
.PP
Craig Barratt <craig@arraycomm.com> wrote the original GD
plugins for the Template Toolkit (2001).
.PP
Andy Wardley <abw@cpan.org> extracted them from the TT core
into a separate distribution for TT version 2.15.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2001 Craig Barratt <craig@arraycomm.com>, 
2006 Andy Wardley <abw@cpan.org>.
.PP
GD::Graph is copyright 1999 Martien Verbruggen.
.PP
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Template::Plugin::GD, Template::Plugin::GD::Graph::lines, Template::Plugin::GD::Graph::lines3d, Template::Plugin::GD::Graph::bars3d, Template::Plugin::GD::Graph::points, Template::Plugin::GD::Graph::linespoints, Template::Plugin::GD::Graph::area, Template::Plugin::GD::Graph::mixed, Template::Plugin::GD::Graph::pie, Template::Plugin::GD::Graph::pie3d, GD