home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 10 / AU_CD10.iso / Updates / GhostScript / !GhostScr / 6_01 / doc / ps2epsi.txt < prev    next >
Text File  |  2000-03-09  |  3KB  |  67 lines
  1.     NOTE: this file was contributed by a user: please contact
  2.     George Cameron <george@bio-medical-physics.aberdeen.ac.uk>
  3.     if you have questions.
  4.     
  5.     Since the software described here is no longer being maintained, the
  6.     content of this document may be obsolete, or inconsistent with
  7.     ps2epsi.1.
  8.  
  9. OVERVIEW:
  10.  
  11.  ps2epsi is a utility, based on Ghostscript, which takes an input postscript
  12.  file and generates a new output file which conforms to Adobe's 'Encapsulated
  13.  Postscript Interchange' or EPSI format. This is a special form of encapsulated
  14.  postscript (EPS) which adds a bitmap version of the final displayed page (in
  15.  the form of postscript comments) to the beginning of the file. This bitmap
  16.  can be used by programs which understand EPSI (usually word processors or
  17.  DTP programs) to give a preview version of the postscript on screen. The
  18.  displayed quality is often not very good (eg. low resolution, no colours),
  19.  but the final printed version uses the 'real' postscript, and thus has the
  20.  normal full postscript quality.
  21.  
  22. FRAMEMAKER:
  23.  
  24.  The Framemaker DTP system is one application which understands EPSI files,
  25.  and ps2epsi has been tested on a number of postscript diagrams from a
  26.  variety of sources, using Framemaker 3.0 on a Sun. I believe that Framemaker
  27.  on the other platforms should also be able to use these files, although I
  28.  have not been able to test this.
  29.  
  30. FILES:
  31.  
  32.  ps2epsi.txt    - this file
  33.  ps2epsi.bat    - MSDOS batch file
  34.  ps2epsi    - Unix shell script
  35.  ps2epsi.ps    - the Ghostscript program which does the work
  36.  
  37. MSDOS USAGE:
  38.  
  39.  Using the supplied batch file, the command is simply:
  40.  
  41.     ps2epsi infile.ps outfile.epi
  42.  
  43.  where infile.ps is the original postscript file, and outfile.epi is the
  44.  name of the output file.
  45.  
  46. UNIX USAGE:
  47.  
  48.  Using the supplied shell script, the command is:
  49.  
  50.     ps2epsi infile.ps [outfile.epsi]
  51.  
  52.  where infile.ps is the input file and outfile.epsi is the output EPSI
  53.  file. If the output filename is omitted, it will be generated from the
  54.  input filename - if a standard extension (.ps, .cps, .eps or .epsf) is 
  55.  used, this will be replaced with the output extension .epsi .
  56.  
  57. LIMITATIONS:
  58.  
  59.  Successful encapsulation of arbitrary postscript files cannot be guaranteed,
  60.  as there are certain restrictions in what is permitted in a postscript file
  61.  for it to be properly encapsulated. ps2epsi does a little extra work to
  62.  try to help encapsulation, and it automatically calculates the bounding box
  63.  (required for all encapsulated postscript files), so, most of the time, it
  64.  does a pretty good job. There are bound to be cases, however, where the
  65.  encapsulation will not work, because of the content of the original postscript
  66.  file.
  67.