1PS2EPSI(1) Ghostscript Tools PS2EPSI(1)
2
6 ps2epsi - generate conforming Encapsulated PostScript
7
9 ps2epsi infile.ps [ outfile.epsi ] (Unix)
10 ps2epsi infile.ps [ outfile.epi ] (DOS)
11
13 ps2epsi uses gs(1) to process a PostScript(tm) file and generate as
14 output a new file which conforms to Adobe's Encapsulated PostScript In‐
15 terchange (EPSI) format. EPSI is a special form of encapsulated Post‐
16 Script (EPS) which adds to the beginning of the file in the form of
17 PostScript comments a bitmapped version of the final displayed page.
18 Programs which understand EPSI (usually word processors or DTP pro‐
19 grams) can use this bitmap to give a preview version on screen of the
20 PostScript. The displayed quality is often not very good (e.g., low
21 resolution, no colours), but the final printed version uses the real
22 PostScript, and thus has the normal PostScript quality.
23
25 On Unix systems invoke ps2epsi like this:
26 ps2epsi infile.ps [ outfile.epsi ]
28 where "infile.ps" is the input file and "outfile.epsi" is the resulting
30 EPSI file. If the output filename is omitted, it is generated from the
31 input filename. When a standard extension (".ps", ".cps", ".eps" or
32 ".epsf") is used, it is replaced with the output extension ".epsi". On
33 DOS systems the command is:
34 ps2epsi infile.ps outfile.epi
36 where "infile.ps" is the original PostScript file, and "outfile.epi" is
38 the name of the output file.
39
41 Not every PostScript file can be encapsulated successfully, because
42 there are restrictions on what PostScript constructs a correct encapsu‐
43 lated file may contain. ps2epsi does a little extra work to try to
44 help encapsulation, and it automatically calculates the bounding box
45 required for all encapsulated PostScript files, so most of the time it
46 does a pretty good job. There are certain to be cases, however, where
47 the encapsulation does not work because of the content of the original
48 PostScript file.
49
51 The Framemaker DTP system is one application which understands EPSI
52 files, and ps2epsi has been tested on a number of PostScript diagrams
53 from a variety of sources, using Framemaker 3.0 on a Sun workstation.
54 Framemaker on other platforms should be able to use these files, al‐
55 though I have not been able to test this.
56
58 ps2epsi Unix shell script
59 ps2epsi.bat DOS batch file
60 ps2epsi.ps the Ghostscript program which does the work
61
63 gs (1)
64
66 This document was last revised for Ghostscript version 9.56.1. How‐
67 ever, the content may be obsolete, or inconsistent with ps2epsi.txt.
68
70 George Cameron
719.56.1 4 April 2022 PS2EPSI(1)