PSTOEDIT 
Copyright (C) 1993,1994,1995,1996,1997 Wolfgang Glunz, Wolfgang.Glunz@mchp.siemens.de

pstoedit converts Postscript(TM) and PDF files to other vector graphic
formats so that they can be edited graphically. See pstoedit.man or
manual.html for more details on which formats are supported by pstoedit.


If you just find this program useful, have made some improvements or 
implemented other backends please send a mail to Wolfgang.Glunz@mchp.siemens.de.
If you want to express your gratitude even more, you can send me
some inline-skates stuff (magazines, bearings, wheels, ...) or some
gifts from your company like T-shirts, etc.
My home address is:

	Dr. Wolfgang Glunz             
	81825 Muenchen / Germany  
	Josef Brueckl Str. 32    

Installing pstoedit:
--------------------
You need a C++ compiler, e.g., g++ to compile pstoedit.

* cd to src
* edit the makefile 
	- change  BINDIR and MANDIR according to your local environment
	- Uncomment the platform specific flags corresponding to your 
	  platform.
	- if you want to include the CGM driver, you must have a copy 
	  of the cd-library from 
	  http://speckle.ncsl.nist.gov/~lorax/cgm/cd.html. 

	  Note: For version 2.50 of pstoedit a special copy is already
	  contained in the distribution of pstoedit. See cd1.2x for
	  more details about this special version.

	  After that, uncomment the lines following lines in the makefile
	#CDDIR=../cd1.2x
	#LOCALDEFINES=-I$(CDDIR) -DWITHCGM
	#LOCALDRIVERS=drvcgm.$(OBJEXT) cdlib.$(OBJEXT)

	  Note: You don't need to build the cd-library separately.


* type: make clean; make; make install; (for *nix like systems)
	nmake /f makefile 	(in a DOS box)

There are several test cases included. To run them type `make test'.
This works under *nix only.

If you want a GUI and have Borland C++ you can build one using the sources
provided in the src/bc5gui directory. See src/bc5gui/readme.txt for more
details. Many thanks to Jens Weber for this contribution.

Using pstoedit:
---------------
See manual page in src/pstoedit.man or src/manual.html.

pstoedit works reasonable with PostScript files containing
	* line drawings
	* text with standard fonts 

Try to run it on golfer.ps or tiger.ps that comes with ghostscript, e.g., 
pstoedit -f <your format> <local path where ghostscript is installed>/examples/tiger.ps tiger.<suffix>

In particular pstoedit does not support
	* bitmap images
	* general fill patterns
	* clipping
	* ... 


Extending pstoedit:
---------------
To implement a new backend you can start from drvsampl.cc.
Please don't forget to send any new backend that might be of interest
for others as well to the author (Wolfgang.Glunz@mchp.siemens.de) so that
it can be incorporated into future versions of pstoedit.

Acknowledgements:
-----------------

See manual page in src/pstoedit.man or src/manual.html for a list of contributors.

License: 
--------

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.



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

The cgm backend within pstoedit is based on the cd-library available from
http://speckle.ncsl.nist.gov/~lorax/cgm/cd.html . The source contains the
following copyright notice:
	cd software produced by NIST, an agency of the U.S. government,
	is by statute not subject to copyright in the United States.
	Recipients of this software assume all responsibilities associated
	with its operation, modification and maintenance.
