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 out-
put a new file which conforms to Adobe's Encapsulated PostScript Inter-
change (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 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 en-
capsulation does not work because of the content of the original Post-
Script 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, al-
though 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 10.04.0. How-
ever, the content may be obsolete, or inconsistent with ps2epsi.txt.
AUTHOR
George Cameron
10.04.0 18 Sept 2024 PS2EPSI(1)
Generated by dwww version 1.16 on Tue Dec 16 04:39:56 CET 2025.