GD::Graph3d(3) User Contributed Perl Documentation GD::Graph3d(3)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.
trim_miter
By default this is set to '0'. If line_width is large, typical
zig-zag data lines may appear to exaggerated, due to the width
of the lines. When trim_miter is set to '1', then acute-angled
segments are cut back (with an additional small rectangle on
top) to extend only half a line_width beyond the data points.
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.
perl v5.18.1 2013-09-28 GD::Graph3d(3)
