Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
<html>
3
<head>
4
<title>Convert PostScript to Encapsulated PostScript Interchange format</title>
5
<!-- $Id: Ps2epsi.htm,v 1.42 2005/10/20 19:46:23 ray Exp $ -->
6
<!-- Originally: ps2epsi.txt -->
7
<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
8
</head>
9
 
10
<body>
11
<!-- [1.0 begin visible header] ============================================ -->
12
 
13
<!-- [1.1 begin headline] ================================================== -->
14
 
15
<h1>Convert PostScript to Encapsulated PostScript Interchange
16
format</h1>
17
 
18
<!-- [1.1 end headline] ==================================================== -->
19
 
20
<!-- [1.2 begin table of contents] ========================================= -->
21
 
22
<h2>Table of contents</h2>
23
 
24
<blockquote><ul>
25
<li><a href="#Overview">Overview</a>
26
<li><a href="#Framemaker">Framemaker can use EPSI</a>
27
<li><a href="#Usage">Usage</a>
28
<ul>
29
<li><a href="#MSDOS_usage">MS-DOS</a>
30
<li><a href="#Unix_usage">Unix</a>
31
</ul>
32
<li><a href="#Limitations">Limitations</a>
33
<li><a href="#Files">Files</a>
34
</ul></blockquote>
35
 
36
<!-- [1.2 end table of contents] =========================================== -->
37
 
38
<!-- [1.3 begin hint] ====================================================== -->
39
 
40
<p>
41
The information in this document was contributed by George Cameron
42
&lt;<a href="mailto:george@bio-medical-physics.aberdeen.ac.uk">george@bio-medical-physics.aberdeen.ac.uk</a>&gt;;
43
please direct to him any questions about it.  Because the software
44
described here is no longer being maintained, this document may be
45
obsolete, or inconsistent with <b><tt>ps2epsi.1</tt></b>.
46
 
47
<p>
48
For other information, see the <a href="Readme.htm">Ghostscript
49
overview</a>.
50
 
51
<!-- [1.3 end hint] ======================================================== -->
52
 
53
<hr>
54
 
55
<!-- [1.0 end visible header] ============================================== -->
56
 
57
<!-- [2.0 begin contents] ================================================== -->
58
 
59
<h2><a name="Overview"></a>Overview</h2>
60
 
61
<p>
62
<b><tt>ps2epsi</tt></b> is a utility based on Ghostscript, which takes as
63
input a PostScript file and generates as output a new file which conforms
64
to Adobe's Encapsulated PostScript Interchange (EPSI) format, a special
65
form of
66
<a href="http://partners.adobe.com/public/developer/en/ps/5002.EPSF_Spec.pdf" 
67
class="offsite">Encapsulated PostScript</a>
68
(EPS) which adds to the beginning of the file, as PostScript comments, a
69
low-resolution monochrome bitmap image of the final displayed page.
70
Programs which understand EPSI can use this bitmap as a preview on screen
71
of the full PostScript page. The displayed quality is often not very good,
72
but the final printed version uses the "real" PostScript, and thus has the
73
normal full PostScript quality.
74
 
75
<h2><a name="Framemaker"></a>Framemaker can use EPSI</h2>
76
 
77
<p>
78
The <a href="http://www.adobe.com/products/framemaker/main.html"
79
class="offsite">Adobe Framemaker</a> DTP system is one application which 
80
understands EPSI files, and <b><tt>ps2epsi</tt></b> has been tested using 
81
Framemaker 3.0 on a Sun workstation with a number of PostScript diagrams 
82
from a variety of sources. Framemaker on other platforms may also be able 
83
to use files made with <b><tt>ps2epsi</tt></b>, although this has not been 
84
tested.
85
 
86
<hr>
87
 
88
<h2><a name="Usage"></a>Usage</h2>
89
 
90
<h3><a name="MSDOS_usage"></a>MS-DOS</h3>
91
 
92
<p>
93
Using the supplied batch file <b><tt>ps2epsi.bat</tt></b>, the command is
94
 
