man pages section 1: User Commands

Exit Print View

Updated: July 2014

ps2epsi (1)


ps2epsi - generate conforming Encapsulated PostScript


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


Ghostscript Tools                                      PS2EPSI(1)

     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 "out-
     file.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 auto-
     matically 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

9.00              Last change: 14 September 2010                1

Ghostscript Tools                                      PS2EPSI(1)

     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.

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

     See   attributes(5)   for   descriptions  of  the  following

     |Availability   | print/filter/ghostscript |
     |Stability      | Volatile                 |
     gs (1)

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

     George Cameron

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

     Further  information about this software can be found on the
     open source community website at

9.00              Last change: 14 September 2010                2