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 Encapsulated 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 version 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  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.

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 9.26.  However, the content may  be
       obsolete, or inconsistent with ps2epsi.txt.

AUTHOR

       George Cameron