phpman > perldoc > GD::Graph3d(3pm)

NAME
    GD::Graph3D - Create 3D Graphs with GD and GD::Graph

SYNOPSIS
            use GD::Graph::moduleName;
            my @data = (
               ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
               [ 1203,  3500,  3973,  2859,  3012,  3423,  1230]
            );
            my $graph = new GD::Graph::moduleName( 400, 300 );
            $graph->set(
                    x_label           => 'Day of the week',
                    y_label           => 'Number of hits',
                    title             => 'Daily Summary of Web Site',
            );
            my $gd = $graph->plot( \@data );

    Where *moduleName* is one of "bars3d", "lines3d" or "pie3d".

DESCRIPTION
    This is the GD::Graph3d extensions module. It provides 3D graphs for the GD::Graph module by
    Martien Verbruggen, which in turn generates graph using Lincoln Stein's GD.pm.

    You use these modules just as you would any of the GD::Graph modules, except that they generate
    3d-looking graphs. Each graph type is described below with only the options that are unique to
    the 3d version. The modules are based on their 2d versions (e.g. GD::Graph::bars3d works like
    GD::Graph::bars), and support all the options in those. Make sure to read the documentation on
    GD::Graph.

    GD::Graph::pie3d
        This is merely a wrapper around GD::Graph::pie for consistency. It also sets 3d pie mode by
        default (which GD::Graph does as of version 1.22). All options are exactly as in
        GD::Graph::pie.

    GD::Graph::bars3d
        This works like GD::Graph::bars, but draws 3d bars. The following settings are new or
        changed in GD::Graph::bars3d.

        bar_depth
            Sets the z-direction depth of the bars. This defaults to 10. If you have a large number
            of bars or a small chart width, you may want to change this. A visually good value for
            this is approximately width_of_chart / number_of_bars.

        overwrite
            In GD::Graph::bars, multiple series of bars are normally drawn side-by-side. You can set
            overwrite to 1 to tell it to draw each series behind the previous one. By setting
            overwrite to 2 you can have them drawn on top of each other, that is the series are
            stacked.

        shading
            By default this is set to '1' and will shade and highlight the bars (and axes). The
            light source is at top-left-center which scan well for most computer users. You can
            disable the shading of bars and axes by specifying a false value for this option.

    GD::Graph::lines3d
        This works like GD::Graph::lines, but draws 3d line. The following settings are new or
        changed in GD::Graph::line3d.

        line_depth
            Sets the z-direction depth of the lines. This defaults to 10. If you have a large number
            of bars or a small chart width, you may want to change this. A visually good value for
            this is approximately width_of_chart / number_of_bars.

        shading
            By default this is set to '1' and will shade and highlight the line (and axes). The
            light source is at top-left-center which scan well for most computer users. You can
            disable the shading of lines and axes by specifiying a false value for this option.

VERSION
    0.63 (6 December 2002)

INSTALLATION
    You will need to have the GD::Graph version 1.30 or later installed. You should also have Perl
    version 5.005 or 5.6 installed.

    To install, just do the normal:

            perl Makefile.PL
            make
            make install

    The documentation is in GD::Graph::Graph3d.pod.

AUTHOR
    Jeremy Wadsack for Wadsack-Allen Digital Group. <dgsupport at wadsack-allen dot com>

    Most of the modules are based on the GD::Graph modules by Martien Verbruggen.

LATEST RELEASE
    The latest release is available from CPAN: http://www.cpan.org/.

COPYRIGHT
    Copyright (c) 1999-2001 Wadsack-Allen. All rights reserved.

    Much of the original code is from GD::Graph:

    GIFgraph: Copyright (c) 1995-1999 Martien Verbruggen.

    Chart::PNGgraph: Copyright (c) 1999 Steve Bonds.

    GD::Graph: Copyright (c) 1999 Martien Verbruggen.

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