NAME

Template::Plugin::GD::Graph::bars - Create bar graphs with axes and legends

SYNOPSIS

    [% USE g = GD.Graph.bars(x_size, y_size); %]

EXAMPLES

    [% 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         => 'X Label',
            y_label         => 'Y label',
            title           => 'A Simple Bar Chart',
            y_max_value     => 8,
            y_tick_number   => 8, 
            y_label_skip    => 2,
            # shadows
            bar_spacing     => 8,
            shadow_depth    => 4, 
            shadowclr       => 'dred',
            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         => 'X Label',
            y_label         => 'Y label',
            title           => 'Two data sets',
        
            # shadows
            bar_spacing     => 8,
            shadow_depth    => 4,
            shadowclr       => 'dred',
            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( 'Data set 1', 'Data set 2' );
        my_graph.plot(data).png | stdout(1);
       END;
    -%]

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.

See GD::Graph for more details.

AUTHOR

Thomas Boutell wrote the GD graphics library.

Lincoln D. Stein wrote the Perl GD modules that interface to it.

Martien Verbruggen wrote the GD::Graph module.

Craig Barratt <craig@arraycomm.com> wrote the original GD plugins for the Template Toolkit (2001).

Andy Wardley <abw@cpan.org> extracted them from the TT core into a separate distribution for TT version 2.15.

COPYRIGHT