95
<blockquote>
96
<b><tt>ps2epsi</tt></b> <b><em>infile.ps</em></b> <b><em>outfile.epi</em></b>
97
</blockquote>
98
 
99
<p>
100
where <b><em>infile.ps</em></b> is the original PostScript file, and
101
<b><em>outfile.epi</em></b> is the output EPSI file to be created.
102
 
103
<h3><a name="Unix_usage"></a>Unix</h3>
104
 
105
<p>
106
Using the supplied shell script <b><tt>ps2epsi</tt></b>, the command is
107
 
108
<blockquote>
109
<b><tt>ps2epsi</tt></b> <b><em>infile.ps</em></b> <b><em>[outfile.epsi]</em></b>
110
</blockquote>
111
 
112
<p>
113
where <b><em>infile.ps</em></b> is the input file and
114
<b><em>outfile.epsi</em></b> is the output EPSI file to be created. If the
115
output filename is omitted, <b><tt>ps2epsi</tt></b> generates one from the
116
input filename; and any standard extension (<b><tt>.ps</tt></b>,
117
<b><tt>.cps</tt></b>, <b><tt>.eps</tt></b> or <b><tt>.epsf</tt></b>) of the
118
input file is replaced in the output file with the extension
119
<b><tt>.epsi</tt></b>.
120
 
121
<hr>
122
 
123
<h2><a name="Limitations"></a>Limitations</h2>
124
 
125
<p>
126
Not all PostScript files can be encapsulated, because there are
127
restrictions in what is permitted in a PostScript file for it to be
128
properly encapsulated.  <b><tt>ps2epsi</tt></b> does a little extra work to
129
try to help encapsulation, and it automatically calculates the bounding box
130
required for all encapsulated PostScript files, so most of the time it does
131
a pretty good job.  There are certain to be cases, however, when
132
encapsulation fails because of the nature of the original PostScript file.
133
 
134
<hr>
135
 
136
<h2><a name="Files"></a>Files</h2>
137
 
138
<blockquote><table cellpadding=0 cellspacing=0>
139
<tr><th colspan=3 bgcolor="#CCCC00"><hr><font size="+1"><b><tt>ps2epsi</tt></b> files</font><hr>
140
<tr valign=bottom>
141
	<th align=left>File
142
	<td>&nbsp;&nbsp;&nbsp;
143
	<th align=left>Contents
144
<tr>	<td colspan=3><hr>
145
<tr valign=top>	<td><b><tt>ps2epsi.htm</tt></b>
146
	<td>&nbsp;
147
	<td>This document
148
<tr valign=top>	<td><b><tt>ps2epsi.bat</tt></b>
149
	<td>&nbsp;
150
	<td>MS-DOS batch file
151
<tr valign=top>	<td><b><tt>ps2epsi</tt></b>
152
	<td>&nbsp;
153
	<td>Unix shell script
154
<tr valign=top>	<td><b><tt>ps2epsi.ps</tt></b>
155
	<td>&nbsp;
156
	<td>Ghostscript program which does the work
157
</table></blockquote>
158
 
159
<!-- [2.0 end contents] ==================================================== -->
160
 
161
<!-- [3.0 begin visible trailer] =========================================== -->
162
 
163
<hr>
164
 
165
<p>
166
<small>Copyright &copy; 1998, 2000 Aladdin Enterprises.  All rights
167
reserved.</small>
168
 
169
<p>
170
This software is provided AS-IS with no warranty, either express or
171
implied.
172
 
173
This software is distributed under license and may not be copied,
174
modified or distributed except as expressly authorized under the terms
175
of the license contained in the file LICENSE in this distribution.
176
 
177
For more information about licensing, please refer to
178
http://www.ghostscript.com/licensing/. For information on
179
commercial licensing, go to http://www.artifex.com/licensing/ or
180
contact Artifex Software, Inc., 101 Lucas Valley Road #110,
181
San Rafael, CA  94903, U.S.A., +1(415)492-9861.
182
 
183
<p>
184
<small>Ghostscript version 8.53, 20 October 2005
185
 
186
<!-- [3.0 end visible trailer] ============================================= -->
187
 
188
</body>
189
</html>