PSlib
=====
Portable PHP library for dynamically generating PostScript files,
with support for the PHP scripting language.

Copyleft (c) 1999-2001 Vilson Cristiano Gartner (vgartner@univates.br)
of the Univates's SAGU Team.

The PSLib distribution is available from:
English:
http://pslib.sourceforge.net

Portuguese:
http://pslib.codigoaberto.org.br

THIS IS PUBLIC SOFTWARE RELEASED UNDER THE LGPL
see http://www.gnu.org for details on this license.


Overview
========
PSLib is a PHP library for generating PostScript files for the PHP free 
scripting language. It offers an easy way of generating PostScript text 
and graphics with (so far) limited support for drawing. Call PSlib
functions from within your PHP script and voila: dynamic PS files!

The functions should be quite self-explainable and somehow mimic the well
known proprietary PDFlib which generates dynamic PDF files. 


Supported Programming Environments
==================================
The PSLib was developed for usage within a PHP script only. Along with 
this distribution there is an example called historico.php3 where PSlib is
used.  


PSLib Features
==============
- basic drawing
  lines, rectangles, ...
- text
  text in different fonts and sizes, formatting,
  built-in font metrics, support for international (Latin, European) 
  character encoding (must have the included acentos.ps)	 
- image file formats
  support for PostScript files (use the GPL software GIMP to generate or
  convert other well known graphic formats to PS) 


Supplied Library Clients
========================
TODO


Platform support
================


Where to start?
===============
Read the included example historico.php3 (This example is actually what 
originated PSLib.)


PSLib resources
===============
PSlib is a work in progress. You can ask questions or contribute through
pslib-list@lists.sourceforge.net


External libraries used in PSLib
=================================
Mostly TODO.
The acentos.ps was extracted from a file generated by the html2ps open 
source (GPL) program.


Submitting Bug Reports
======================
Send your bug reports at http://sourceforge.net/projects/pslib


TODO
====
All under development

Licensing and Copyleft
======================
THIS IS LGPL SOFTWARE!

Read the LGPL license at http://www.fsf.org

Copyleft (c) 1999-2001 PSlib Vilson Cristiano Gartner (vgartner@univates.br) of the Univates' SAGU Team. 


History
=======
Version 0.03 - December 21, 2000
------------
Major Change: PSLib uses now PHP Class
Lib file name is now: pslib.class. 
The included pslib.php file is for compatibility with version 0.02 of pslib.
This file should be used for compatibility purpose only. There
are still a bug (object is not ever visible), but in the next days I will
correct this (if you want to help me, thanks :)

Version 0.02 - October 26, 2000
------------
Lib file name changed to pslib.php
Major Bug fixed: page number/count

Other changes:
- Function PS_open: now the parameters are ($file, $author, $title,
  $orientation).
- Function PS_begin_page: now the parameters are ($file, $page)
- Function PS_set_acent: are called directly by PS_open.

Version 0.01 - September 1, 2000
------------
First Release.
Functions: PS_begin_page, PS_close, PS_end_page, PS_line, PS_moveto,
PS_moveto_font, PS_open, PS_open_ps, PS_rect, PS_rect_fill, PS_rotate,
PS_set_font, PS_show, PS_show_eval, PS_show_xy, PS_show_xy_font, PS_set_acent

Thanks to:
---------
Ericson C. Smith, for his contribution in the conversion to class 
