ps2epsi - generate conforming Encapsulated PostScript


     ps2epsi [ outfile.epsi ] (Unix)
     ps2epsi [ outfile.epi ] (DOS)


     ps2epsi uses gs(1) to process a PostScript(tm) file and gen-
     erate  as output a new file which conforms to Adobe's Encap-
     sulated PostScript Interchange (EPSI)  format.   EPSI  is  a
     special  form of encapsulated PostScript (EPS) which adds to
     the beginning of the file in the form of PostScript comments
     a  bitmapped  version of the final displayed page.  Programs
     which understand EPSI (usually word processors or  DTP  pro-
     grams)  can  use  this  bitmap  to give a preview version on
     screen of the PostScript.  The displayed  quality  is  often
     not  very  good  (e.g., low resolution, no colours), but the
     final printed version uses the real PostScript, and thus has
     the normal PostScript quality.


     On Unix systems invoke ps2epsi like this:

          ps2epsi [ outfile.epsi ]

     where "" is the input file  and  "outfile.epsi"  is
     the resulting EPSI file.  If the output filename is omitted,
     it is generated from the input filename.   When  a  standard
     extension  (".ps", ".cps", ".eps" or ".epsf") is used, it is
     replaced with the output extension ".epsi".  On DOS  systems
     the command is:

          ps2epsi outfile.epi

     where ""  is  the  original  PostScript  file,  and
     "outfile.epi" is the name of the output file.


     Not every PostScript file can be encapsulated  successfully,
     because there are restrictions on what PostScript constructs
     a correct encapsulated file may  contain.   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 certain  to  be  cases,  however,
     where the encapsulation does 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 workstation.  Framemaker on other
     platforms should be able to use these files, although I have
     not been able to test this.


     tab(>); l  l.   ps2epsi>Unix  shell  script  ps2epsi.bat>DOS
     batch file>the Ghostscript program which does the


     gs (1)


     This document was last revised for Ghostscript version 8.62.
     However,  the  content may be obsolete, or inconsistent with


     George Cameron

Man(1) output converted with man2html