README for SVG.pm 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 the following mirrors: 1/ http://search.cpan.org/perldoc?SVG 2/ http://search.cpan.org/~ronan The complete pod for SVG resides in SVG::Manual type perldoc SVG::Manual on the command line (c) 2001-2008 Ronan Oger, RO IT Systems, GmbH homepage: http://www.roitsystems.com CONTACT POINT ------------- ronan@cpan.org This software is provided as is and without warranty. It is freely distributed under the general perl license. LICENSE ------- This software is provided under the terms of the Perl license OVERVIEW -------- SVG.pm makes it possible to generate fully-functional SVG images in perl. 100% of the SVG tags are supported, and any new arbitrary element tag can be added by users by declaring it. VERSION ------- 2.33 Sunday, 2005.05.15 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: * Serverside Perl Forum: http://www.roitsystems.com/serverside/ * SVG.pm on-line manual http://www.roitsystems.com/man/SVG.html * Perl SVG tutorials http://www.roitsystems.com/tutorial/ * Perl SVG Zone homepage http://www.roitsystems.com/ * gallery of the use of SVG.pm on the web http://roitsystems.com/gallery/svg/index.html * SVG Foundation http://www.svgfoundation.org * SVG Developers mailing list http://www.yahoogroups.com/svg-developers/ * W3 Consortium http://www.w3.org * Sams Publishing, "SVG Unleashed", September 2002. There is a Perl chapter * SVG Open Conference proceedings http://www.svgopen.org * SVG foundation http://www.svgfoundation.org * SVG dot org http://www.svg.org INSTALLATION INSTRUCTIONS ------------------------- ***THERE ARE FIVE 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://roitsystems.com/PPM/SVG/ PPM> install SVG PPM> quit C:\> 3/ Use Source RPMs. Download the source RPM of your choice. In a shell: /hom/somewhere/% rpm -ihv SVG-source-rpm-name You may be prompted for the root password 4/ 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 http://www.roitsystems.com/PPM/SVG/SVG-2.27.tar.gz or http://www.roitsystems.com/PPM/SVG/ . First download the source. Then, in a shell: /home/somewhere% gunzip SVG-2.27.tar.gz /home/somewhere% tar-xvf SVG-2.27.tar cd SVG-2.1 make make test make install 5/ 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. KNOWN BUGS & ISSUES ------------------- Comments tags before the <svg> element are toxic. This is being worked on but I can not promise anything. Please submit bug reports to http://rt.cpan.org SEE ALSO -------- SVG::Parser SVG::DOM SVG::XML SVG::Element CHANGE LOG ---------- You can find details about the changes over time in the change log file: Changes COMMENTS/FEEDBACK ----------------- Please email your feedback, comments, questions to the email address at the top of this document. I will do my best to answer promptly. To date, I have not knowingly failed to answer any emails.