.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "GD::Graph3d 3pm"
.TH GD::Graph3d 3pm 2024-03-06 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
GD::Graph3D \- Create 3D Graphs with GD and GD::Graph
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 12
\&        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           => \*(AqDay of the week\*(Aq,
\&                y_label           => \*(AqNumber of hits\*(Aq,
\&                title             => \*(AqDaily Summary of Web Site\*(Aq,
\&        );
\&        my $gd = $graph\->plot( \e@data );
.Ve
.PP
Where \fImoduleName\fR is one of \f(CW\*(C`bars3d\*(C'\fR, \f(CW\*(C`lines3d\*(C'\fR or \f(CW\*(C`pie3d\*(C'\fR.
.SH DESCRIPTION
.IX Header "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.
.PP
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.
.IP GD::Graph::pie3d 4
.IX Item "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.
.IP GD::Graph::bars3d 4
.IX Item "GD::Graph::bars3d"
This works like GD::Graph::bars, but draws 3d bars. The following settings 
are new or changed in GD::Graph::bars3d.
.RS 4
.IP bar_depth 4
.IX Item "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.
.IP overwrite 4
.IX Item "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.
.IP shading 4
.IX Item "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.
.RE
.RS 4
.RE
.IP GD::Graph::lines3d 4
.IX Item "GD::Graph::lines3d"
This works like GD::Graph::lines, but draws 3d line. The following settings 
are new or changed in GD::Graph::line3d.
.RS 4
.IP line_depth 4
.IX Item "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.
.IP shading 4
.IX Item "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.
.RE
.RS 4
.RE
.SH VERSION
.IX Header "VERSION"
0.63 (6 December 2002)
.SH INSTALLATION
.IX Header "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.
.PP
To install, just do the normal:
.PP
.Vb 3
\&        perl Makefile.PL
\&        make
\&        make install
.Ve
.PP
The documentation is in GD::Graph::Graph3d.pod.
.SH AUTHOR
.IX Header "AUTHOR"
Jeremy Wadsack for Wadsack-Allen Digital Group. 
<\fIdgsupport at wadsack-allen dot com\fR>
.PP
Most of the modules are based on the GD::Graph modules by Martien Verbruggen.
.SH "LATEST RELEASE"
.IX Header "LATEST RELEASE"
The latest release is available from CPAN: http://www.cpan.org/.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (c) 1999\-2001 Wadsack-Allen. All rights reserved.
.PP
Much of the original code is from GD::Graph:
.PP
GIFgraph: Copyright (c) 1995\-1999 Martien Verbruggen.
.PP
Chart::PNGgraph: Copyright (c) 1999 Steve Bonds.
.PP
GD::Graph: Copyright (c) 1999 Martien Verbruggen.
.PP
This package is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.