1GD::Graph3d(3)        User Contributed Perl Documentation       GD::Graph3d(3)
2
3
4

NAME

6       GD::Graph3D - Create 3D Graphs with GD and GD::Graph
7

SYNOPSIS

9               use GD::Graph::moduleName;
10               my @data = (
11                  ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
12                  [ 1203,  3500,  3973,  2859,  3012,  3423,  1230]
13               );
14               my $graph = new GD::Graph::moduleName( 400, 300 );
15               $graph->set(
16                       x_label           => 'Day of the week',
17                       y_label           => 'Number of hits',
18                       title             => 'Daily Summary of Web Site',
19               );
20               my $gd = $graph->plot( \@data );
21
22       Where moduleName is one of "bars3d", "lines3d" or "pie3d".
23

DESCRIPTION

25       This is the GD::Graph3d extensions module. It provides 3D graphs for
26       the GD::Graph module by Martien Verbruggen, which in turn generates
27       graph using Lincoln Stein's GD.pm.
28
29       You use these modules just as you would any of the GD::Graph modules,
30       except that they generate 3d-looking graphs. Each graph type is
31       described below with only the options that are unique to the 3d ver‐
32       sion. The modules are based on their 2d versions (e.g.
33       GD::Graph::bars3d works like GD::Graph::bars), and support all the
34       options in those. Make sure to read the documentation on GD::Graph.
35
36       GD::Graph::pie3d
37           This is merely a wrapper around GD::Graph::pie for consistency. It
38           also sets 3d pie mode by default (which GD::Graph does as of ver‐
39           sion 1.22).  All options are exactly as in GD::Graph::pie.
40
41       GD::Graph::bars3d
42           This works like GD::Graph::bars, but draws 3d bars. The following
43           settings are new or changed in GD::Graph::bars3d.
44
45           bar_depth
46               Sets the z-direction depth of the bars. This defaults to 10. If
47               you have a large number of bars or a small chart width, you may
48               want to change this.  A visually good value for this is approx‐
49               imately width_of_chart / number_of_bars.
50
51           overwrite
52               In GD::Graph::bars, multiple series of bars are normally drawn
53               side-by-side.  You can set overwrite to 1 to tell it to draw
54               each series behind the previous one. By setting overwrite to 2
55               you can have them drawn on top of each other, that is the
56               series are stacked.
57
58           shading
59               By default this is set to '1' and will shade and highlight the
60               bars (and axes).  The light source is at top-left-center which
61               scan well for most computer users. You can disable the shading
62               of bars and axes by specifying a false value for this option.
63
64       GD::Graph::lines3d
65           This works like GD::Graph::lines, but draws 3d line. The following
66           settings are new or changed in GD::Graph::line3d.
67
68           line_depth
69               Sets the z-direction depth of the lines. This defaults to 10.
70               If you have a large number of bars or a small chart width, you
71               may want to change this.  A visually good value for this is
72               approximately width_of_chart / number_of_bars.
73
74           shading
75               By default this is set to '1' and will shade and highlight the
76               line (and axes).  The light source is at top-left-center which
77               scan well for most computer users. You can disable the shading
78               of lines and axes by specifiying a false value for this option.
79

VERSION

81       0.63 (6 December 2002)
82

INSTALLATION

84       You will need to have the GD::Graph version 1.30 or later installed.
85       You should also have Perl version 5.005 or 5.6 installed.
86
87       To install, just do the normal:
88
89               perl Makefile.PL
90               make
91               make install
92
93       The documentation is in GD::Graph::Graph3d.pod.
94

AUTHOR

96       Jeremy Wadsack for Wadsack-Allen Digital Group.  <dgsupport at wadsack-
97       allen dot com>
98
99       Most of the modules are based on the GD::Graph modules by Martien Ver‐
100       bruggen.
101

LATEST RELEASE

103       The latest release is available from CPAN: http://www.cpan.org/.
104
106       Copyright (c) 1999-2001 Wadsack-Allen. All rights reserved.
107
108       Much of the original code is from GD::Graph:
109
110       GIFgraph: Copyright (c) 1995-1999 Martien Verbruggen.
111
112       Chart::PNGgraph: Copyright (c) 1999 Steve Bonds.
113
114       GD::Graph: Copyright (c) 1999 Martien Verbruggen.
115
116       This package is free software; you can redistribute it and/or modify it
117       under the same terms as Perl itself.
118
119
120
121perl v5.8.8                       2002-12-06                    GD::Graph3d(3)
Impressum