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