Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022

ps2epsi (1)


ps2epsi - generate conforming Encapsulated PostScript


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


PS2EPSI(1)                     Ghostscript Tools                    PS2EPSI(1)

       ps2epsi - generate conforming Encapsulated PostScript

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

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

       Not  every  PostScript  file  can be encapsulated successfully, because
       there are restrictions on what PostScript constructs a correct encapsu-
       lated  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  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.

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

       See attributes(7) for descriptions of the following attributes:

       |Availability   | image/ghostscript |
       |Stability      | Volatile          |

       gs (1)

       This document was last revised for Ghostscript  version  9.54.0.   How-
       ever, the content may be obsolete, or inconsistent with ps2epsi.txt.

       George Cameron

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded from  https://github.com/ArtifexSoftware/ghost-

       Further information about this software can be found on the open source
       community website at http://ghostscript.com/.

9.54.0                           30 March 2021                      PS2EPSI(1)