SVG.pm version 0.30
07.10.01

SVG.pm is a perl extention to generate SVG (scaleable vector graphics).

Refer to the pod for full documentation and an example script. 

(c) 2001 Ronan Oger, RO IT Systems, GmbH ronan@roasp.com info@roitsystems.ch

This software is provided as is and without warranty. 
It is freely distributed under the general perl license.

CONTENTS
--------

OVERVIEW

DOCUMENTATION
    POD in HTML format
    Tutorials
INSTALLATION
    *NIX AND WIN32 SYSTEMS WITH MAKE OR EQUIVALENT
    WIN32 SYSTEMS WITHOUT MAKE OR EQUIVALENT

KNOWN BUGS

--------






OVERVIEW

SVG.pm makes it possible to generate fully-functional SVG images in perl.
The following are functionality is supported:

drawing of:
-circle
-ellipse
-rectangle
-polyline
-polygon
-path
-mpath
-text
-line
-image
-filter
-fe* (all of the filter sub-elements)



generation of:
-filter
-svg object and embedded svg object
-SMIL-compliant animation
-script (javascript & other supported scripts)
-gradients
-style definitions
-DOM-compliant mouse events
-drawing description
-groups
-anchors
-use
-desc
-title
-set
-defs

------------------------

DOCUMENTATION
-------------

The following documentation is available:

POD in HTML format

Version 0.30 POD
http://roasp.com/0.30/SVG.html
http://test.hackmare.com/0.30/SVG.html
Version 0.27 POD
http://roasp.com/0.27/SVG.html
http://test.hackmare.com/0.27/SVG.html
Version 0.26 POD
http://roasp.com/0.26/SVG.html
http://test.hackmare.com/0.26/SVG.html
Version 0.25 POD
http://roasp.com/0.25/SVG.html
http://test.hackmare.com/0.25/SVG.html


Tutorials

http://roasp.com/tutorial/
http://test.hackmare.com/tutorial/


INSTALLATION
------------

The easiest way to do this if your systems supports it is to use the perl CPAN module:


Installation Without using the perl CPAN module
----------------------------------

First download the tar file
Make sure you have the latest version by going to

ftp://test.hackmare.com/pub/Current
ftp://roasp.com/pub/Current


UNIX, LINUX, BSD, OSX and WINDOWS with tar, a make program, and a c compiler
----------------------------------------------------------------------------

on the command line, type:

	tar -xvfz SVG-0.20.tar.gz
	
	perl Makefile.PL

	make 

	make test

	make install



WIN32 SYSTEMS WITHOUT nmake
---------------------------

win32 note: There is no ppm yet for this module. 
You need to either install it using nmake or 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
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
}


------------------------

KNOWN BUGS

07.10.01
Does not support in-line generation of SVG for XML. It's mostly there but
there are still holes in the program.

07.10.01
When generating a path element by directly inputing the string data
the path definition (d=>'M 1 1 L 2 2...'), rather than the hash output of the
get_path method, the string must contain no new-line characters.

SUPPORT

More information is available from

http://roasp.com


------------------------