Templat...ph::bars(3)

💅 Template::Plugin::GD::Graph::bars(3) — the perl manpage, but make it cute

okay so bestie, you know the Template::Plugin::GD::Graph::bars page from User Contributed Perl Documentation? yeah. that one. let me tell you everything about it ✨

---

🌸 NAME 🌸

Template::Plugin::GD::Graph::bars — literally makes bar graphs. with axes. with legends. the whole package 🎀

---

✨ SYNOPSIS ✨

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

that's it. that's the whole vibe check. 💅

---

🦋 EXAMPLES 🦋

okay so example number one, a simple bar chart, no cap:

[% 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;
-%]

and example number two, two data sets, we love a legend moment 👑

[% 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;
-%]

(and yes, accent_treshold is spelled exactly like that in the original — don't come for me, I don't make the rules 🙈)

---

💖 DESCRIPTION 💖

so the GD.Graph.bars plugin is basically a little bridge — it gives you an interface to the GD::Graph::bars class that lives inside the GD::Graph module. iconic behavior, honestly.

what does it do? it lets you plot one or more (x,y) data sets, where every single point is represented by a bar. plus axes. plus legends. it's giving full presentation package. 🔥

want more details? go read GD::Graph, they said it better, iykyk.

---

👑 AUTHOR 👑

credit where credit is due, bestie, these are the legends:

• 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::Graph is copyright 1999 Martien Verbruggen.

this module is free software, fr fr — you can redistribute it and/or modify it under the same terms as Perl itself. slay. 💅

---

🌈 SEE ALSO 🌈

go look at these, they're all part of the family:

• 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

---

and that's the whole page, bestie! 🫶 this was perl v5.42.0, dated 2017-10-08, from the Templat...ph::bars(3) manpage. mwah. go make some bars. 💜