diff options
Diffstat (limited to 'doc/Ps2epsi.htm')
-rw-r--r-- | doc/Ps2epsi.htm | 268 |
1 files changed, 268 insertions, 0 deletions
diff --git a/doc/Ps2epsi.htm b/doc/Ps2epsi.htm new file mode 100644 index 00000000..da592547 --- /dev/null +++ b/doc/Ps2epsi.htm @@ -0,0 +1,268 @@ +<!doctype html> +<html> +<head> +<!-- Global site tag (gtag.js) - Google Analytics --> +<script async src="https://www.googletagmanager.com/gtag/js?id=UA-54391264-2"></script> +<script> + window.dataLayer = window.dataLayer || []; + function gtag(){dataLayer.push(arguments);} + gtag('js', new Date()); + + gtag('config', 'UA-54391264-2'); +</script> +<meta charset="UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro" rel="stylesheet"> +<link rel="shortcut icon" type="image/png" href="../../images/favicon.png"> +<title>Convert PostScript to Encapsulated PostScript Interchange Format</title> + <!-- Originally: ps2epsi.txt --> +<link href="style.css" rel="stylesheet" type="text/css"> +<link href="gs-style.css" rel="stylesheet" type="text/css"> +</head> + +<body> + + <div class="header"> + <div class="row"> + <div class="col-lt-6 logo"><a href="https://www.ghostscript.com/"><img src="images/ghostscript_logo.png" width="108" height="119" alt=""></a></div> + <div class="col-6"><div class="row"><div class="artifexlogo"><a href="https://artifex.com" target="_blank"><img src="images/Artifex_logo.png" width="194" height="40" alt=""></a></div> + <div class="col-12"><div class="button button1"><a href="https://artifex.com/contact-us/" title="Contact Us" target="_blank">Contact Us</a></div> + <div class="button button2 hidden-xs"><a href="https://www.ghostscript.com/download.html" title="Download">Download</a></div></div></div> + </div> + </div> + </div> + + <div class="banner"> + <div class="row"> + <div class="col-12">Convert PostScript to Encapsulated PostScript Interchange Format</div> + </div> + </div> + + <div class="main"> + <div class="row"> + <div id="sidebar"> + <div class="sidebar-item"></div> + <div class="col-2 leftnav"> +<ul> + <li><a href="https://www.ghostscript.com/">Home</a></li> + <li><a href="https://www.ghostscript.com/license.html">Licensing</a></li> + <li><a href="https://www.ghostscript.com/releases.html">Releases</a></li> + <li><a href="https://www.ghostscript.com/release_history.html">Release History</a></li> + <li><a href="https://www.ghostscript.com/documentation.html" title="Documentation">Documentation</a></li> + <li><a href="https://www.ghostscript.com/download.html" title="Download">Download</a></li> + <li><a href="https://www.ghostscript.com/performance.html" title="Performance">Performance</a></li> + <li><a href="http://jbig2dec.com/" title="jbig2dec">jbig2dec</a></li> + <li><a href="http://git.ghostscript.com/?p=ghostpdl.git;a=summary">Source</a></li> + <li><a href="http://bugs.ghostscript.com/">Bugs</a></li> + <li><a href="https://www.ghostscript.com/faq.html" title="FAQ">FAQ</a></li> + </ul> + </div> + </div> + <div class="col-10 page"> + +<!--START EDITING HERE--> + +<h2>Table of contents</h2> + +<blockquote><ul> +<li><a href="#Overview">Overview</a> +<li><a href="#Framemaker">Framemaker can use EPSI</a> +<li><a href="#Usage">Usage</a> +<ul> +<li><a href="#MSDOS_usage">MS-DOS</a> +<li><a href="#Unix_usage">Unix</a> +</ul> +<li><a href="#Limitations">Limitations</a> +<li><a href="#Files">Files</a> +</ul></blockquote> + +<!-- [1.2 end table of contents] =========================================== --> + +<!-- [1.3 begin hint] ====================================================== --> + +<p> +The information in this document was contributed by George Cameron +<<a href="mailto:george@bio-medical-physics.aberdeen.ac.uk">george@bio-medical-physics.aberdeen.ac.uk</a>>; +please direct to him any questions about it. Because the software +described here is no longer being maintained, this document may be +obsolete, or inconsistent with <code>ps2epsi.1</code>. + +<p> +For other information, see the <a href="Readme.htm">Ghostscript +overview</a>. + +<!-- [1.3 end hint] ======================================================== --> + +<hr> + +<!-- [1.0 end visible header] ============================================== --> + +<!-- [2.0 begin contents] ================================================== --> + +<h2><a name="Overview"></a>Overview</h2> + +<p> +<code>ps2epsi</code> is a utility based on Ghostscript, which takes as +input a PostScript file and generates as output a new file which conforms +to Adobe's Encapsulated PostScript Interchange (EPSI) format, a special +form of +<a href="http://partners.adobe.com/public/developer/en/ps/5002.EPSF_Spec.pdf" +class="offsite">Encapsulated PostScript</a> +(EPS) which adds to the beginning of the file, as PostScript comments, a +low-resolution monochrome bitmap image of the final displayed page. +Programs which understand EPSI can use this bitmap as a preview on screen +of the full PostScript page. The displayed quality is often not very good, +but the final printed version uses the "real" PostScript, and thus has the +normal full PostScript quality. +<hr? +<h2><a name="Framemaker"></a>Framemaker can use EPSI</h2> + +<p> +The <a href="http://www.adobe.com/products/framemaker/main.html" +class="offsite">Adobe Framemaker</a> DTP system is one application which +understands EPSI files, and <code>ps2epsi</code> has been tested using +Framemaker 3.0 on a Sun workstation with a number of PostScript diagrams +from a variety of sources. Framemaker on other platforms may also be able +to use files made with <code>ps2epsi</code>, although this has not been +tested. + +<hr> + +<h2><a name="Usage"></a>Usage</h2> + +<h3><a name="MSDOS_usage"></a>MS-DOS</h3> + +<p> +Using the supplied batch file <code>ps2epsi.bat</code>, the command is + +<blockquote> +<code>ps2epsi</code> <b><em>infile.ps</em></b> <b><em>outfile.epi</em></b> +</blockquote> + +<p> +where <b><em>infile.ps</em></b> is the original PostScript file, and +<b><em>outfile.epi</em></b> is the output EPSI file to be created. + +<h3><a name="Unix_usage"></a>Unix</h3> + +<p> +Using the supplied shell script <code>ps2epsi</code>, the command is + +<blockquote> +<code>ps2epsi</code> <b><em>infile.ps</em></b> <b><em>[outfile.epsi]</em></b> +</blockquote> + +<p> +where <b><em>infile.ps</em></b> is the input file and +<b><em>outfile.epsi</em></b> is the output EPSI file to be created. If the +output filename is omitted, <code>ps2epsi</code> generates one from the +input filename; and any standard extension (<code>.ps</code>, +<code>.cps</code>, <code>.eps</code> or <code>.epsf</code>) of the +input file is replaced in the output file with the extension +<code>.epsi</code>. + +<hr> + +<h2><a name="Limitations"></a>Limitations</h2> + +<p> +Not all PostScript files can be encapsulated, because there are +restrictions in what is permitted in a PostScript file for it to be +properly encapsulated. <code>ps2epsi</code> does a little extra work to +try to help encapsulation, and it automatically calculates the bounding box +required for all encapsulated PostScript files, so most of the time it does +a pretty good job. There are certain to be cases, however, when +encapsulation fails because of the nature of the original PostScript file. + +<hr> + +<h2><a name="Files"></a>Files</h2> + +<blockquote><table> +<tr> + <th colspan="3">ps2epsi files</th> + </tr> +<tr> + <th align="left">File</th> + <th> </th> + <th align="left">Contents</th> + </tr> +<tr> + <td><code>ps2epsi.htm</code></td> + <td> </td> + <td>This document</td> + </tr> +<tr> + <td><code>ps2epsi.bat</code></td> + <td> </td> + <td>MS-DOS batch file</td> + </tr> +<tr> + <td><code>ps2epsi</code></td> + <td> </td> + <td>Unix shell script</td> + </tr> +<tr> + <td><code>ps2epsi.ps</code></td> + <td> </td> + <td>Ghostscript program which does the work</td> + </tr> +</table></blockquote> + +<!-- [2.0 end contents] ==================================================== --> + +<!-- [3.0 begin visible trailer] =========================================== --> + +<hr> + +<p> +<small>Copyright © 2000-2019 Artifex Software, Inc. All rights reserved.</small> + +<p> +This software is provided AS-IS with no warranty, either express or +implied. + +This software is distributed under license and may not be copied, modified +or distributed except as expressly authorized under the terms of that +license. Refer to licensing information at http://www.artifex.com/ +or contact Artifex Software, Inc., 1305 Grant Avenue - Suite 200, +Novato, CA 94945, U.S.A., +1(415)492-9861, for further information. + +<p> +<small>Ghostscript version 9.50, 15 October 2019 + +<!-- [3.0 end visible trailer] ============================================= --> + +<!--FINISH EDITING HERE--> + + </div> + </div> + </div> + + <div class="footer"> + <div class="row"> + <div class="col-7 footleft"> + <ul> + <li><a href="https://artifex.com/contact-us/" target="blank">CONTACT US</a></li> + <li><a href="https://artifex.com/about-us/" target="blank">ABOUT</a></li> + <li><a href="https://ghostscript.com/security.html">SECURITY</a></li> + </ul> + </div> + <div class="col-1 footcenter"> + <ul> + <li><a href="https://artifex.com/support/" target="blank">SUPPORT</a></li> + <li><a href="https://artifex.com/blog/artifex/" target="blank">BLOG</a></li> + <li><a href="https://artifex.com/privacy-policy/" target="blank">PRIVACY</a></li> + </ul> + </div> + <div class="col-ft-3 footright"><img src="images/Artifex_logo.png" width="194" height="40" alt=""/> <br> + © Copyright 2019 Artifex Software, Inc. <br> + All rights reserved. + </div> + </div> + </div> + + <script src="http://cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script> + <script src="index.js"></script> +</body> +</html> |