SVG.pm version 2.1 28.05.02 SVG.pm is a perl extention to generate stand-alone or inline SVG (scaleable vector graphics) images using the W3C SVG xml recommendation. Refer to the pod for full documentation and an example script, or to http://roasp.com/man/SVG.html The complete pod resides in SVG::Manual type perldoc SVG::Manual on the command line (c) 2001,2002 Ronan Oger, RO IT Systems, GmbH homepage: http://www.roitsystems.com ronan@roasp.com ronan@cpan.org This software is provided as is and without warranty. It is freely distributed under the general perl license. OVERVIEW -------- SVG.pm makes it possible to generate fully-functional SVG images in perl. 100% of the SVG tags are supported. VERSION ------- V.2.1 (28.05.02) DOCUMENTATION ------------- The following documentation is available: POD in HTML format pod in perldoc format (type perldoc SVG on command line) RESOURCES --------- The following URLs offer additional resources for users of SVG.pm: * SVG.pm on-line manual http://roasp.com/man/SVG.html * Perl SVG tutorials http://roasp.com/tutorial/ * Perl SVG Zone homepage http://roasp.com/ * example scripts using SVG.pm ftp://roasp.com/pub/SVG-2.1/examples/ * gallery of the use of SVG.pm on the web http://roasp.com/gallery/svg/index.html INSTALLATION INSTRUCTIONS ------------------------- ***THERE ARE FOUR WAYS TO IMPLEMENT SVG MODULE IN PERL*** 1/ Systems with CPAN support (all Unix/Linux/BSD/Mac): ----------------------------------------------------- Install the new distribution via the Perl CPAN module: In a shell: /home/somewhere% perl -MCPAN -e"install SVG" 2/ (WIN) install Perl from Active State or equivalent: ----------------------------------------------------- Make sure you already have perl or get it here: http://www.activestate.com On the command line: C:\> ppm PPM> set repository tmp http://roasp.com/PPM/SVG/ PPM> install SVG PPM> quit C:\> 3/ The hard way (requires make or nmake, tar, gunzip, and gcc): --------------------------------------------------------------- This method was tested in DOS, Windows, AS400, Linux, Unix, BSD, Mac Hard-headed users can directly get the distribution from ftp:/roasp.com/pub/SVG-2.1/ First download the source. Then, in a shell: /home/somewhere% gunzip SVG-2.1.tar.gz /home/somewhere% tar-xvf SVG-2.1.tar cd SVG-2.1 make make test make install 4/ If all the above fail, there is still a (cumbersome) way: ----------------------------------------------------------- You have to install to a local dirctory and explicitly call the module by using one of the following line in your calling program: #using use lib use lib 'path/where/the/release/is/located'; -or- #using BEGIN block at the beginning of the file BEGIN { push @INC 'path/to/svg.pm-file'; #where the SVG.pm file lives push @INC 'path/to/svg.pm-file/SVG'; # where the Utils.pm file lives } #Refer to the Perl manual for more details. EXAMPLES: -------- A set of examples is included in the distribution in directory ./examples. Further examples are available from: ftp://roasp.com/pub/SVG-2.1/examples/ KNOWN BUGS & ISSUES ------------------- 28.05.02 SVG There are some issues with cdata() when the text string contains newline characters. SVG::DOM is incomplete and essentially unusable except by truly determined people. It is included here only in case people want to mess with it. SEE ALSO: SVG::Parser