home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / pstoedit.zip / readme.txt < prev    next >
Text File  |  1997-01-02  |  4KB  |  113 lines
  1. PSTOEDIT 
  2. Copyright (C) 1993,1994,1995,1996,1997 Wolfgang Glunz, Wolfgang.Glunz@mchp.siemens.de
  3.  
  4. pstoedit converts Postscript(TM) and PDF files to other vector graphic
  5. formats so that they can be edited graphically. See pstoedit.man or
  6. manual.html for more details on which formats are supported by pstoedit.
  7.  
  8.  
  9. If you just find this program useful, have made some improvements or 
  10. implemented other backends please send a mail to Wolfgang.Glunz@mchp.siemens.de.
  11. If you want to express your gratitude even more, you can send me
  12. some inline-skates stuff (magazines, bearings, wheels, ...) or some
  13. gifts from your company like T-shirts, etc.
  14. My home address is:
  15.  
  16.     Dr. Wolfgang Glunz             
  17.     81825 Muenchen / Germany  
  18.     Josef Brueckl Str. 32    
  19.  
  20. Installing pstoedit:
  21. --------------------
  22. You need a C++ compiler, e.g., g++ to compile pstoedit.
  23.  
  24. * cd to src
  25. * edit the makefile 
  26.     - change  BINDIR and MANDIR according to your local environment
  27.     - Uncomment the platform specific flags corresponding to your 
  28.       platform.
  29.     - if you want to include the CGM driver, you must have a copy 
  30.       of the cd-library from 
  31.       http://speckle.ncsl.nist.gov/~lorax/cgm/cd.html. 
  32.  
  33.       Note: For version 2.50 of pstoedit a special copy is already
  34.       contained in the distribution of pstoedit. See cd1.2x for
  35.       more details about this special version.
  36.  
  37.       After that, uncomment the lines following lines in the makefile
  38.     #CDDIR=../cd1.2x
  39.     #LOCALDEFINES=-I$(CDDIR) -DWITHCGM
  40.     #LOCALDRIVERS=drvcgm.$(OBJEXT) cdlib.$(OBJEXT)
  41.  
  42.       Note: You don't need to build the cd-library separately.
  43.  
  44.  
  45. * type: make clean; make; make install; (for *nix like systems)
  46.     nmake /f makefile     (in a DOS box)
  47.  
  48. There are several test cases included. To run them type `make test'.
  49. This works under *nix only.
  50.  
  51. If you want a GUI and have Borland C++ you can build one using the sources
  52. provided in the src/bc5gui directory. See src/bc5gui/readme.txt for more
  53. details. Many thanks to Jens Weber for this contribution.
  54.  
  55. Using pstoedit:
  56. ---------------
  57. See manual page in src/pstoedit.man or src/manual.html.
  58.  
  59. pstoedit works reasonable with PostScript files containing
  60.     * line drawings
  61.     * text with standard fonts 
  62.  
  63. Try to run it on golfer.ps or tiger.ps that comes with ghostscript, e.g., 
  64. pstoedit -f <your format> <local path where ghostscript is installed>/examples/tiger.ps tiger.<suffix>
  65.  
  66. In particular pstoedit does not support
  67.     * bitmap images
  68.     * general fill patterns
  69.     * clipping
  70.     * ... 
  71.  
  72.  
  73. Extending pstoedit:
  74. ---------------
  75. To implement a new backend you can start from drvsampl.cc.
  76. Please don't forget to send any new backend that might be of interest
  77. for others as well to the author (Wolfgang.Glunz@mchp.siemens.de) so that
  78. it can be incorporated into future versions of pstoedit.
  79.  
  80. Acknowledgements:
  81. -----------------
  82.  
  83. See manual page in src/pstoedit.man or src/manual.html for a list of contributors.
  84.  
  85. License: 
  86. --------
  87.  
  88.     This program is free software; you can redistribute it and/or modify
  89.     it under the terms of the GNU General Public License as published by
  90.     the Free Software Foundation; either version 2 of the License, or
  91.     (at your option) any later version.
  92.  
  93.     This program is distributed in the hope that it will be useful,
  94.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  95.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  96.     GNU General Public License for more details.
  97.  
  98.     You should have received a copy of the GNU General Public License
  99.     along with this program; if not, write to the Free Software
  100.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  101.  
  102.  
  103.  
  104. ----------------------------------------------------------------------------
  105.  
  106. The cgm backend within pstoedit is based on the cd-library available from
  107. http://speckle.ncsl.nist.gov/~lorax/cgm/cd.html . The source contains the
  108. following copyright notice:
  109.     cd software produced by NIST, an agency of the U.S. government,
  110.     is by statute not subject to copyright in the United States.
  111.     Recipients of this software assume all responsibilities associated
  112.     with its operation, modification and maintenance.
  113.