PS2EPSI(1)                                              Ghostscript Tools                                             PS2EPSI(1)



NAME
       ps2epsi - generate conforming Encapsulated PostScript

SYNOPSIS
       ps2epsi infile.ps [ outfile.epsi ] (Unix)
       ps2epsi infile.ps [ outfile.epi ] (DOS)

DESCRIPTION
       ps2epsi  uses gs(1) to process a PostScript(tm) file and generate as output a new file which conforms to Adobe's Encapsu-
       lated 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 programs) 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 ver-
       sion uses the real PostScript, and thus has the normal PostScript quality.

USAGE
       On Unix systems invoke ps2epsi like this:

            ps2epsi infile.ps [ outfile.epsi ]

       where "infile.ps" 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 infile.ps outfile.epi

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

LIMITATIONS
       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 automati-
       cally 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.

COMPATIBILITY
       The Framemaker DTP system is one application which understands 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.

FILES
       ps2epsi       Unix shell script
       ps2epsi.bat   DOS batch file
       ps2epsi.ps    the Ghostscript program which does the work

SEE ALSO
       gs (1)

VERSION
       This document was last revised for Ghostscript version 8.71.  However, the content may be obsolete, or inconsistent  with
       ps2epsi.txt.

AUTHOR
       George Cameron



8.71                                                    10 February 2010                                              PS2EPSI(1)