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