| 1 |
.TH PS2EPSI 1 "18 Sept 2024" 10.04.0 "Ghostscript Tools" \" -*- nroff -*- |
| 2 |
.SH NAME |
| 3 |
ps2epsi \- generate conforming Encapsulated PostScript |
| 4 |
.SH SYNOPSIS |
| 5 |
\fBps2epsi\fR \fIinfile.ps\fR [ \fIoutfile.epsi\fR ] \fB(Unix)\fR |
| 6 |
.br |
| 7 |
\fBps2epsi\fR \fIinfile.ps\fR [ \fIoutfile.epi\fR ] \fB(DOS)\fR |
| 8 |
.SH DESCRIPTION |
| 9 |
\fBps2epsi\fR uses \fBgs\fR(1) to process a \fBPostScript\fR(tm) file and |
| 10 |
generate as output a new file which conforms to Adobe's \fBEncapsulated |
| 11 |
PostScript Interchange\fR (EPSI) format. EPSI is a special form of |
| 12 |
encapsulated PostScript (EPS) which adds to the beginning of the file in |
| 13 |
the form of PostScript comments a bitmapped version of the final displayed |
| 14 |
page. Programs which understand EPSI (usually word processors or DTP |
| 15 |
programs) can use this bitmap to give a preview version on screen of the |
| 16 |
PostScript. The displayed quality is often not very good (e.g., low |
| 17 |
resolution, no colours), but the final printed version uses the real |
| 18 |
PostScript, and thus has the normal PostScript quality. |
| 19 |
.SH USAGE |
| 20 |
On Unix systems invoke \fBps2epsi\fR like this: |
| 21 |
.PP |
| 22 |
.br |
| 23 |
\fBps2epsi\fR \fIinfile.ps\fR [ \fIoutfile.epsi\fR ] |
| 24 |
.PP |
| 25 |
where "infile.ps" is the input file and "outfile.epsi" is the resulting |
| 26 |
EPSI file. If the output filename is omitted, it is generated from the |
| 27 |
input filename. When a standard extension (".ps", ".cps", ".eps" or |
| 28 |
".epsf") is used, it is replaced with the output extension ".epsi". On |
| 29 |
DOS systems the command is: |
| 30 |
.PP |
| 31 |
.br |
| 32 |
\fBps2epsi\fR \fIinfile.ps outfile.epi\fR |
| 33 |
.PP |
| 34 |
where "infile.ps" is the original PostScript file, and "outfile.epi" |
| 35 |
is the name of the output file. |
| 36 |
.SH LIMITATIONS |
| 37 |
Not every PostScript file can be encapsulated successfully, because there |
| 38 |
are restrictions on what PostScript constructs a correct encapsulated file |
| 39 |
may contain. \fBps2epsi\fR does a little extra work to try to help |
| 40 |
encapsulation, and it automatically calculates the bounding box required |
| 41 |
for all encapsulated PostScript files, so most of the time it does a pretty |
| 42 |
good job. There are certain to be cases, however, where the encapsulation |
| 43 |
does not work because of the content of the original PostScript file. |
| 44 |
.SH COMPATIBILITY |
| 45 |
The \fBFramemaker\fR DTP system is one application which understands EPSI |
| 46 |
files, and \fBps2epsi\fR has been tested on a number of PostScript diagrams |
| 47 |
from a variety of sources, using Framemaker 3.0 on a Sun workstation. |
| 48 |
Framemaker on other platforms should be able to use these files, although I |
| 49 |
have not been able to test this. |
| 50 |
.SH FILES |
| 51 |
.TS |
| 52 |
tab(>); |
| 53 |
l l. |
| 54 |
ps2epsi>Unix shell script |
| 55 |
ps2epsi.bat>DOS batch file |
| 56 |
ps2epsi.ps>the Ghostscript program which does the work |
| 57 |
.TE |
| 58 |
.fi |
| 59 |
.SH SEE ALSO |
| 60 |
\fBgs\fR(1) |
| 61 |
.SH VERSION |
| 62 |
This document was last revised for Ghostscript version 10.04.0. |
| 63 |
However, the content may be obsolete, or inconsistent with ps2epsi.txt. |
| 64 |
.SH AUTHOR |
| 65 |
George Cameron |