ps2epsi(1)                                             ps2epsi(1)

       ps2epsi - generate conforming postscript

       ps2epsi [ ]    (Unix)
       ps2epsi outfile.epi

       ps2epsi is a utility, based on Ghostscript, which takes as
       input a postscript file and generates a  new  output  file
       which  conforms  to Adobe's Encapsulated Postscript Inter-
       change or EPSI format.  This is a special form of encapsu-
       lated  postscript (EPS) which adds a bitmap version of the
       final displayed page (in  the form of postscript comments)
       to  the beginning of the file. This bitmap  can be used by
       programs which understand EPSI (usually word processors or
       DTP  programs) to give a preview version of the postscript
       on screen. The displayed quality is often  not  very  good
       (eg.  low  resolution, no colours),  but the final printed
       version uses the real postscript, and thus has the  normal
       postscript quality.


       Using the supplied shell script, the command is:
            ps2epsi [ outfile.epsi ]
       where is the input file and outfile.epsi is the
       output EPSI file. If the output filename  is  omitted,  it
       will  be generated from the input filename.  If a standard
       extension (.ps, .cps, .eps or .epsf) is used, it  will  be
       replaced with the output extension .epsi.

       Using the supplied batch file, the command is simply:
            ps2epsi outfile.epi
       where is the original postscript file, and out-
       file.epi is the name of the output file.

       Successful encapsulation  of  arbitrary  postscript  files
       cannot be guaranteed, as there are certain restrictions in
       what is permitted in a postscript file for it to be  prop-
       erly  encapsulated.   ps2epsi  does a little extra work to
       try to help encapsulation, and it automatically calculates
       the bounding box (required for all encapsulated postscript
       files), so, most of the time, it does a pretty  good  job.
       There are bound to be cases, however, where the encapsula-
       tion will not work, because of the content of the original
       postscript file.

       The  Framemaker DTP system is one application which under-
       stands EPSI files, and ps2epsi has been tested on a number
       of  postscript  diagrams  from a variety of sources, using
       Framemaker 3.0 on a Sun.  Framemaker  on  other  platforms
       should  be  able  to  use these files, although I have not
       been able to test this.

       ps2epsi.bat    - MSDOS batch file
       ps2epsi        - Unix shell script     - the Ghostscript program which does the work


       George Cameron <>

                        September 1, 1997                       1