PS2EPSI(I)              Ghostscript Tools              PS2EPSI(I)



NAME
       ps2epsi - generate conforming Encapsulated PostScript

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

DESCRIPTION
       ps2epsi  uses  gs(s)  to process a PostScript(t) 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  dis-
       played 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 dis-
       played quality is often not very good (e.g.,  low  resolu-
       tion,  no colours), but the final printed version uses the
       real PostScript, and thus has the normal PostScript  qual-
       ity.

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  omit-
       ted,  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 success-
       fully, because there are restrictions on  what  PostScript
       constructs   a  correct  encapsulated  file  may  contain.
       ps2epsi does a little extra work to try to help encapsula-
       tion,  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 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.

FILES
       tab(>); l l.  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
       6.53.   However, the content may be obsolete, or inconsis-
       tent with ps2epsi.txt.

AUTHOR
       George Cameron



6.53                     13 February 2002              PS2EPSI(I)