NAME

Template::Plugin::GD::Graph::bars3d - Create 3D bar graphs with axes and legends

SYNOPSIS

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

EXAMPLES

[% FILTER null;
    data = [
        ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug",
                                     "Sep", "Oct", "Nov", "Dec", ],
        [-5, -4, -3, -3, -1,  0,  2,  1,  3,  4,  6,  7],
        [4,   3,  5,  6,  3,1.5, -1, -3, -4, -6, -7, -8],
        [1,   2,  2,  3,  4,  3,  1, -1,  0,  2,  3,  2],
    ];
    
    USE my_graph = GD.Graph.bars3d();
    
    my_graph.set( 
            x_label => 'Month',
            y_label => 'Measure of success',
            title => 'A 3d Bar Chart',

            y_max_value => 8,
            y_min_value => -8,
            y_tick_number => 16,
            y_label_skip => 2,
            box_axis => 0,
            line_width => 3,
            zero_axis_only => 1,
            x_label_position => 1,  
            y_label_position => 1,  
    
            x_label_skip => 3,
            x_tick_offset => 2,
    
            transparent => 0,
    );      
    my_graph.set_legend("Us", "Them", "Others");
    my_graph.plot(data).png | stdout(1);
   END;
-%]

DESCRIPTION

The GD.Graph.bars3d plugin provides an interface to the GD::Graph::bars3d class defined by the GD::Graph3d module. It allows one or more (x,y) data sets to be plotted as y versus x bars with a 3-dimensional appearance, together with axes and legends.

See GD::Graph3d 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

Copyright (C) 2001 Craig Barratt <craig@arraycomm.com>, 2006 Andy Wardley <abw@cpan.org>.

GD::Graph3d is copyright (C) 1999,2000 Wadsack-Allen. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Template::Plugin::GD, Template::Plugin::GD::Graph::lines, Template::Plugin::GD::Graph::lines3d, Template::Plugin::GD::Graph::bars, 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