README
1GD/SVG version 0.24
2===================
3
4GD::SVG seamlessly enables the scalable vector graphics (SVG) output
5from scripts written using GD. It accomplishes this by translating GD
6functions into SVG functions.
7
8IMPORTANT NOTES
9
101. In addition to GD::SVG, Ronan Oger has created a similar module
11(SVG::GD). In principle these modules perform a similar function but
12go about it in slightly different ways. Ronan and I are now
13concurrently developing these modules which may be merged in the
14future. In particular, Ronan's module ultimately aims to tap into the
15raster editing abilities of GD. GD::SVG focuses primarily on
16generating SVG-output from scripts written with GD - focusing on
17generating images de novo from stacks of data.
18
192. See the internal documentation on important notes on how to use
20GD::SVG.
21
22QUICKSTART USAGE GUIDE
23
24To enable SVG output, you must change several elements of your
25script. This includes the use statement and direct calls to the
26classes that GD implements.
27
28In short:
29
30 # use GD;
31 use GD::SVG;
32
33 # my $image = GD::Image->new($width,$height);
34 my $image = GD::SVG::Image->new($width,$height);
35
36 ...
37
38 print $image->svg();
39
40See the full documentation for examples on enabling dynamic selection
41of image output.
42
43INSTALLATION
44
45To install this module type the following:
46
47 perl Makefile.PL
48 make
49 make test
50 sudo make install
51
52You may need to be root (or sudo) to executre the make install
53command.
54
55DEPENDENCIES
56
57This module requires these other modules and libraries:
58
59 GD, SVG
60
61ACKNOWLEDGEMENTS
62
63Lincoln Stein, creator of GD and my postdoctoral mentor, desires
64special credit. Ronan Oger, creator of the SVG module and co-creator
65of a similar GD-wrapper, has been very helpful with discussions about
66interfacing GD to SVG.
67
68Patches: srezic (color comparisons), jettero (fixed linecaps).
69
70COPYRIGHT AND LICENCE
71
72Copyright (C) 2003-2008 Todd Harris (harris@cshl.edu) and the Cold Spring
73Harbor Laboratory
74
75This library is free software; you can redistribute it and/or modify
76it under the same terms as Perl itself.
77
78