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://roasp.com/man/SVG.html
2/ http://www.roitsystems.com/man/SVG.html
3/ http://search.cpan.org/~ronan
The complete pod for SVG resides in SVG::Manual
type perldoc SVG::Manual on the command line
(c) 2001-2005 Ronan Oger, RO IT Systems, GmbH
homepage: http://www.roitsystems.com
homepage: http://www.prosvg.com
CONTACT POINT
-------------
email: ronan at roasp.com
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, 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.roasp.com/serverside/
* SVG.pm on-line manual http://www.roasp.com/man/SVG.html
* Perl SVG tutorials http://www.roasp.com/tutorial/
* Perl SVG Zone homepage http://www.roasp.com/
* gallery of the use of SVG.pm on the web http://roasp.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://roasp.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.roasp.com/PPM/SVG/SVG-2.27.tar.gz or
http://www.roasp.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.
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
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.