xref: /plan9-contrib/sys/src/cmd/gs/doc/Ps2pdf.htm (revision 593dc095aefb2a85c828727bbfa9da139a49bdf4)
13ff48bf5SDavid du Colombier<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
27dd7cddfSDavid du Colombier<html>
37dd7cddfSDavid du Colombier<head>
47dd7cddfSDavid du Colombier<title>ps2pdf: PostScript-to-PDF converter</title>
5*593dc095SDavid du Colombier<!-- $Id: Ps2pdf.htm,v 1.88 2005/10/20 19:46:23 ray Exp $ -->
67dd7cddfSDavid du Colombier<!-- Originally: ps2pdf.txt -->
73ff48bf5SDavid du Colombier<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
87dd7cddfSDavid du Colombier</head>
97dd7cddfSDavid du Colombier
107dd7cddfSDavid du Colombier<body>
117dd7cddfSDavid du Colombier<!-- [1.0 begin visible header] ============================================ -->
127dd7cddfSDavid du Colombier
137dd7cddfSDavid du Colombier<!-- [1.1 begin headline] ================================================== -->
147dd7cddfSDavid du Colombier
153ff48bf5SDavid du Colombier<h1><tt>ps2pdf</tt>: PostScript-to-PDF converter</h1>
167dd7cddfSDavid du Colombier
177dd7cddfSDavid du Colombier<!-- [1.1 end headline] ==================================================== -->
187dd7cddfSDavid du Colombier
197dd7cddfSDavid du Colombier<!-- [1.2 begin table of contents] ========================================= -->
207dd7cddfSDavid du Colombier
217dd7cddfSDavid du Colombier<h2>Table of contents</h2>
227dd7cddfSDavid du Colombier
237dd7cddfSDavid du Colombier<blockquote><ul>
247dd7cddfSDavid du Colombier<li><a href="#Overview">Overview</a>
257dd7cddfSDavid du Colombier<li><a href="#Usage">Usage</a>
26*593dc095SDavid du Colombier<li><a href="#Orientation">Setting page orientation</a>
277dd7cddfSDavid du Colombier<li><a href="#Options">Options</a>
28*593dc095SDavid du Colombier<li><a href="#PDFX">Creating a PDF/X-3 document</a>
297dd7cddfSDavid du Colombier<li><a href="#Limitations">Limitations</a>
30*593dc095SDavid du Colombier<li><a href="#PPD">Ghostscript PDF Printer Description</a>
317dd7cddfSDavid du Colombier<li><a href="#Problems">Known problems</a>
323ff48bf5SDavid du Colombier<li><a href="#Ps2pdf_vs_AD">Comparison of <b><tt>ps2pdf</tt></b> and Acrobat Distiller</a>
337dd7cddfSDavid du Colombier<li><a href="#Acknowledgments">Acknowledgments</a>
347dd7cddfSDavid du Colombier</ul></blockquote>
357dd7cddfSDavid du Colombier
367dd7cddfSDavid du Colombier<!-- [1.2 end table of contents] =========================================== -->
377dd7cddfSDavid du Colombier
387dd7cddfSDavid du Colombier<!-- [1.3 begin hint] ====================================================== -->
397dd7cddfSDavid du Colombier
407dd7cddfSDavid du Colombier<p>For other information, see the <a href="Readme.htm">Ghostscript
417dd7cddfSDavid du Colombieroverview</a>.
427dd7cddfSDavid du Colombier
437dd7cddfSDavid du Colombier<!-- [1.3 end hint] ======================================================== -->
447dd7cddfSDavid du Colombier
457dd7cddfSDavid du Colombier<hr>
467dd7cddfSDavid du Colombier
477dd7cddfSDavid du Colombier<!-- [1.0 end visible header] ============================================== -->
487dd7cddfSDavid du Colombier
497dd7cddfSDavid du Colombier<!-- [2.0 begin contents] ================================================== -->
507dd7cddfSDavid du Colombier
513ff48bf5SDavid du Colombier<h2><a name="Overview"></a>Overview</h2>
527dd7cddfSDavid du Colombier
537dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b> is a work-alike for nearly all the functionality (but
547dd7cddfSDavid du Colombiernot the user interface) of Adobe's Acrobat<small><sup>TM</sup></small>
557dd7cddfSDavid du ColombierDistiller<small><sup>TM</sup></small> product: it converts PostScript files
567dd7cddfSDavid du Colombierto Portable Document Format (PDF) files.
577dd7cddfSDavid du Colombier
587dd7cddfSDavid du Colombier<p>
597dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b> is implemented as a very small command script (batch
607dd7cddfSDavid du Colombierfile) that invokes Ghostscript, selecting a special "output device" called
617dd7cddfSDavid du Colombier<b><tt>pdfwrite</tt></b>.  In order to use <b><tt>ps2pdf</tt></b>, the
627dd7cddfSDavid du Colombier<b><tt>pdfwrite</tt></b> device must be included in the makefile when
637dd7cddfSDavid du ColombierGhostscript was compiled; see the <a
647dd7cddfSDavid du Colombierhref="Make.htm#Features_and_devices">documentation on building
657dd7cddfSDavid du ColombierGhostscript</a> for details: this is currently the case on all platforms, in
667dd7cddfSDavid du ColombierGhostscript as we distribute it.
677dd7cddfSDavid du Colombier
687dd7cddfSDavid du Colombier<hr>
697dd7cddfSDavid du Colombier
703ff48bf5SDavid du Colombier<h2><a name="Usage"></a>Usage</h2>
717dd7cddfSDavid du Colombier
727dd7cddfSDavid du Colombier<p>
737dd7cddfSDavid du ColombierThe usage for <b><tt>ps2pdf</tt></b> is
747dd7cddfSDavid du Colombier
757dd7cddfSDavid du Colombier<blockquote><b><tt>
763ff48bf5SDavid du Colombierps2pdf</tt></b> <em>[options] input.[e]ps output.pdf</em>
777dd7cddfSDavid du Colombier</blockquote>
787dd7cddfSDavid du Colombier
797dd7cddfSDavid du Colombier<p>
807dd7cddfSDavid du Colombieror, on Unix systems and some versions of Windows NT and OS/2
817dd7cddfSDavid du Colombier
827dd7cddfSDavid du Colombier<blockquote><b><tt>
833ff48bf5SDavid du Colombierps2pdf</tt></b> <em>input.[e]ps</em>
847dd7cddfSDavid du Colombier</blockquote>
857dd7cddfSDavid du Colombier
867dd7cddfSDavid du Colombier<p>
877dd7cddfSDavid du Colombierwhich is equivalent to
887dd7cddfSDavid du Colombier
897dd7cddfSDavid du Colombier<blockquote><b><tt>
903ff48bf5SDavid du Colombierps2pdf</tt></b> <em>input.[e]ps input.pdf</em>
917dd7cddfSDavid du Colombier</blockquote>
927dd7cddfSDavid du Colombier
937dd7cddfSDavid du Colombier<p>
943ff48bf5SDavid du ColombierThere are actually several different <b><tt>ps2pdf</tt></b><em>*</em> scripts:
957dd7cddfSDavid du Colombierthe name <b><tt>ps2pdf</tt></b> above refers to any of them.
967dd7cddfSDavid du Colombier
977dd7cddfSDavid du Colombier<ul>
987dd7cddfSDavid du Colombier
99*593dc095SDavid du Colombier<li><b><tt>ps2pdf12</tt></b> produces PDF 1.2 output (Acrobat 3-and-later
100*593dc095SDavid du Colombiercompatible).
1017dd7cddfSDavid du Colombier
102*593dc095SDavid du Colombier<li><b><tt>ps2pdf13</tt></b> produces PDF 1.3 output (Acrobat 4-and-later
103*593dc095SDavid du Colombiercompatible).
1047dd7cddfSDavid du Colombier
105*593dc095SDavid du Colombier<li><b><tt>ps2pdf14</tt></b> produces PDF 1.4 output (Acrobat 5-and-later
106*593dc095SDavid du Colombiercompatible).
1073ff48bf5SDavid du Colombier
108*593dc095SDavid du Colombier<li><b><tt>ps2pdf</tt></b> per se currently produces PDF 1.2 output.
109*593dc095SDavid du ColombierHowever, this may change in the future.  If you care about the compatibility
110*593dc095SDavid du Colombierlevel of the output, use <b><tt>ps2pdf12</tt></b>, <b><tt>ps2pdf13</tt></b>,
111*593dc095SDavid du Colombieror <b><tt>ps2pdf14</tt></b>, or use the
1123ff48bf5SDavid du Colombier<b><tt>-dCompatibilityLevel=</tt></b><em>1.x</em> switch in the command
1133ff48bf5SDavid du Colombierline.
1147dd7cddfSDavid du Colombier
1157dd7cddfSDavid du Colombier</ul>
1167dd7cddfSDavid du Colombier
1177dd7cddfSDavid du Colombier<p>
118*593dc095SDavid du ColombierNote that if you specify a value for <b><tt>PDFSETTINGS</tt></b>, this
119*593dc095SDavid du Colombierchooses PDF 1.3 or 1.4 output depending on the value of
120*593dc095SDavid du Colombier<b><tt>PDFSETTINGS</tt></b>: this overrides the output format specified by
121*593dc095SDavid du Colombierthe script name.  You can still specify the output format by using
122*593dc095SDavid du Colombier<b><tt>-dCompatibilityLevel=</tt></b> <em>after</em>
123*593dc095SDavid du Colombier<b><tt>-dPDFSETTINGS=</tt></b>.
124*593dc095SDavid du Colombier
125*593dc095SDavid du Colombier<p>
1263ff48bf5SDavid du ColombierAll of these scripts actually call a script named <b><tt>ps2pdfwr</tt></b>
1273ff48bf5SDavid du Colombieror <b><tt>ps2pdfxx</tt></b>.  The Unix <b><tt>ps2pdfwr</tt></b> script
1283ff48bf5SDavid du Colombierassumes that the Ghostscript executable is named <b><tt>gs</tt></b>; it is
1293ff48bf5SDavid du Colombierunlikely that you will need to change this.  The DOS and MS Windows
1303ff48bf5SDavid du Colombier<b><tt>ps2pdfxx.bat</tt></b> script uses the value of the
1313ff48bf5SDavid du Colombier<b><tt>GSC</tt></b> environment variable, if defined, as the name of the
1323ff48bf5SDavid du Colombierexecutable; otherwise the script assumes the executable is named
1333ff48bf5SDavid du Colombier<b><tt>gswin32c</tt></b>.  So in these environments, if the executable has a
1343ff48bf5SDavid du Colombierdifferent name, you must set <b><tt>GSC</tt></b> to the name of the
1353ff48bf5SDavid du Colombierexecutable.
1367dd7cddfSDavid du Colombier
1377dd7cddfSDavid du Colombier<hr>
1387dd7cddfSDavid du Colombier
139*593dc095SDavid du Colombier<h2><a name="Orientation"></a>Setting page orientation</h2>
140*593dc095SDavid du Colombier
141*593dc095SDavid du Colombier<p>
142*593dc095SDavid du ColombierBy default Ghostscript determines viewing page orientation based on the dominant
143*593dc095SDavid du Colombiertext orientation on the page. Sometimes, when the page has text in several
144*593dc095SDavid du Colombierorientations or has no text at all, wrong orientation can be selected.
145*593dc095SDavid du Colombier
146*593dc095SDavid du Colombier<p>
147*593dc095SDavid du ColombierAcrobat Distiller parameter <b><tt>AutoRotatePages</b></tt> controls the
148*593dc095SDavid du Colombierautomatic orientation selection algorithm. On Ghostscript, besides
149*593dc095SDavid du Colombierinput stream, Distiller parameters can be given as command line arguments.
150*593dc095SDavid du ColombierFor instance: <b><tt>-dAutoRotatePages=/None</b></tt> or
151*593dc095SDavid du Colombier<b><tt>/All</b></tt> or <b><tt>/PageByPage</b></tt>.
152*593dc095SDavid du Colombier
153*593dc095SDavid du Colombier<p>
154*593dc095SDavid du ColombierWhen there is no text on the page or automatic page rotation is set to
155*593dc095SDavid du Colombier<b><tt>/None</b></tt> an orientation value from setpagedevice is used.
156*593dc095SDavid du ColombierValid values are: <b><tt>0</b></tt> (portrait),
157*593dc095SDavid du Colombier<b><tt>3</b></tt> (landscape), <b><tt>2</b></tt> (upside down),
158*593dc095SDavid du Colombierand <b><tt>1</b></tt> (seascape). The orientation can be set from the
159*593dc095SDavid du Colombiercommand line as <b><tt>-c "&lt;&lt;/Orientation 3&gt;&gt; setpagedevice"</b></tt>
160*593dc095SDavid du Colombierusing Ghostscript directly but cannot be set in <b><tt>ps2pdf</b></tt>.
161*593dc095SDavid du ColombierSee <a href="#Limitations">Limitations</a> below.
162*593dc095SDavid du Colombier</pre>
163*593dc095SDavid du Colombier
164*593dc095SDavid du Colombier<p>
165*593dc095SDavid du ColombierGhostscript passes the orientation values from DSC comments to
166*593dc095SDavid du Colombier<b><tt>pdfwrite</b></tt> driver
167*593dc095SDavid du Colombierbut they are effectively ignored there. This appears to be consistent with
168*593dc095SDavid du ColombierDistiller 5 behavior.
169*593dc095SDavid du Colombier
170*593dc095SDavid du Colombier<hr>
171*593dc095SDavid du Colombier
1723ff48bf5SDavid du Colombier<h2><a name="Options"></a>Options</h2>
1737dd7cddfSDavid du Colombier
1747dd7cddfSDavid du Colombier<p>
1757dd7cddfSDavid du ColombierThe <em>options</em> in the command line may include any switches that may
1767dd7cddfSDavid du Colombierbe used with Ghostscript's PostScript and PDF interpreter (see <a
1777dd7cddfSDavid du Colombierhref="Use.htm#Switches">here</a> for a complete list), although almost none
1783ff48bf5SDavid du Colombierof them are useful with <b><tt>ps2pdf</tt></b>.  The following may be
1793ff48bf5SDavid du Colombieruseful:
1803ff48bf5SDavid du Colombier
1813ff48bf5SDavid du Colombier<dl>
1823ff48bf5SDavid du Colombier
1833ff48bf5SDavid du Colombier<dt><b><tt>-r</tt></b><em>resolution</em>
1843ff48bf5SDavid du Colombier<dd>Sets the resolution for pattern fills and for fonts that must be
1853ff48bf5SDavid du Colombierconverted to bitmaps.
1863ff48bf5SDavid du Colombier
1873ff48bf5SDavid du Colombier<dt><b><tt>-dProcessColorModel=</tt></b><em>device_color_space</em> <dd>Sets
1883ff48bf5SDavid du Colombierthe color space to be used for device-dependent colors in the
1893ff48bf5SDavid du Colombieroutput. <em>device_color_space</em> may be <b><tt>/DeviceGray</tt></b>,
1903ff48bf5SDavid du Colombier<b><tt>/DeviceRGB</tt></b>, or <b><tt>/DeviceCMYK</tt></b>; the default
191*593dc095SDavid du Colombiervalue is <b><tt>/DeviceRGB</tt></b>.  Note that this does not affect images:
192*593dc095SDavid du Colombiersee <a href="#Limitations">Limitations</a> below.
1933ff48bf5SDavid du Colombier
1943ff48bf5SDavid du Colombier</dl>
1953ff48bf5SDavid du Colombier
1963ff48bf5SDavid du Colombier<p>
1973ff48bf5SDavid du ColombierMore importantly, <em>options</em> may include
1987dd7cddfSDavid du Colombier<b><tt>-d</tt></b><em>parameter</em>=<em>value</em> or
1997dd7cddfSDavid du Colombier<b><tt>-s</tt></b><em>parameter</em>=<em>string</em> switches for setting
2007dd7cddfSDavid du Colombier"distiller parameters", Adobe's documented parameters for controlling the
2017dd7cddfSDavid du Colombierconversion process.  The PostScript <b><tt>setdistillerparams</tt></b> and
2027dd7cddfSDavid du Colombier<b><tt>currentdistillerparams</tt></b> operators are also recognized when
2037dd7cddfSDavid du Colombierrunning <b><tt>ps2pdf</tt></b>, and provide an equivalent way to set these
2047dd7cddfSDavid du Colombierparameters from within the PostScript input file.
2057dd7cddfSDavid du Colombier
2067dd7cddfSDavid du Colombier<p>
207*593dc095SDavid du Colombier<b><tt>ps2pdf</tt></b> also recognizes the following options:
2083ff48bf5SDavid du Colombier
2093ff48bf5SDavid du Colombier<dl>
210*593dc095SDavid du Colombier
211*593dc095SDavid du Colombier<dt><b><tt>-dCompressFonts=</tt></b><em>boolean</em>
212*593dc095SDavid du Colombier<dd>Defines whether <b><tt>ps2pdf</tt></b> will compress embedded fonts in
213*593dc095SDavid du Colombierthe output.  The default value is <b><tt>true</tt></b>; the
214*593dc095SDavid du Colombier<b><tt>false</tt></b> setting is intended only for debugging.
215*593dc095SDavid du Colombier
216*593dc095SDavid du Colombier<dt><b><tt>-dMaxInlineImageSize=</tt></b><em>integer</em>
217*593dc095SDavid du Colombier<dd>Specifies the maximum size of an inline image, in bytes. For images larger
218*593dc095SDavid du Colombierthan this size, <b><tt>ps2pdf</tt></b> will create an XObject instead of embedding
219*593dc095SDavid du Colombierthe image into the context stream.
220*593dc095SDavid du ColombierThe default value is <b><tt>4000</tt></b>.
221*593dc095SDavid du ColombierNote that redundant inline images must be embedded each time they occur in the
222*593dc095SDavid du Colombierdocument, while multiple references can be made to a single XObject image. Therefore
223*593dc095SDavid du Colombierit may be advantageous to set a small or zero value if the source document is expected
224*593dc095SDavid du Colombierto contain multiple identical images, reducing the size of the generated PDF.
225*593dc095SDavid du Colombier
2263ff48bf5SDavid du Colombier<dt><b><tt>-dPDFSETTINGS=</tt></b><em>configuration</em>
2273ff48bf5SDavid du Colombier<dd>Presets the "distiller parameters" to one of four predefined settings:
2283ff48bf5SDavid du Colombier
2293ff48bf5SDavid du Colombier<ul>
2303ff48bf5SDavid du Colombier
2313ff48bf5SDavid du Colombier<li><b><tt>/screen</tt></b> selects low-resolution output similar to the
2323ff48bf5SDavid du ColombierAcrobat Distiller "Screen Optimized" setting.
2333ff48bf5SDavid du Colombier
234*593dc095SDavid du Colombier<li><b><tt>/ebook</tt></b> selects medium-resolution output similar to the
235*593dc095SDavid du ColombierAcrobat Distiller "eBook" setting.
236*593dc095SDavid du Colombier
2373ff48bf5SDavid du Colombier<li><b><tt>/printer</tt></b> selects output similar to the Acrobat Distiller
2383ff48bf5SDavid du Colombier"Print Optimized" setting.
2393ff48bf5SDavid du Colombier
2403ff48bf5SDavid du Colombier<li><b><tt>/prepress</tt></b> selects output similar to Acrobat Distiller
2413ff48bf5SDavid du Colombier"Prepress Optimized" setting.
2423ff48bf5SDavid du Colombier
2433ff48bf5SDavid du Colombier<li><b><tt>/default</tt></b> selects output intended to be useful across a
2443ff48bf5SDavid du Colombierwide variety of uses, possibly at the expense of a larger output file.
2453ff48bf5SDavid du Colombier
2463ff48bf5SDavid du Colombier</ul>
2473ff48bf5SDavid du Colombier
2483ff48bf5SDavid du Colombier</dl>
2493ff48bf5SDavid du Colombier
2503ff48bf5SDavid du Colombier<p>
251*593dc095SDavid du ColombierThe following option controls a conversion into PDF/X-3:
252*593dc095SDavid du Colombier<p>
253*593dc095SDavid du Colombier
254*593dc095SDavid du Colombier<dl>
255*593dc095SDavid du Colombier<dt><b><tt>-dPDFX=</tt></b><em>boolean</em>
256*593dc095SDavid du Colombier<dd>Specifies the generated document to follow the PDF/X-3 standard.
257*593dc095SDavid du ColombierWhen true, a <b><tt>DefaultRGB</b></tt> <b><tt>ColorSpace</b></tt> resource must be defined, and
258*593dc095SDavid du Colombieroptions <b><tt>NOSUBSTDEVICECOLORS</b></tt>, <b><tt>NOCIE</b></tt> must not be specified.
259*593dc095SDavid du ColombierDefault value is <b><tt>false</b></tt>.
260*593dc095SDavid du Colombier</dl>
261*593dc095SDavid du Colombier
262*593dc095SDavid du Colombier<p>
263*593dc095SDavid du Colombier
264*593dc095SDavid du ColombierWhen generating a PDF/X-3 document, Ghostscript performs the following
265*593dc095SDavid du Colombierspecial actions to satisfy the PDF/X-3 standard :
266*593dc095SDavid du Colombier<ul>
267*593dc095SDavid du Colombier<li> All fonts are being embedded.
268*593dc095SDavid du Colombier<li> <b><tt>DeviceRGB</b></tt> color space is being substituted with <b><tt>DefaultRGB</b></tt> color space,
269*593dc095SDavid du Colombierwhich must be defined in the <b><tt>ColorSpace</b></tt> category.
270*593dc095SDavid du ColombierThe easiest way is to provide it in the <b><tt>DefaultRGB</b></tt> file in the resource directory.
271*593dc095SDavid du Colombier<li> <b><tt>DeviceRGB</b></tt> color values are being passed unchanged.
272*593dc095SDavid du ColombierIf an user needs an untrivial color adjustment, an untrivial <b><tt>DefaultRGB</b></tt> color space to be
273*593dc095SDavid du Colombierdefined.
274*593dc095SDavid du Colombier<li> Transfer functions and halftone phases are being skipped.
275*593dc095SDavid du Colombier<li> <b><tt>/PS pdfmark</b></tt> interpretes the <b><tt>DataSource</b></tt> stream or file.
276*593dc095SDavid du Colombier</ul>
277*593dc095SDavid du Colombier
278*593dc095SDavid du Colombier
279*593dc095SDavid du Colombier<p>
280*593dc095SDavid du ColombierThe following options control a conversion into PDF 1.2:
281*593dc095SDavid du Colombier<p>
282*593dc095SDavid du Colombier
283*593dc095SDavid du Colombier<dl>
284*593dc095SDavid du Colombier
285*593dc095SDavid du Colombier<dt><b><tt>-dPatternImagemask=</tt></b><em>boolean</em>
286*593dc095SDavid du Colombier<dd>With <b><tt>CompatibilityLevel &LT 1.3 </b></tt> it specifies whether the target viewer
287*593dc095SDavid du Colombierhandles <b><tt>ImageMask</b></tt> with a pattern color. Some old viewers,
288*593dc095SDavid du Colombiersuch as Ghostscript 3.30 fail with such constructs.
289*593dc095SDavid du ColombierSeting this option to false, one can get more compatibility,
290*593dc095SDavid du Colombierbut the mask interpolation is lost.
291*593dc095SDavid du ColombierWith <b><tt>CompatibilityLevel &GT= 1.3 </b></tt> this option is being ignored.
292*593dc095SDavid du ColombierDefault value is <b><tt>false</b></tt>.
293*593dc095SDavid du Colombier
294*593dc095SDavid du Colombier<dt><b><tt>-dMaxClipPathSize=</tt></b><em>integer</em>
295*593dc095SDavid du Colombier<dd>Specifies the maximum number of elements in the clipping path
296*593dc095SDavid du Colombierthat the target viewer can handle. This option is used only with
297*593dc095SDavid du Colombier<b><tt>CompatibilityLevel &LT 1.3 </b></tt> and <b><tt>PatternImagemask=false</tt></b>,
298*593dc095SDavid du Colombierand only when converting a mask into a clipping path.
299*593dc095SDavid du ColombierIf the clipping path exceeds the specified size,
300*593dc095SDavid du Colombierthe masked image and the clipping path is being decomposed into smaller images.
301*593dc095SDavid du ColombierThe value of the option counts straight path segments
302*593dc095SDavid du Colombier(curved segments are not used for representing a mask).
303*593dc095SDavid du ColombierDefault value is <b><tt>12000</b></tt>.
304*593dc095SDavid du Colombier
305*593dc095SDavid du Colombier<dt><b><tt>-dMaxShadingBitmapSize=</tt></b><em>integer</em>
306*593dc095SDavid du Colombier<dd>With <b><tt>CompatibilityLevel &LT 1.3 </b></tt> it specifies
307*593dc095SDavid du Colombierthe maximum number of bytes allowed for representing a shading as a bitmap.
308*593dc095SDavid du ColombierIf a shading exceeds this value, the resolution of the output bitmap
309*593dc095SDavid du Colombieris being reduces to fit into the specified frame.
310*593dc095SDavid du ColombierNote that the number of bytes depends on the number of color components
311*593dc095SDavid du Colombierin <b><tt>ProcessColorModel</b></tt>, assumes 8 bits per sample,
312*593dc095SDavid du Colombierand doesn't account an image compression or filtering.
313*593dc095SDavid du ColombierAlso note that reducing the resolution results unsmooth shading boundaries.
314*593dc095SDavid du Colombier
315*593dc095SDavid du ColombierWith <b><tt>CompatibilityLevel &GT= 1.3 </b></tt> this option is being ignored.
316*593dc095SDavid du ColombierDefault value is <b><tt>256000</b></tt>.
317*593dc095SDavid du ColombierFor the best quality one can set the maximal integer value,
318*593dc095SDavid du Colombierbut the output file size may dramatically increase.
319*593dc095SDavid du ColombierTherefore the user should choose a compromise value.
320*593dc095SDavid du Colombier
321*593dc095SDavid du Colombier<dt><b><tt>-dHaveTrueTypes=</tt></b><em>boolean</em>
322*593dc095SDavid du Colombier<dd>With <b><tt>CompatibilityLevel &LT 1.3 </b></tt> it specifies
323*593dc095SDavid du Colombierwhether the target viewer can handle TrueType fonts.
324*593dc095SDavid du ColombierIf not, TrueType fonts are being converted into raster fonts
325*593dc095SDavid du Colombierwith resolution specified in </b></tt>HWResolution</b></tt>.
326*593dc095SDavid du ColombierWith <b><tt>CompatibilityLevel &GT= 1.3 </b></tt> this option is being ignored.
327*593dc095SDavid du ColombierDefault value is <b><tt>true</b></tt>.
328*593dc095SDavid du Colombier
329*593dc095SDavid du Colombier</dl>
330*593dc095SDavid du Colombier
331*593dc095SDavid du Colombier<p>
332*593dc095SDavid du ColombierThe following option controls a conversion into PDF 1.3:
333*593dc095SDavid du Colombier<p>
334*593dc095SDavid du Colombier
335*593dc095SDavid du Colombier<dl>
336*593dc095SDavid du Colombier
337*593dc095SDavid du Colombier<dt><b><tt>-dHaveTransparency=</tt></b><em>boolean</em>
338*593dc095SDavid du Colombier<dd>With <b><tt>CompatibilityLevel &GT= 1.4 </b></tt> it specifies
339*593dc095SDavid du Colombierwhether the target viewer can handle PDF 1.4 transparency objects.
340*593dc095SDavid du ColombierIf not, transparency objects are being converted into plain images.
341*593dc095SDavid du ColombierDefault value is <b><tt>true</b></tt>.
342*593dc095SDavid du Colombier
343*593dc095SDavid du Colombier</dl>
344*593dc095SDavid du Colombier
345*593dc095SDavid du Colombier<a name="Encryption"></a>
346*593dc095SDavid du ColombierThe following switches are used for creating encrypted documents :
347*593dc095SDavid du Colombier
348*593dc095SDavid du Colombier<dl>
349*593dc095SDavid du Colombier<dt><b><tt>-sOwnerPassword=</tt></b><em>string</em>
350*593dc095SDavid du Colombier<dd>Defines that the document be encrypted with the specified
351*593dc095SDavid du Colombierowner password.
352*593dc095SDavid du Colombier</dl>
353*593dc095SDavid du Colombier
354*593dc095SDavid du Colombier<dl>
355*593dc095SDavid du Colombier<dt><b><tt>-sUserPassword=</tt></b><em>string</em>
356*593dc095SDavid du Colombier<dd>Defines the user password for opening the document.
357*593dc095SDavid du ColombierIf empty, the document can be opened with no password,
358*593dc095SDavid du Colombierbut the owner password is required to edit it.
359*593dc095SDavid du Colombier</dl>
360*593dc095SDavid du Colombier
361*593dc095SDavid du Colombier<dl>
362*593dc095SDavid du Colombier<dt><b><tt>-dPermissions=</tt></b><em>number</em>
363*593dc095SDavid du Colombier<dd>Defines the PDF permissions flag field. Negative values are allowed
364*593dc095SDavid du Colombierto represent unsigned integers with the highest bit set. See the PDF
365*593dc095SDavid du ColombierReference manual for the meaning of the flag bits.
366*593dc095SDavid du Colombier</dl>
367*593dc095SDavid du Colombier
368*593dc095SDavid du Colombier<dl>
369*593dc095SDavid du Colombier<dt><b><tt>-dEncryptionR=</tt></b><em>number</em>
370*593dc095SDavid du Colombier<dd>Defines the encryption method revision number - either 2 or 3.
371*593dc095SDavid du Colombier</dl>
372*593dc095SDavid du Colombier
373*593dc095SDavid du Colombier<dl>
374*593dc095SDavid du Colombier<dt><b><tt>-dKeyLength=</tt></b><em>number</em>
375*593dc095SDavid du Colombier<dd>Defines the length (in bits) of the encryption key.
376*593dc095SDavid du ColombierMust be a multiple of 8 in the interval [40, 128].
377*593dc095SDavid du ColombierIf the length isn't 40, <b><tt>-dEncryptionR</tt></b> must be 3.
378*593dc095SDavid du Colombier</dl>
379*593dc095SDavid du Colombier
380*593dc095SDavid du Colombier
381*593dc095SDavid du Colombier<p>
382*593dc095SDavid du Colombier<b><tt>ps2pdf</tt></b> recognizes all of the Acrobat Distiller 5 parameters
383*593dc095SDavid du Colombierdefined in the DistillerParameters document included in the
384*593dc095SDavid du Colombier<a href="http://partners.adobe.com/public/developer/acrobat/sdk/index.html">Acrobat SDK</a>.
385*593dc095SDavid du ColombierCells in the table
386*593dc095SDavid du Colombiercontaining '=' mean that the value of the parameter is the same as in the
387*593dc095SDavid du Colombier"default" column.
3887dd7cddfSDavid du Colombier
3897dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
3907dd7cddfSDavid du Colombier<tr valign=bottom>
3917dd7cddfSDavid du Colombier	<th align=left>Parameter name
3927dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;&nbsp;
3937dd7cddfSDavid du Colombier	<th align=left>Notes
3943ff48bf5SDavid du Colombier	<td>&nbsp;&nbsp;
3953ff48bf5SDavid du Colombier	<th align=left>default
3963ff48bf5SDavid du Colombier	<td>&nbsp;&nbsp;
3973ff48bf5SDavid du Colombier	<th align=left>screen
3983ff48bf5SDavid du Colombier	<td>&nbsp;&nbsp;
399*593dc095SDavid du Colombier	<th align=left>ebook
400*593dc095SDavid du Colombier	<td>&nbsp;&nbsp;
4013ff48bf5SDavid du Colombier	<th align=left>printer
4023ff48bf5SDavid du Colombier	<td>&nbsp;&nbsp;
4033ff48bf5SDavid du Colombier	<th align=left>prepress
404*593dc095SDavid du Colombier<tr>	<td colspan=13><hr>
405*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AlwaysEmbed</tt></b><td><td><td><td>[]<td><td>=<td><td>=<td><td>=<td><td>=
406*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AntiAliasColorImages</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
407*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AntiAliasGrayImages</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
408*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AntiAliasMonoImages</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
409*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ASCII85EncodePages</tt></b><td><td><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
410*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AutoFilterColorImages</tt></b><td><td><a href="#note_1">(1)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
411*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AutoFilterGrayImages</tt></b><td><td><a href="#note_1">(1)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
412*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AutoPositionEPSFiles</tt></b><td><td><a href="#note_0">(0)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
413*593dc095SDavid du Colombier<tr valign=top><td><b><tt>AutoRotatePages</tt></b><td><td><td><td>/PageByPage<td><td>/PageByPage<td><td>/All<td><td>/None<td><td>/None
414*593dc095SDavid du Colombier<tr valign=top><td><b><tt>Binding</tt></b><td><td><a href="#note_0">(0)</a><td><td>/Left<td><td>=<td><td>=<td><td>=<td><td>=
415*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CalCMYKProfile</tt></b><td><td><a href="#note_0">(0)</a><td><td>()<td><td>=<td><td>=<td><td>=<td><td>=
416*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CalGrayProfile</tt></b><td><td><a href="#note_0">(0)</a><td><td>()<td><td>=<td><td>=<td><td>=<td><td>=
417*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CalRGBProfile</tt></b><td><td><a href="#note_0">(0)</a><td><td>()<td><td>=<td><td>=<td><td>=<td><td>=
418*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CannotEmbedFontPolicy</tt></b><td><td><a href="#note_0">(0)</a><td><td>/Warning<td><td>/Warning<td><td>/Warning<td><td>/Warning<td><td>/Error
419*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorACSImageDict</tt></b><td><td><td><td><a href="#note_7">(note 7)</a><td><td><a href="#note_10">(note 10)</a><td><td><a href="#note_10">(note 10)</a><td><td><a href="#note_8">(note 8)</a><td><td><a href="#note_9">(note 9)</a>
420*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorConversionStrategy</tt></b><td><td><a href="#note_0">(0</a>,<a href="#note_6">6)</a><td><td>/LeaveColorUnchanged<td><td>/sRGB<td><td>/sRGB<td><td>/UseDeviceIndependentColor<td><td>/LeaveColorUnchanged
421*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorImageDepth</tt></b><td><td><td><td>-1<td><td>=<td><td>=<td><td>=<td><td>=
422*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorImageDict</tt></b><td><td><td><td><a href="#note_7">(note 7)</a><td><td>=<td><td>=<td><td>=<td><td>=
423*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorImageFilter</tt></b><td><td><td><td>/DCTEncode<td><td>=<td><td>=<td><td>=<td><td>=
424*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorImageDownsampleThreshold</tt></b><td><td><td><td>1.5<td><td>=<td><td>=<td><td>=<td><td>=
425*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorImageDownsampleType</tt></b><td><td><a href="#note_3">(3)</a><td><td>/Subsample<td><td>/Average<td><td>/Bicubic<td><td>/Bicubic<td><td>/Bicubic
426*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ColorImageResolution</tt></b><td><td><td><td>72<td><td>72<td><td>150<td><td>300<td><td>300
427*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CompatibilityLevel</tt></b><td><td><td><td>1.4<td><td>1.3<td><td>1.4<td><td>1.4<td><td>1.4
428*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CompressPages</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
429*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ConvertCMYKImagesToRGB</tt></b><td><td><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
430*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ConvertImagesToIndexed</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
431*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CoreDistVersion</tt></b><td><td><td><td>4000<td><td>=<td><td>=<td><td>=<td><td>=
432*593dc095SDavid du Colombier<tr valign=top><td><b><tt>CreateJobTicket</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>false<td><td>false<td><td>true<td><td>true
433*593dc095SDavid du Colombier<tr valign=top><td><b><tt>DefaultRenderingIntent</tt></b><td><td><td><td>/Default<td><td>=<td><td>=<td><td>=<td><td>=
434*593dc095SDavid du Colombier<tr valign=top><td><b><tt>DetectBlends</tt></b><td><td><a href="#note_0">(0)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
435*593dc095SDavid du Colombier<tr valign=top><td><b><tt>DoThumbnails</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>false<td><td>false<td><td>false<td><td>true
436*593dc095SDavid du Colombier<tr valign=top><td><b><tt>DownsampleColorImages</tt></b><td><td><td><td>false<td><td>true<td><td>true<td><td>false<td><td>false
437*593dc095SDavid du Colombier<tr valign=top><td><b><tt>DownsampleGrayImages</tt></b><td><td><td><td>false<td><td>true<td><td>true<td><td>false<td><td>false
438*593dc095SDavid du Colombier<tr valign=top><td><b><tt>DownsampleMonoImages</tt></b><td><td><td><td>false<td><td>true<td><td>true<td><td>false<td><td>false
439*593dc095SDavid du Colombier<tr valign=top><td><b><tt>EmbedAllFonts</tt></b><td><td><td><td>true<td><td>false<td><td>true<td><td>true<td><td>true
440*593dc095SDavid du Colombier<tr valign=top><td><b><tt>EmitDSCWarnings</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
441*593dc095SDavid du Colombier<tr valign=top><td><b><tt>EncodeColorImages</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
442*593dc095SDavid du Colombier<tr valign=top><td><b><tt>EncodeGrayImages</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
443*593dc095SDavid du Colombier<tr valign=top><td><b><tt>EncodeMonoImages</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
444*593dc095SDavid du Colombier<tr valign=top><td><b><tt>EndPage</tt></b><td><td><a href="#note_0">(0)</a><td><td>-1<td><td>=<td><td>=<td><td>=<td><td>=
445*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayACSImageDict</tt></b><td><td><td><td><a href="#note_7">(note 7)</a><td><td><a href="#note_7">(note 7)</a><td><td><a href="#note_10">(note 10)</a><td><td><a href="#note_8">(note 8)</a><td><td><a href="#note_9">(note 9)</a>
446*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayImageDepth</tt></b><td><td><td><td>-1<td><td>=<td><td>=<td><td>=<td><td>=
447*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayImageDict</tt></b><td><td><td><td><a href="#note_7">(note 7)</a><td><td>=<td><td>=<td><td>=<td><td>=
448*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayImageDownsampleThreshold</tt></b><td><td><td><td>1.5<td><td>=<td><td>=<td><td>=<td><td>=
449*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayImageDownsampleType</tt></b><td><td><a href="#note_3">(3)</a><td><td>/Subsample<td><td>/Average<td><td>/Bicubic<td><td>/Bicubic<td><td>/Bicubic
450*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayImageFilter</tt></b><td><td><td><td>/DCTEncode<td><td>=<td><td>=<td><td>=<td><td>=
451*593dc095SDavid du Colombier<tr valign=top><td><b><tt>GrayImageResolution</tt></b><td><td><td><td>72<td><td>72<td><td>150<td><td>300<td><td>300
452*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ImageMemory</tt></b><td><td><a href="#note_0">(0)</a><td><td>524288<td><td>=<td><td>=<td><td>=<td><td>=
453*593dc095SDavid du Colombier<tr valign=top><td><b><tt>LockDistillerParams</tt></b><td><td><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
454*593dc095SDavid du Colombier<tr valign=top><td><b><tt>LZWEncodePages</tt></b><td><td><a href="#note_2">(2)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
455*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MaxSubsetPct</tt></b><td><td><td><td>100<td><td>=<td><td>=<td><td>=<td><td>=
456*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MonoImageDepth</tt></b><td><td><td><td>-1<td><td>=<td><td>=<td><td>=<td><td>=
457*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MonoImageDict</tt></b><td><td><td><td><<K -1>><td><td>=<td><td>=<td><td>=<td><td>=
458*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MonoImageDownsampleThreshold</tt></b><td><td><td><td>1.5<td><td>=<td><td>=<td><td>=<td><td>=
459*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MonoImageDownsampleType</tt></b><td><td><td><td>/Subsample<td><td>/Average<td><td>/Bicubic<td><td>/Bicubic<td><td>/Bicubic
460*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MonoImageFilter</tt></b><td><td><td><td>/CCITTFaxEncode<td><td>=<td><td>=<td><td>=<td><td>=
461*593dc095SDavid du Colombier<tr valign=top><td><b><tt>MonoImageResolution</tt></b><td><td><td><td>300<td><td>300<td><td>300<td><td>1200<td><td>1200
462*593dc095SDavid du Colombier<tr valign=top><td><b><tt>NeverEmbed</tt></b><td><td><td><td><a href="#note_11">(note 11)</a><a href="#note_12">(note 12)</a><td><td><a href="#note_11">(note 11)</a><a href="#note_12">(note 12)</a><td><td><a href="#note_11">(note 11)</a><a href="#note_12">(note 12)</a><td><td>[]<a href="#note_12">(note 12)</a><td><td>[]<a href="#note_12">(note 12)</a>
463*593dc095SDavid du Colombier<tr valign=top><td><b><tt>OffOptimizations</tt></b><td><td><td><td>0<td><td>=<td><td>=<td><td>=<td><td>=
464*593dc095SDavid du Colombier<tr valign=top><td><b><tt>OPM</tt></b><td><td><td><td>1<td><td>=<td><td>=<td><td>=<td><td>=
465*593dc095SDavid du Colombier<tr valign=top><td><b><tt>Optimize</tt></b><td><td><a href="#note_0">(0</a>,<a href="#note_5">5)</a><td><td>false<td><td>true<td><td>true<td><td>true<td><td>true
466*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ParseDSCComments</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
467*593dc095SDavid du Colombier<tr valign=top><td><b><tt>ParseDSCCommentsForDocInfo</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
468*593dc095SDavid du Colombier<tr valign=top><td><b><tt>PreserveCopyPage</tt></b><td><td><a href="#note_0">(0)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
469*593dc095SDavid du Colombier<tr valign=top><td><b><tt>PreserveEPSInfo</tt></b><td><td><a href="#note_0">(0)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
470*593dc095SDavid du Colombier<tr valign=top><td><b><tt>PreserveHalftoneInfo</tt></b><td><td><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
471*593dc095SDavid du Colombier<tr valign=top><td><b><tt>PreserveOPIComments</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>false<td><td>false<td><td>true<td><td>true
472*593dc095SDavid du Colombier<tr valign=top><td><b><tt>PreserveOverprintSettings</tt></b><td><td><td><td>false<td><td>false<td><td>false<td><td>true<td><td>true
473*593dc095SDavid du Colombier<tr valign=top><td><b><tt>sRGBProfile</tt></b><td><td><a href="#note_0">(0)</a><td><td>()<td><td>=<td><td>=<td><td>=<td><td>=
474*593dc095SDavid du Colombier<tr valign=top><td><b><tt>StartPage</tt></b><td><td><a href="#note_0">(0)</a><td><td>1<td><td>=<td><td>=<td><td>=<td><td>=
475*593dc095SDavid du Colombier<tr valign=top><td><b><tt>SubsetFonts</tt></b><td><td><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
476*593dc095SDavid du Colombier<tr valign=top><td><b><tt>TransferFunctionInfo</tt></b><td><td><a href="#note_4">(4)</a><td><td>/Preserve<td><td>=<td><td>=<td><td>=<td><td>=
477*593dc095SDavid du Colombier<tr valign=top><td><b><tt>UCRandBGInfo</tt></b><td><td><td><td>/Remove<td><td>/Remove<td><td>/Remove<td><td>/Preserve<td><td>/Preserve
478*593dc095SDavid du Colombier<tr valign=top><td><b><tt>UseFlateCompression</tt></b><td><td><a href="#note_2">(2)</a><td><td>true<td><td>=<td><td>=<td><td>=<td><td>=
479*593dc095SDavid du Colombier<tr valign=top><td><b><tt>UsePrologue</tt></b><td><td><a href="#note_0">(0)</a><td><td>false<td><td>=<td><td>=<td><td>=<td><td>=
4807dd7cddfSDavid du Colombier</table></blockquote>
4817dd7cddfSDavid du Colombier
4827dd7cddfSDavid du Colombier<p>
483*593dc095SDavid du Colombier<a name="note_0">(note 0)</a>
484*593dc095SDavid du ColombierThis parameter can be set and queried, but currently has no effect.
4853ff48bf5SDavid du Colombier
4863ff48bf5SDavid du Colombier<p>
487*593dc095SDavid du Colombier<a name="note_1">(note 1)</a>
488*593dc095SDavid du ColombierCurrently, <b><tt>AutoFilterxxxImages</tt></b> doesn't examine the image to
489*593dc095SDavid du Colombierdecide between JPEG and LZW or Flate compression: it always uses
490*593dc095SDavid du ColombierFlate compression.  If you want to force JPEG compression, use
491*593dc095SDavid du Colombier<b><tt>-dAutoFilterxxxImages=false</tt></b>.
4927dd7cddfSDavid du Colombier
4937dd7cddfSDavid du Colombier<p>
494*593dc095SDavid du Colombier<a name="note_2">(note 2)</a>
495*593dc095SDavid du ColombierBecause of Unisys's threats regarding the Welch patent,
496*593dc095SDavid du Colombier<b><tt>ps2pdf</tt></b> does not actually use LZW compression: instead, it
497*593dc095SDavid du Colombiertreats all requests for LZW compression as calling for Flate compression.
498*593dc095SDavid du ColombierConcomitantly, <tt>UseFlateCompression</tt> is treated as always on, and
499*593dc095SDavid du Colombierthe value of this parameter is ignored as with note 0. Now that the patent
500*593dc095SDavid du Colombierhas expired, we could change this should it become worthwhile.
5017dd7cddfSDavid du Colombier
5027dd7cddfSDavid du Colombier<p>
503*593dc095SDavid du Colombier<a name="note_3">(note 3)</a>
504*593dc095SDavid du ColombierThe <b><tt>xxxDownsampleType</tt></b> parameters can also have the value
505*593dc095SDavid du Colombier/Bicubic (a Distiller 4 feature), which is currently treated as equivalent
506*593dc095SDavid du Colombierto /Average.
5077dd7cddfSDavid du Colombier
5087dd7cddfSDavid du Colombier<p>
509*593dc095SDavid du Colombier<a name="note_4">(note 4)</a>
510*593dc095SDavid du ColombierCurrently, the transfer function is always applied.  If the corresponding
511*593dc095SDavid du Colombierparameter is set to <b><tt>/Preserve</tt></b>, the function setting is also
512*593dc095SDavid du Colombiercopied into the PDF file.
51380ee5cbfSDavid du Colombier
51480ee5cbfSDavid du Colombier<p>
515*593dc095SDavid du Colombier<a name="note_5">(note 5)</a>
516*593dc095SDavid du ColombierOptimization (linearization) is implemented with a separate program,
517*593dc095SDavid du Colombier<b><tt>pdfopt</tt></b> <em>input.pdf</em> <em>output.pdf</em>; the
5183ff48bf5SDavid du Colombier<b><tt>Optimize</tt></b> parameter has no effect.
5193ff48bf5SDavid du Colombier
5203ff48bf5SDavid du Colombier<p>
521*593dc095SDavid du Colombier<a name="note_6">(note 6)</a>
522*593dc095SDavid du ColombierCurrently, colors for images and shadings are left in the color space
523*593dc095SDavid du Colombierspecified in the PostScript input, except for
5243ff48bf5SDavid du Colombier<b><tt>ConvertCMYKImagesToRGB</tt></b>; the current color in the graphics
5253ff48bf5SDavid du Colombierstate (used for fill, stroke, text, and imagemask) is always converted to
5263ff48bf5SDavid du Colombierthe color space specified by the current value of
5273ff48bf5SDavid du Colombier<b><tt>ProcessColorModel</tt></b>. The intended behavior is the same as for
5283ff48bf5SDavid du ColombierAcrobat Distiller, except that if <b><tt>ColorConversionStrategy</tt></b> is
5293ff48bf5SDavid du Colombierset to <b><tt>/UseDeviceDependentColor</tt></b>, colors are converted to the
5303ff48bf5SDavid du Colombiercolor space specified by <b><tt>ProcessColorModel</tt></b> rather than
5313ff48bf5SDavid du Colombieralways to <b><tt>/DeviceRGB</tt></b>.
5323ff48bf5SDavid du Colombier
5333ff48bf5SDavid du Colombier<p>
534*593dc095SDavid du Colombier<a name="note_7">(note 7)</a>
535*593dc095SDavid du Colombier The default image parameter dictionary is
5363ff48bf5SDavid du Colombier<blockquote><b><tt>
5373ff48bf5SDavid du Colombier<< /QFactor 0.9 /Blend 1 /HSamples [2 1 1 2] /VSamples [2 1 1 2] >>
5383ff48bf5SDavid du Colombier</tt></b></blockquote>
5393ff48bf5SDavid du Colombier
5403ff48bf5SDavid du Colombier<p>
541*593dc095SDavid du Colombier<a name="note_8">(note 8)</a>
542*593dc095SDavid du ColombierThe printer ACS image parameter dictionary is
5433ff48bf5SDavid du Colombier<blockquote><b><tt>
544*593dc095SDavid du Colombier<< /QFactor 0.4 /Blend 1 /ColorTransform 1 /HSamples [1 1 1 1] /VSamples [1 1 1 1] >>
5453ff48bf5SDavid du Colombier</tt></b></blockquote>
5463ff48bf5SDavid du Colombier
5473ff48bf5SDavid du Colombier<p>
548*593dc095SDavid du Colombier<a name="note_9">(note 9)</a>
549*593dc095SDavid du ColombierThe prepress ACS image parameter dictionary is
5503ff48bf5SDavid du Colombier<blockquote><b><tt>
551*593dc095SDavid du Colombier<< /QFactor 0.15 /Blend 1 /ColorTransform 1 /HSamples [1 1 1 1] /VSamples [1 1 1 1] >>
5523ff48bf5SDavid du Colombier</tt></b></blockquote>
5537dd7cddfSDavid du Colombier
554*593dc095SDavid du Colombier<p>
555*593dc095SDavid du Colombier<a name="note_10">(note 10)</a>
556*593dc095SDavid du ColombierThe screen and ebook ACS image parameter dictionary is
557*593dc095SDavid du Colombier<blockquote><b><tt>
558*593dc095SDavid du Colombier<< /QFactor 0.76 /Blend 1 /ColorTransform 1 /HSamples [2 1 1 2] /VSamples [2 1 1 2] >>
559*593dc095SDavid du Colombier</tt></b></blockquote>
560*593dc095SDavid du Colombier
561*593dc095SDavid du Colombier<p>
562*593dc095SDavid du Colombier<a name="note_11">(note 11)</a>
563*593dc095SDavid du ColombierThe default, screen, and ebook settings never embed the 14 standard fonts
564*593dc095SDavid du Colombier(Courier, Helvetica, and Times families, Symbol, and ZapfDingbats).
565*593dc095SDavid du Colombier
566*593dc095SDavid du Colombier<p>
567*593dc095SDavid du Colombier<a name="note_12">(note 12)</a>
568*593dc095SDavid du Colombier<b><tt>NeverEmbed</tt></b> can include CID font names.
569*593dc095SDavid du ColombierIf a CID font is substituted in <b><tt>lib/cidfmap</tt></b>,
570*593dc095SDavid du Colombierthe substitute font name is used when the CID font is embedded,
571*593dc095SDavid du Colombierand the original CID font name is used when it is not embedded.
572*593dc095SDavid du Colombier<b><tt>NeverEmbed</tt></b> should always specify the original CID font
573*593dc095SDavid du Colombiername.
574*593dc095SDavid du Colombier
5757dd7cddfSDavid du Colombier<hr>
5767dd7cddfSDavid du Colombier
577*593dc095SDavid du Colombier<h2><a name="PPD"></a>Ghostscript PDF Printer Description</h2>
578*593dc095SDavid du Colombier<p>
579*593dc095SDavid du ColombierTo assist with creating a PostScript file suitable for conversion
580*593dc095SDavid du Colombierto PDF, ghostscript includes <a href="../lib/ghostpdf.ppd">ghostpdf.ppd</a>,
581*593dc095SDavid du Colombiera PostScript Printer Description (PPD) file.
582*593dc095SDavid du ColombierThis allows some <a href="#Options">distiller parameters</a>
583*593dc095SDavid du Colombierto be set when a PostScript file is generated.
584*593dc095SDavid du Colombier
585*593dc095SDavid du Colombier<h3>Windows XP or 2000</h3>
586*593dc095SDavid du Colombier<p>
587*593dc095SDavid du ColombierTo install a "Ghostscript PDF" printer on Windows XP,
588*593dc095SDavid du Colombierselect the Windows Control Panel,
589*593dc095SDavid du ColombierPrinters and Faxes,
590*593dc095SDavid du ColombierAdd a Printer,
591*593dc095SDavid du ColombierLocal Printer,
592*593dc095SDavid du ColombierUse port FILE: (Print to File),
593*593dc095SDavid du ColombierHave Disk...,
594*593dc095SDavid du Colombierselect the directory containg
595*593dc095SDavid du Colombier<a href="../lib/ghostpdf.ppd">ghostpdf.ppd</a>
596*593dc095SDavid du Colombierand
597*593dc095SDavid du Colombier<a href="../lib/ghostpdf.inf">ghostpdf.inf</a>,
598*593dc095SDavid du Colombierselect "Ghostscript PDF",
599*593dc095SDavid du ColombierReplace existing driver (if asked),
600*593dc095SDavid du Colombierand answer the remaining questions appropriately.
601*593dc095SDavid du ColombierAfter installing, open the "Ghostscript PDF" properties,
602*593dc095SDavid du Colombierselect the Device Settings tab,
603*593dc095SDavid du Colombierset "Mimimum Font Size to Download as Outline" to 0 pixels.
604*593dc095SDavid du Colombier<p>
605*593dc095SDavid du ColombierTo set distiller parameters, select the "Ghostscript PDF"
606*593dc095SDavid du ColombierPrinting Preferences, then the Advanced button.
607*593dc095SDavid du ColombierThe PDF settings are under "Printer Features".
608*593dc095SDavid du Colombier
609*593dc095SDavid du Colombier<hr>
610*593dc095SDavid du Colombier
611*593dc095SDavid du Colombier<h2><a name="PDFX"></a>Creating a PDF/X-3 document</h2>
612*593dc095SDavid du Colombier
613*593dc095SDavid du Colombier<p>
614*593dc095SDavid du Colombier
615*593dc095SDavid du ColombierTo create a PDF/X-3 document from a Postscript or a PDF file, you should :
616*593dc095SDavid du Colombier
617*593dc095SDavid du Colombier<ul>
618*593dc095SDavid du Colombier<li> Specify the <b><tt>pdfwrite</b></tt> device or use the <b><tt>ps2pdf</b></tt> script.
619*593dc095SDavid du Colombier<li> Specify the <b><tt>-dPDFX</b></tt> option. It provides the document conformity
620*593dc095SDavid du Colombier     and forces <b><tt>-dCompatibilityLevel=1.3</b></tt>.
621*593dc095SDavid du Colombier<li> Specify <b><tt>-sProcessColorModel=DeviceGray</b></tt> or <b><tt>-sProcessColorModel=DeviceCMYK</b></tt>
622*593dc095SDavid du Colombier     (<b><tt>DeviceRGB</b></tt> is not allowed).
623*593dc095SDavid du Colombier<li> Specify the <b><tt>-dUseCIEColor</b></tt> option if necessary (see below).
624*593dc095SDavid du Colombier<li> Specify a PDF/X definition file before running the input document.
625*593dc095SDavid du Colombier     It provides additional information to be included into the output document.
626*593dc095SDavid du Colombier     A sample PDF/X definition file may be found in <b><tt>gs/lib/PDFX_def.ps</b></tt>.
627*593dc095SDavid du Colombier<li> Provide an ICC profile and specify it in the PDF/X definition file
628*593dc095SDavid du Colombier     as explained below. Rather PDF/X-3 standard defines the ICC profile
629*593dc095SDavid du Colombier     as optional, we could not get it working with  the PDF/X-3 Inspector freeware.
630*593dc095SDavid du Colombier<li> Provide a <b><tt>DefaultRGB</b></tt> resource file in the ColorSpace resource category.
631*593dc095SDavid du Colombier     Either define it in the PDF/X definition file, or provide
632*593dc095SDavid du Colombier     a definition of <b><tt>gs/Resource/ColorSpace/DefaultRGB</b></tt> .
633*593dc095SDavid du Colombier     Rather <b><tt>gs/Resource/ColorSpace/DefaultRGB</b></tt> is usually
634*593dc095SDavid du Colombier     distributed with Ghostscript, its contents is not necessarily satisfy your needs, see below.
635*593dc095SDavid du Colombier</ul>
636*593dc095SDavid du Colombier
637*593dc095SDavid du Colombier<p>
638*593dc095SDavid du ColombierAs mentioned above, the PDF/X definition file provides a special information,
639*593dc095SDavid du Colombierwhich the PDF/X-3 standard requires. You can find a sample file in
640*593dc095SDavid du Colombier<b><tt>gs/lib/PDFX_def.ps</b></tt>, and edit it according to your needs.
641*593dc095SDavid du ColombierThe file follows Postscript syntax and uses the operator <b><tt>pdfmark</b></tt>
642*593dc095SDavid du Colombierto pass the special information. For your comfort
643*593dc095SDavid du Colombierwe marked editable lines in the sample file with the comment <b><tt>% Customize</b></tt>.
644*593dc095SDavid du ColombierThey are explained below.
645*593dc095SDavid du Colombier
646*593dc095SDavid du Colombier<dl>
647*593dc095SDavid du Colombier<dt><b><tt>ICCProfile</tt></b> <em>string</em>
648*593dc095SDavid du Colombier<dd>Defines a file name of an ICC profile file to be included into the output document.
649*593dc095SDavid du ColombierYou may specify either an absolute file name, or a relative
650*593dc095SDavid du Colombierpath fronm the current directory.
651*593dc095SDavid du Colombier</dl>
652*593dc095SDavid du Colombier
653*593dc095SDavid du Colombier<dl>
654*593dc095SDavid du Colombier<dt><b><tt>Title</tt></b> <em>string</em>
655*593dc095SDavid du Colombier<dd>Defines the document title.
656*593dc095SDavid du Colombier</dl>
657*593dc095SDavid du Colombier
658*593dc095SDavid du Colombier<dl>
659*593dc095SDavid du Colombier<dt><b><tt>Info</tt></b> <em>string</em>
660*593dc095SDavid du Colombier<dd>Defines an <b><tt>Info</tt></b> value for the output intent dictionary.
661*593dc095SDavid du Colombier</dl>
662*593dc095SDavid du Colombier
663*593dc095SDavid du Colombier<dl>
664*593dc095SDavid du Colombier<dt><b><tt>OutputCondition</tt></b> <em>string</em>
665*593dc095SDavid du Colombier<dd>Defines an <b><tt>OutputCondition</tt></b> value for the output intent dictionary.
666*593dc095SDavid du Colombier</dl>
667*593dc095SDavid du Colombier
668*593dc095SDavid du Colombier
669*593dc095SDavid du Colombier<dl>
670*593dc095SDavid du Colombier<dt><b><tt>OutputConditionIdentifier</tt></b> <em>string</em>
671*593dc095SDavid du Colombier<dd>Defines an <b><tt>OutputConditionIdentifier</tt></b> value for the output intent dictionary.
672*593dc095SDavid du Colombier</dl>
673*593dc095SDavid du Colombier
674*593dc095SDavid du Colombier<p>
675*593dc095SDavid du ColombierRather the PDF/X-3 standard requires colors to be adjusted at the
676*593dc095SDavid du Colombierdocument generation time, Ghostscript <em>does not</em> perform any
677*593dc095SDavid du Colombierspecial color conversion. Either colors to be adjusted in advance,
678*593dc095SDavid du Colombieror a proper color conversion to be specified in <b><tt>/DefaultGray</b></tt>,
679*593dc095SDavid du Colombier<b><tt>DefaultRGB</b></tt>,  <b><tt>DefaultCMYK</b></tt> resources of the
680*593dc095SDavid du Colombier<b><tt>ColorSpace</b></tt> resource category,
681*593dc095SDavid du Colombierand the <b><tt>-dUseCIEColor</b></tt> option to be specified
682*593dc095SDavid du Colombierto remap device colors into CIE colors.
683*593dc095SDavid du ColombierThe choice of the ICC profile is also the user's responsibility.
684*593dc095SDavid du Colombier
685*593dc095SDavid du Colombier<p>Please note that if a graphic object can't embed into the output format,
686*593dc095SDavid du ColombierGhostscript converts it into low level objects, using a device color space
687*593dc095SDavid du Colombierspecified in the <b><tt>ProcessColorModel</b></tt> option.
688*593dc095SDavid du ColombierIf you need to adjust those resulting colors, you may substitute
689*593dc095SDavid du Colombierthem with CIE colors, <em>running Ghostscript at second time </em>.
690*593dc095SDavid du ColombierPerforming both actions in a single pass is a subject of further improvements.
691*593dc095SDavid du Colombier
692*593dc095SDavid du Colombier<p>Ghostscript distribution does not contain an ICC profile to be used
693*593dc095SDavid du Colombierfor creating a PDF/X-3 document. Users should either create an appropriate one themselves,
694*593dc095SDavid du Colombieror use one from a public domain, or create one with the PDF/X-3 inspector freeware.
695*593dc095SDavid du Colombier<p>
696*593dc095SDavid du Colombier
697*593dc095SDavid du ColombierHere is a sample command line to invoke Ghostscript for generating a PDF/X-3 document :
698*593dc095SDavid du Colombier<blockquote><b><tt>
699*593dc095SDavid du Colombiergs -dPDFX -dBATCH -dNOPAUSE -dNOOUTERSAVE -dUseCIEColor -sDEVICE=pdfwrite -sOutputFile=out-x3.pdf PDFX_def.ps input.ps
700*593dc095SDavid du Colombier</tt></b></blockquote>
701*593dc095SDavid du Colombier
702*593dc095SDavid du Colombier<p>
703*593dc095SDavid du Colombier<hr>
704*593dc095SDavid du Colombier
7053ff48bf5SDavid du Colombier<h2><a name="Limitations"></a>Limitations</h2>
7067dd7cddfSDavid du Colombier
7077dd7cddfSDavid du Colombier<p>
7087dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b> will sometimes convert PostScript constructs to
7097dd7cddfSDavid du Colombierlower-level ones, even if a higher-level construct is available.  For
7107dd7cddfSDavid du Colombierexample, if the PostScript file uses <b><tt>charpath</tt></b> to set a
7117dd7cddfSDavid du Colombierclipping path consisting of text, <b><tt>ps2pdf</tt></b> will write the
7127dd7cddfSDavid du Colombierclipping path as a path in the PDF file, rather than as text, even though
7137dd7cddfSDavid du ColombierPDF is able to express clipping with text.  This is only a performance
7147dd7cddfSDavid du Colombierissue, and will be improved incrementally over time.
7157dd7cddfSDavid du Colombier
7167dd7cddfSDavid du Colombier<p>
7173ff48bf5SDavid du ColombierSome applications, such as HIGZ, produce PostScript files that use
7183ff48bf5SDavid du Colombierridiculously large coordinates.  On such files, <b><tt>ps2pdf</tt></b> may
7193ff48bf5SDavid du Colombiercause a <b><tt>limitcheck</tt></b> error.  If this occurs, try reducing the
7203ff48bf5SDavid du Colombierdefault internal resolution of 720 dpi by using the <b><tt>-r</tt></b>
7213ff48bf5SDavid du Colombierswitch, e.g., <b><tt>ps2pdf&nbsp;-r300&nbsp;somefile.ps</tt></b>.
7223ff48bf5SDavid du Colombier
7233ff48bf5SDavid du Colombier<p>
7247dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b> ignores the PDF 1.3 (Acrobat 4.x) pdfmarks related to
7257dd7cddfSDavid du Colombierdocument content structure: <b><tt>StRoleMap</tt></b>,
7267dd7cddfSDavid du Colombier<b><tt>StClassMap</tt></b>, <b><tt>StPNE</tt></b>,
7277dd7cddfSDavid du Colombier<b><tt>StBookmarkRoot</tt></b>, <b><tt>StPush</tt></b>,
7287dd7cddfSDavid du Colombier<b><tt>StPop</tt></b>, <b><tt>StPopAll</tt></b>, <b><tt>StBMC</tt></b>,
7297dd7cddfSDavid du Colombier<b><tt>StBDC</tt></b>, <b><tt>EMC</tt></b>, <b><tt>StOBJ</tt></b>,
7307dd7cddfSDavid du Colombier<b><tt>StAttr</tt></b>, <b><tt>StStore</tt></b>, <b><tt>StRetrieve</tt></b>,
7317dd7cddfSDavid du Colombier<b><tt>NamespacePush</tt></b>, <b><tt>NamespacePop</tt></b>, and
7327dd7cddfSDavid du Colombier<b><tt>NI</tt></b>.  While this causes some structural information to be
7337dd7cddfSDavid du Colombieromitted from the output file, the displayed and printed output are normally
7347dd7cddfSDavid du Colombiernot affected.
7357dd7cddfSDavid du Colombier
7363ff48bf5SDavid du Colombier<p>
7373ff48bf5SDavid du Colombier<b><tt>ps2pdf</tt></b> currently has only very limited support for PDF 1.4.
7383ff48bf5SDavid du ColombierIt writes out the blend mode, constant alpha, and text knockout graphics
7393ff48bf5SDavid du Colombierstate parameters, and it handles images with soft masks, but it does not
7403ff48bf5SDavid du Colombierhandle transparency groups, or soft masks in the graphics state.  (Note that
7413ff48bf5SDavid du Colombierthere is no standard way to specify any of these things in PostScript, so
7423ff48bf5SDavid du Colombierthese statements only apply when the input file is already a PDF 1.4 file.)
7433ff48bf5SDavid du Colombier
744*593dc095SDavid du Colombier<p>
745*593dc095SDavid du Colombier<b><tt>ps2pdf</tt></b> provides simplified interface to Ghostscript
746*593dc095SDavid du Colombiercommand line. It is not possible to use <tt><b>-c</tt></b> option or pass
747*593dc095SDavid du Colombiermultiple source files. For the unrestricted access to the command line
748*593dc095SDavid du Colombierparameters, use Ghostscript directly.
749*593dc095SDavid du Colombier
750*593dc095SDavid du Colombier<blockquote><b><tt>
751*593dc095SDavid du Colombiergs -q -dSAFER -dNOPAUSE -dBATCH -sOutputFile=file.pdf </tt></b><em>[more options]</em><b><tt> \<br>
752*593dc095SDavid du Colombier&nbsp;&nbsp;-sDEVICE=pdfwrite -c .setpdfwrite -f </b></tt><em>source1.ps [more files]</em>
753*593dc095SDavid du Colombier</blockquote>
754*593dc095SDavid du Colombier
755*593dc095SDavid du ColombierSee <a href="Language.htm#.setpdfwrite">Language.htm</a> for details
756*593dc095SDavid du Colombierof the <tt>.setpdfwrite</tt> operator.
7577dd7cddfSDavid du Colombier<hr>
7587dd7cddfSDavid du Colombier
7593ff48bf5SDavid du Colombier<h2><a name="Problems"></a>Known problems</h2>
7607dd7cddfSDavid du Colombier
7617dd7cddfSDavid du Colombier<p>
7627dd7cddfSDavid du ColombierDistiller parameters should only be saved by <b><tt>save</tt></b> and
7633ff48bf5SDavid du Colombierrestored by <b><tt>restore</tt></b>, but they are also saved by
7647dd7cddfSDavid du Colombier<b><tt>gsave</tt></b> and restored by <b><tt>grestore</tt></b>.
7657dd7cddfSDavid du Colombier
7667dd7cddfSDavid du Colombier<p>
7677dd7cddfSDavid du ColombierChanging the value of the <b><tt>CompressPages</tt></b> parameter after any
7687dd7cddfSDavid du Colombiermarks have been made on the page may cause a crash.
7697dd7cddfSDavid du Colombier
7707dd7cddfSDavid du Colombier<hr>
7717dd7cddfSDavid du Colombier
7723ff48bf5SDavid du Colombier<h2><a name="Ps2pdf_vs_AD"></a>Comparison of <b><tt>ps2pdf</tt></b> and
7733ff48bf5SDavid du ColombierAcrobat Distiller</h2>
7747dd7cddfSDavid du Colombier
7757dd7cddfSDavid du Colombier<p>
7767dd7cddfSDavid du ColombierAccording to users, the greatest benefit of <b><tt>ps2pdf</tt></b> is that
7777dd7cddfSDavid du Colombierit is more robust than Acrobat Distiller: it will process complex and
7787dd7cddfSDavid du Colombierdifficult PostScript files that Acrobat Distiller is not able to handle.
7797dd7cddfSDavid du Colombier
7807dd7cddfSDavid du Colombier<p>
7817dd7cddfSDavid du ColombierFor certain documents, <b><tt>ps2pdf</tt></b> is much faster than Adobe
7827dd7cddfSDavid du ColombierDistiller, and may be suitable for run-time conversions.  George White,
7837dd7cddfSDavid du Colombiera heavy user of <b><tt>ps2pdf</tt></b>, remarks:
7847dd7cddfSDavid du Colombier
7857dd7cddfSDavid du Colombier<blockquote>
7867dd7cddfSDavid du ColombierI haven't seen a head to head comparison, but Distiller seems
7877dd7cddfSDavid du Colombierslower when running on what should be a faster system (for instance,
7887dd7cddfSDavid du ColombierDistiller on a PPC Mac vs a 25 MHz 68040 NeXT running
7897dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b>), so I think this is fair -- also, one of Mark
7907dd7cddfSDavid du ColombierDoyle's postings indicated that Distiller was not fast enough for use as a
7917dd7cddfSDavid du Colombierrun-time server.  In contrast, I find that I can use <b><tt>ps2pdf</tt></b>
7927dd7cddfSDavid du Colombieras a post-processor during routine document creation.
7937dd7cddfSDavid du Colombier</blockquote>
7947dd7cddfSDavid du Colombier
7957dd7cddfSDavid du Colombier<p>
7967dd7cddfSDavid du ColombierOn the other hand, there are some documents for which <b><tt>ps2pdf</tt></b>
7977dd7cddfSDavid du Colombiermay be much slower than Acrobat Distiller.  Caveat user.
7987dd7cddfSDavid du Colombier
7997dd7cddfSDavid du Colombier<p>
8003ff48bf5SDavid du Colombier<b><tt>ps2pdf</tt></b> usually produces output that is comparable in size to
8013ff48bf5SDavid du Colombierthe output of Acrobat Distiller; however, it sometimes produces much larger
8023ff48bf5SDavid du Colombieroutput, especially if the input file involves pattern fills.
8033ff48bf5SDavid du Colombier
8043ff48bf5SDavid du Colombier<p>
8057dd7cddfSDavid du ColombierMany users report that the combination of <b><tt>ps2pdf</tt></b> with
8063ff48bf5SDavid du ColombierAcrobat Reader is superior to using a generic PostScript viewer
8077dd7cddfSDavid du Colombier(<b><tt>psview</tt></b> or <b><tt>ghostview</tt></b>), particularly for
8087dd7cddfSDavid du Colombierdocuments with many pages where the navigational support in PDF files
8097dd7cddfSDavid du Colombierreduces the overhead involved in navigating conventional PostScript
8107dd7cddfSDavid du Colombierdocuments.
8117dd7cddfSDavid du Colombier
8127dd7cddfSDavid du Colombier<hr>
8137dd7cddfSDavid du Colombier
8143ff48bf5SDavid du Colombier<h2><a name="Acknowledgments"></a>Acknowledgments</h2>
8157dd7cddfSDavid du Colombier
8167dd7cddfSDavid du Colombier<p>
8177dd7cddfSDavid du ColombierThanks to George N. White III &lt;<a href="mailto:aa056@chebucto.ns.ca">aa056@chebucto.ns.ca</a>&gt; of the Ocean
8187dd7cddfSDavid du ColombierSciences Division of the Bedford Institute of Oceanography in Dartmouth,
8197dd7cddfSDavid du ColombierNova Scotia for extensive testing of early versions of
8207dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b>, and for contributing most of this writeup.
8217dd7cddfSDavid du Colombier
8227dd7cddfSDavid du Colombier<p>
8237dd7cddfSDavid du ColombierThanks to Martin Hosken of SIL International &lt;<a
8247dd7cddfSDavid du Colombierhref="http://www.sil.org">http://www.sil.org</a>&gt; for help with testing
8257dd7cddfSDavid du Colombier<b><tt>ps2pdf</tt></b> with a wide variety of international fonts.
8267dd7cddfSDavid du Colombier
8277dd7cddfSDavid du Colombier<!-- [2.0 end contents] ==================================================== -->
8287dd7cddfSDavid du Colombier
8297dd7cddfSDavid du Colombier<!-- [3.0 begin visible trailer] =========================================== -->
8307dd7cddfSDavid du Colombier<hr>
8317dd7cddfSDavid du Colombier
8323ff48bf5SDavid du Colombier<p>
833*593dc095SDavid du Colombier<small>Copyright &copy; 1996, 2000, 2004 artofcode LLC.  All rights
8343ff48bf5SDavid du Colombierreserved.</small>
8357dd7cddfSDavid du Colombier
8367dd7cddfSDavid du Colombier<p>
837*593dc095SDavid du ColombierThis software is provided AS-IS with no warranty, either express or
838*593dc095SDavid du Colombierimplied.
839*593dc095SDavid du Colombier
840*593dc095SDavid du ColombierThis software is distributed under license and may not be copied,
841*593dc095SDavid du Colombiermodified or distributed except as expressly authorized under the terms
842*593dc095SDavid du Colombierof the license contained in the file LICENSE in this distribution.
843*593dc095SDavid du Colombier
844*593dc095SDavid du ColombierFor more information about licensing, please refer to
845*593dc095SDavid du Colombierhttp://www.ghostscript.com/licensing/. For information on
846*593dc095SDavid du Colombiercommercial licensing, go to http://www.artifex.com/licensing/ or
847*593dc095SDavid du Colombiercontact Artifex Software, Inc., 101 Lucas Valley Road #110,
848*593dc095SDavid du ColombierSan Rafael, CA  94903, U.S.A., +1(415)492-9861.
8497dd7cddfSDavid du Colombier
8503ff48bf5SDavid du Colombier<p>
851*593dc095SDavid du Colombier<small>Ghostscript version 8.53, 20 October 2005
8527dd7cddfSDavid du Colombier
8537dd7cddfSDavid du Colombier<!-- [3.0 end visible trailer] ============================================= -->
8547dd7cddfSDavid du Colombier
8557dd7cddfSDavid du Colombier</body>
8567dd7cddfSDavid du Colombier</html>
857