xref: /plan9/sys/src/cmd/gs/doc/Ps2epsi.htm (revision 593dc095aefb2a85c828727bbfa9da139a49bdf4)
13ff48bf5SDavid du Colombier<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
23ff48bf5SDavid du Colombier<html>
33ff48bf5SDavid du Colombier<head>
43ff48bf5SDavid du Colombier<title>Convert PostScript to Encapsulated PostScript Interchange format</title>
5*593dc095SDavid du Colombier<!-- $Id: Ps2epsi.htm,v 1.42 2005/10/20 19:46:23 ray Exp $ -->
63ff48bf5SDavid du Colombier<!-- Originally: ps2epsi.txt -->
73ff48bf5SDavid du Colombier<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
83ff48bf5SDavid du Colombier</head>
93ff48bf5SDavid du Colombier
103ff48bf5SDavid du Colombier<body>
113ff48bf5SDavid du Colombier<!-- [1.0 begin visible header] ============================================ -->
123ff48bf5SDavid du Colombier
133ff48bf5SDavid du Colombier<!-- [1.1 begin headline] ================================================== -->
143ff48bf5SDavid du Colombier
153ff48bf5SDavid du Colombier<h1>Convert PostScript to Encapsulated PostScript Interchange
163ff48bf5SDavid du Colombierformat</h1>
173ff48bf5SDavid du Colombier
183ff48bf5SDavid du Colombier<!-- [1.1 end headline] ==================================================== -->
193ff48bf5SDavid du Colombier
203ff48bf5SDavid du Colombier<!-- [1.2 begin table of contents] ========================================= -->
213ff48bf5SDavid du Colombier
223ff48bf5SDavid du Colombier<h2>Table of contents</h2>
233ff48bf5SDavid du Colombier
243ff48bf5SDavid du Colombier<blockquote><ul>
253ff48bf5SDavid du Colombier<li><a href="#Overview">Overview</a>
263ff48bf5SDavid du Colombier<li><a href="#Framemaker">Framemaker can use EPSI</a>
273ff48bf5SDavid du Colombier<li><a href="#Usage">Usage</a>
283ff48bf5SDavid du Colombier<ul>
293ff48bf5SDavid du Colombier<li><a href="#MSDOS_usage">MS-DOS</a>
303ff48bf5SDavid du Colombier<li><a href="#Unix_usage">Unix</a>
313ff48bf5SDavid du Colombier</ul>
323ff48bf5SDavid du Colombier<li><a href="#Limitations">Limitations</a>
333ff48bf5SDavid du Colombier<li><a href="#Files">Files</a>
343ff48bf5SDavid du Colombier</ul></blockquote>
353ff48bf5SDavid du Colombier
363ff48bf5SDavid du Colombier<!-- [1.2 end table of contents] =========================================== -->
373ff48bf5SDavid du Colombier
383ff48bf5SDavid du Colombier<!-- [1.3 begin hint] ====================================================== -->
393ff48bf5SDavid du Colombier
403ff48bf5SDavid du Colombier<p>
413ff48bf5SDavid du ColombierThe information in this document was contributed by George Cameron
423ff48bf5SDavid du Colombier&lt;<a href="mailto:george@bio-medical-physics.aberdeen.ac.uk">george@bio-medical-physics.aberdeen.ac.uk</a>&gt;;
433ff48bf5SDavid du Colombierplease direct to him any questions about it.  Because the software
443ff48bf5SDavid du Colombierdescribed here is no longer being maintained, this document may be
453ff48bf5SDavid du Colombierobsolete, or inconsistent with <b><tt>ps2epsi.1</tt></b>.
463ff48bf5SDavid du Colombier
473ff48bf5SDavid du Colombier<p>
483ff48bf5SDavid du ColombierFor other information, see the <a href="Readme.htm">Ghostscript
493ff48bf5SDavid du Colombieroverview</a>.
503ff48bf5SDavid du Colombier
513ff48bf5SDavid du Colombier<!-- [1.3 end hint] ======================================================== -->
523ff48bf5SDavid du Colombier
533ff48bf5SDavid du Colombier<hr>
543ff48bf5SDavid du Colombier
553ff48bf5SDavid du Colombier<!-- [1.0 end visible header] ============================================== -->
563ff48bf5SDavid du Colombier
573ff48bf5SDavid du Colombier<!-- [2.0 begin contents] ================================================== -->
583ff48bf5SDavid du Colombier
593ff48bf5SDavid du Colombier<h2><a name="Overview"></a>Overview</h2>
603ff48bf5SDavid du Colombier
613ff48bf5SDavid du Colombier<p>
623ff48bf5SDavid du Colombier<b><tt>ps2epsi</tt></b> is a utility based on Ghostscript, which takes as
633ff48bf5SDavid du Colombierinput a PostScript file and generates as output a new file which conforms
643ff48bf5SDavid du Colombierto Adobe's Encapsulated PostScript Interchange (EPSI) format, a special
653ff48bf5SDavid du Colombierform of
66*593dc095SDavid du Colombier<a href="http://partners.adobe.com/public/developer/en/ps/5002.EPSF_Spec.pdf"
673ff48bf5SDavid du Colombierclass="offsite">Encapsulated PostScript</a>
683ff48bf5SDavid du Colombier(EPS) which adds to the beginning of the file, as PostScript comments, a
693ff48bf5SDavid du Colombierlow-resolution monochrome bitmap image of the final displayed page.
703ff48bf5SDavid du ColombierPrograms which understand EPSI can use this bitmap as a preview on screen
713ff48bf5SDavid du Colombierof the full PostScript page. The displayed quality is often not very good,
723ff48bf5SDavid du Colombierbut the final printed version uses the "real" PostScript, and thus has the
733ff48bf5SDavid du Colombiernormal full PostScript quality.
743ff48bf5SDavid du Colombier
753ff48bf5SDavid du Colombier<h2><a name="Framemaker"></a>Framemaker can use EPSI</h2>
763ff48bf5SDavid du Colombier
773ff48bf5SDavid du Colombier<p>
783ff48bf5SDavid du ColombierThe <a href="http://www.adobe.com/products/framemaker/main.html"
793ff48bf5SDavid du Colombierclass="offsite">Adobe Framemaker</a> DTP system is one application which
803ff48bf5SDavid du Colombierunderstands EPSI files, and <b><tt>ps2epsi</tt></b> has been tested using
813ff48bf5SDavid du ColombierFramemaker 3.0 on a Sun workstation with a number of PostScript diagrams
823ff48bf5SDavid du Colombierfrom a variety of sources. Framemaker on other platforms may also be able
833ff48bf5SDavid du Colombierto use files made with <b><tt>ps2epsi</tt></b>, although this has not been
843ff48bf5SDavid du Colombiertested.
853ff48bf5SDavid du Colombier
863ff48bf5SDavid du Colombier<hr>
873ff48bf5SDavid du Colombier
883ff48bf5SDavid du Colombier<h2><a name="Usage"></a>Usage</h2>
893ff48bf5SDavid du Colombier
903ff48bf5SDavid du Colombier<h3><a name="MSDOS_usage"></a>MS-DOS</h3>
913ff48bf5SDavid du Colombier
923ff48bf5SDavid du Colombier<p>
933ff48bf5SDavid du ColombierUsing the supplied batch file <b><tt>ps2epsi.bat</tt></b>, the command is
943ff48bf5SDavid du Colombier
953ff48bf5SDavid du Colombier<blockquote>
963ff48bf5SDavid du Colombier<b><tt>ps2epsi</tt></b> <b><em>infile.ps</em></b> <b><em>outfile.epi</em></b>
973ff48bf5SDavid du Colombier</blockquote>
983ff48bf5SDavid du Colombier
993ff48bf5SDavid du Colombier<p>
1003ff48bf5SDavid du Colombierwhere <b><em>infile.ps</em></b> is the original PostScript file, and
1013ff48bf5SDavid du Colombier<b><em>outfile.epi</em></b> is the output EPSI file to be created.
1023ff48bf5SDavid du Colombier
1033ff48bf5SDavid du Colombier<h3><a name="Unix_usage"></a>Unix</h3>
1043ff48bf5SDavid du Colombier
1053ff48bf5SDavid du Colombier<p>
1063ff48bf5SDavid du ColombierUsing the supplied shell script <b><tt>ps2epsi</tt></b>, the command is
1073ff48bf5SDavid du Colombier
1083ff48bf5SDavid du Colombier<blockquote>
1093ff48bf5SDavid du Colombier<b><tt>ps2epsi</tt></b> <b><em>infile.ps</em></b> <b><em>[outfile.epsi]</em></b>
1103ff48bf5SDavid du Colombier</blockquote>
1113ff48bf5SDavid du Colombier
1123ff48bf5SDavid du Colombier<p>
1133ff48bf5SDavid du Colombierwhere <b><em>infile.ps</em></b> is the input file and
1143ff48bf5SDavid du Colombier<b><em>outfile.epsi</em></b> is the output EPSI file to be created. If the
1153ff48bf5SDavid du Colombieroutput filename is omitted, <b><tt>ps2epsi</tt></b> generates one from the
1163ff48bf5SDavid du Colombierinput filename; and any standard extension (<b><tt>.ps</tt></b>,
1173ff48bf5SDavid du Colombier<b><tt>.cps</tt></b>, <b><tt>.eps</tt></b> or <b><tt>.epsf</tt></b>) of the
1183ff48bf5SDavid du Colombierinput file is replaced in the output file with the extension
1193ff48bf5SDavid du Colombier<b><tt>.epsi</tt></b>.
1203ff48bf5SDavid du Colombier
1213ff48bf5SDavid du Colombier<hr>
1223ff48bf5SDavid du Colombier
1233ff48bf5SDavid du Colombier<h2><a name="Limitations"></a>Limitations</h2>
1243ff48bf5SDavid du Colombier
1253ff48bf5SDavid du Colombier<p>
1263ff48bf5SDavid du ColombierNot all PostScript files can be encapsulated, because there are
1273ff48bf5SDavid du Colombierrestrictions in what is permitted in a PostScript file for it to be
1283ff48bf5SDavid du Colombierproperly encapsulated.  <b><tt>ps2epsi</tt></b> does a little extra work to
1293ff48bf5SDavid du Colombiertry to help encapsulation, and it automatically calculates the bounding box
1303ff48bf5SDavid du Colombierrequired for all encapsulated PostScript files, so most of the time it does
1313ff48bf5SDavid du Colombiera pretty good job.  There are certain to be cases, however, when
1323ff48bf5SDavid du Colombierencapsulation fails because of the nature of the original PostScript file.
1333ff48bf5SDavid du Colombier
1343ff48bf5SDavid du Colombier<hr>
1353ff48bf5SDavid du Colombier
1363ff48bf5SDavid du Colombier<h2><a name="Files"></a>Files</h2>
1373ff48bf5SDavid du Colombier
1383ff48bf5SDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
1393ff48bf5SDavid du Colombier<tr><th colspan=3 bgcolor="#CCCC00"><hr><font size="+1"><b><tt>ps2epsi</tt></b> files</font><hr>
1403ff48bf5SDavid du Colombier<tr valign=bottom>
1413ff48bf5SDavid du Colombier	<th align=left>File
1423ff48bf5SDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;
1433ff48bf5SDavid du Colombier	<th align=left>Contents
1443ff48bf5SDavid du Colombier<tr>	<td colspan=3><hr>
1453ff48bf5SDavid du Colombier<tr valign=top>	<td><b><tt>ps2epsi.htm</tt></b>
1463ff48bf5SDavid du Colombier	<td>&nbsp;
1473ff48bf5SDavid du Colombier	<td>This document
1483ff48bf5SDavid du Colombier<tr valign=top>	<td><b><tt>ps2epsi.bat</tt></b>
1493ff48bf5SDavid du Colombier	<td>&nbsp;
1503ff48bf5SDavid du Colombier	<td>MS-DOS batch file
1513ff48bf5SDavid du Colombier<tr valign=top>	<td><b><tt>ps2epsi</tt></b>
1523ff48bf5SDavid du Colombier	<td>&nbsp;
1533ff48bf5SDavid du Colombier	<td>Unix shell script
1543ff48bf5SDavid du Colombier<tr valign=top>	<td><b><tt>ps2epsi.ps</tt></b>
1553ff48bf5SDavid du Colombier	<td>&nbsp;
1563ff48bf5SDavid du Colombier	<td>Ghostscript program which does the work
1573ff48bf5SDavid du Colombier</table></blockquote>
1583ff48bf5SDavid du Colombier
1593ff48bf5SDavid du Colombier<!-- [2.0 end contents] ==================================================== -->
1603ff48bf5SDavid du Colombier
1613ff48bf5SDavid du Colombier<!-- [3.0 begin visible trailer] =========================================== -->
1623ff48bf5SDavid du Colombier
1633ff48bf5SDavid du Colombier<hr>
1643ff48bf5SDavid du Colombier
1653ff48bf5SDavid du Colombier<p>
1663ff48bf5SDavid du Colombier<small>Copyright &copy; 1998, 2000 Aladdin Enterprises.  All rights
1673ff48bf5SDavid du Colombierreserved.</small>
1683ff48bf5SDavid du Colombier
1693ff48bf5SDavid du Colombier<p>
170*593dc095SDavid du ColombierThis software is provided AS-IS with no warranty, either express or
171*593dc095SDavid du Colombierimplied.
172*593dc095SDavid du Colombier
173*593dc095SDavid du ColombierThis software is distributed under license and may not be copied,
174*593dc095SDavid du Colombiermodified or distributed except as expressly authorized under the terms
175*593dc095SDavid du Colombierof the license contained in the file LICENSE in this distribution.
176*593dc095SDavid du Colombier
177*593dc095SDavid du ColombierFor more information about licensing, please refer to
178*593dc095SDavid du Colombierhttp://www.ghostscript.com/licensing/. For information on
179*593dc095SDavid du Colombiercommercial licensing, go to http://www.artifex.com/licensing/ or
180*593dc095SDavid du Colombiercontact Artifex Software, Inc., 101 Lucas Valley Road #110,
181*593dc095SDavid du ColombierSan Rafael, CA  94903, U.S.A., +1(415)492-9861.
1823ff48bf5SDavid du Colombier
1833ff48bf5SDavid du Colombier<p>
184*593dc095SDavid du Colombier<small>Ghostscript version 8.53, 20 October 2005
1853ff48bf5SDavid du Colombier
1863ff48bf5SDavid du Colombier<!-- [3.0 end visible trailer] ============================================= -->
1873ff48bf5SDavid du Colombier
1883ff48bf5SDavid du Colombier</body>
1893ff48bf5SDavid du Colombier</html>
190