]> git.saurik.com Git - wxWidgets.git/blame - src/tiff/html/man/tiff2ps.1.html
Merged libtiff 4.0.3 changes into the trunk.
[wxWidgets.git] / src / tiff / html / man / tiff2ps.1.html
CommitLineData
8414a40c 1<!-- Creator : groff version 1.18.1 -->
80ed523f 2<!-- CreationDate: Sat Feb 24 18:37:19 2007 -->
8414a40c
VZ
3<html>
4<head>
5<meta name="generator" content="groff -Thtml, see www.gnu.org">
6<meta name="Content-Style" content="text/css">
7<title>TIFF2PS</title>
8</head>
9<body>
10
11<h1 align=center>TIFF2PS</h1>
12<a href="#NAME">NAME</a><br>
13<a href="#SYNOPSIS">SYNOPSIS</a><br>
14<a href="#DESCRIPTION">DESCRIPTION</a><br>
15<a href="#OPTIONS">OPTIONS</a><br>
16<a href="#EXAMPLES">EXAMPLES</a><br>
17<a href="#BUGS">BUGS</a><br>
8414a40c
VZ
18<a href="#SEE ALSO">SEE ALSO</a><br>
19
20<hr>
21<a name="NAME"></a>
22<h2>NAME</h2>
23<!-- INDENTATION -->
24<table width="100%" border=0 rules="none" frame="void"
25 cols="2" cellspacing="0" cellpadding="0">
26<tr valign="top" align="left">
27<td width="8%"></td>
28<td width="91%">
29<p>tiff2ps &minus; convert a <small>TIFF</small> image to
80ed523f 30PostScript&trade;</p>
8414a40c
VZ
31</td>
32</table>
33<a name="SYNOPSIS"></a>
34<h2>SYNOPSIS</h2>
35<!-- INDENTATION -->
36<table width="100%" border=0 rules="none" frame="void"
37 cols="2" cellspacing="0" cellpadding="0">
38<tr valign="top" align="left">
39<td width="8%"></td>
40<td width="91%">
41<p><b>tiff2ps</b> [ <i>options</i> ] <i>input.tif
42...</i></p>
43</td>
44</table>
45<a name="DESCRIPTION"></a>
46<h2>DESCRIPTION</h2>
47<!-- INDENTATION -->
48<table width="100%" border=0 rules="none" frame="void"
49 cols="2" cellspacing="0" cellpadding="0">
50<tr valign="top" align="left">
51<td width="8%"></td>
52<td width="91%">
53<p><i>tiff2ps</i> reads <small>TIFF</small> images and
80ed523f
VZ
54writes PostScript or Encapsulated PostScript (EPS) on the
55standard output. By default, <i>tiff2ps</i> writes
56Encapsulated PostScript for the first image in the specified
57<small>TIFF</small> image file.</p>
8414a40c 58<!-- INDENTATION -->
80ed523f
VZ
59<p>By default, <i>tiff2ps</i> will generate PostScript that
60fills a printed area specified by the <small>TIFF</small>
61tags in the input file. If the file does not contain
8414a40c
VZ
62<i>XResolution</i> or <i>YResolution</i> tags, then the
63printed area is set according to the image dimensions. The
64<b>&minus;w</b> and <b>&minus;h</b> options (see below) can
65be used to set the dimensions of the printed area in inches;
66overriding any relevant <small>TIFF</small> tags.</p>
67<!-- INDENTATION -->
80ed523f
VZ
68<p>The PostScript generated for <small>RGB,</small> palette,
69and <small>CMYK</small> images uses the <i>colorimage</i>
70operator. The PostScript generated for greyscale and bilevel
71images uses the <i>image</i> operator. When the
72<i>colorimage</i> operator is used, PostScript code to
73emulate this operator on older PostScript printers is also
74generated. Note that this emulation code can be very
75slow.</p>
8414a40c
VZ
76<!-- INDENTATION -->
77<p>Color images with associated alpha data are composited
78over a white background.</p>
79</td>
80</table>
81<a name="OPTIONS"></a>
82<h2>OPTIONS</h2>
83<!-- TABS -->
84<table width="100%" border=0 rules="none" frame="void"
85 cols="5" cellspacing="0" cellpadding="0">
86<tr valign="top" align="left">
87<td width="10%"></td>
88<td width="3%">
89
90<p><b>&minus;1</b></p>
91</td>
92<td width="5%"></td>
93<td width="80%">
94
80ed523f 95<p>Generate PostScript Level 1 (the default).</p>
8414a40c
VZ
96</td>
97<td width="0%">
98</td>
99<tr valign="top" align="left">
100<td width="10%"></td>
101<td width="3%">
102
103<p><b>&minus;2</b></p>
104</td>
105<td width="5%"></td>
106<td width="80%">
107
80ed523f 108<p>Generate PostScript Level 2.</p>
8414a40c
VZ
109</td>
110<td width="0%">
111</td>
112<tr valign="top" align="left">
113<td width="10%"></td>
114<td width="3%">
115
116<p><b>&minus;3</b></p>
117</td>
118<td width="5%"></td>
119<td width="80%">
120
80ed523f
VZ
121<p>Generate PostScript Level 3. It basically allows one to
122use the /flateDecode filter for ZIP compressed TIFF
123images.</p>
8414a40c
VZ
124</td>
125<td width="0%">
126</td>
127<tr valign="top" align="left">
128<td width="10%"></td>
129<td width="3%">
130
131<p><b>&minus;a</b></p>
132</td>
133<td width="5%"></td>
134<td width="80%">
135
136<p>Generate output for all IFDs (pages) in the input
137file.</p>
138</td>
139<td width="0%">
140</td>
141<tr valign="top" align="left">
142<td width="10%"></td>
143<td width="3%">
144
145<p><b>&minus;b</b></p>
146</td>
147<td width="5%"></td>
148<td width="80%">
149
150<p>Specify the bottom margin for the output (in inches).
151This does not affect the height of the printed image.</p>
152</td>
153<td width="0%">
154</td>
155<tr valign="top" align="left">
156<td width="10%"></td>
157<td width="3%">
158
159<p><b>&minus;c</b></p>
160</td>
161<td width="5%"></td>
162<td width="80%">
163
164<p>Center the image in the output. This option only shows
80ed523f
VZ
165an effect if both the <b>&minus;w</b> and the
166<b>&minus;h</b> option are given.</p>
8414a40c
VZ
167</td>
168<td width="0%">
169</td>
170<tr valign="top" align="left">
171<td width="10%"></td>
172<td width="3%">
173
174<p><b>&minus;d</b></p>
175</td>
176<td width="5%"></td>
177<td width="80%">
178
179<p>Set the initial <small>TIFF</small> directory to the
80ed523f 180specified directory number. (NB: Directories are numbered
8414a40c
VZ
181starting at zero.) This option is useful for selecting
182individual pages in a multi-page (e.g. facsimile) file.</p>
183</td>
184<td width="0%">
185</td>
186<tr valign="top" align="left">
187<td width="10%"></td>
188<td width="3%">
189
190<p><b>&minus;e</b></p>
191</td>
192<td width="5%"></td>
193<td width="80%">
194
80ed523f
VZ
195<p>Force the generation of Encapsulated PostScript (implies
196<b>&minus;z</b>).</p>
8414a40c
VZ
197</td>
198<td width="0%">
199</td>
200<tr valign="top" align="left">
201<td width="10%"></td>
202<td width="3%">
203
204<p><b>&minus;h</b></p>
205</td>
206<td width="5%"></td>
207<td width="80%">
208
209<p>Specify the vertical size of the printed area (in
210inches).</p>
211</td>
212<td width="0%">
213</td>
214<tr valign="top" align="left">
215<td width="10%"></td>
216<td width="3%">
217
218<p><b>&minus;H</b></p>
219</td>
220<td width="5%"></td>
221<td width="80%">
222
223<p>Specify the maximum height of image (in inches). Images
224with larger sizes will be split in several pages. Option
225<b>&minus;L</b> may be used for specifying size of split
226images overlapping.</p>
227</td>
228<td width="0%">
229</td>
230<tr valign="top" align="left">
231<td width="10%"></td>
232<td width="3%">
233
234<p><b>&minus;i</b></p>
235</td>
236<td width="5%"></td>
237<td width="80%">
238
239<p>Enable/disable pixel interpolation. This option requires
240a single numeric value: zero to disable pixel interpolation
241and non-zero to enable. The default is enabled.</p>
242</td>
243<td width="0%">
244</td>
245<tr valign="top" align="left">
246<td width="10%"></td>
247<td width="3%">
248
249<p><b>&minus;L</b></p>
250</td>
251<td width="5%"></td>
252<td width="80%">
253
254<p>Specify the size of overlapping for split images (in
255inches). Used in conjunction with <b>&minus;H</b>
256option.</p>
257</td>
258<td width="0%">
259</td>
260<tr valign="top" align="left">
261<td width="10%"></td>
262<td width="3%">
263
264<p><b>&minus;l</b></p>
265</td>
266<td width="5%"></td>
267<td width="80%">
268
269<p>Specify the left margin for the output (in inches). This
270does not affect the width of the printed image.</p>
271</td>
272<td width="0%">
273</td>
274<tr valign="top" align="left">
275<td width="10%"></td>
276<td width="3%">
277
278<p><b>&minus;m</b></p>
279</td>
280<td width="5%"></td>
281<td width="80%">
282
80ed523f
VZ
283<p>Where possible render using the <i>imagemask</i>
284PostScript operator instead of the <i>image</i> operator.
285When this option is specified <i>tiff2ps</i> will use
286<i>imagemask</i> for rendering 1 bit deep images. If this
287option is not specified or if the image depth is greater
288than 1 then the <i>image</i> operator is used.</p>
8414a40c
VZ
289</td>
290<td width="0%">
291</td>
292<tr valign="top" align="left">
293<td width="10%"></td>
294<td width="3%">
295
296<p><b>&minus;o</b></p>
297</td>
298<td width="5%"></td>
299<td width="80%">
300
301<p>Set the initial <small>TIFF</small> directory to the
302<small>IFD</small> at the specified file offset. This option
303is useful for selecting thumbnail images and the like which
80ed523f 304are hidden using the <i>SubIFD</i> tag.</p>
8414a40c
VZ
305</td>
306<td width="0%">
307</td>
308<tr valign="top" align="left">
309<td width="10%"></td>
310<td width="3%">
311
312<p><b>&minus;p</b></p>
313</td>
314<td width="5%"></td>
315<td width="80%">
316
80ed523f
VZ
317<p>Force the generation of (non-Encapsulated)
318PostScript.</p>
8414a40c
VZ
319</td>
320<td width="0%">
321</td>
322<tr valign="top" align="left">
323<td width="10%"></td>
324<td width="3%">
325
326<p><b>&minus;r</b></p>
327</td>
328<td width="5%"></td>
329<td width="80%">
330
331<p>Rotate image by 180 degrees.</p>
332</td>
333<td width="0%">
334</td>
335<tr valign="top" align="left">
336<td width="10%"></td>
337<td width="3%">
338
339<p><b>&minus;s</b></p>
340</td>
341<td width="5%"></td>
342<td width="80%">
343
344<p>Generate output for a single IFD (page) in the input
345file.</p>
346</td>
347<td width="0%">
348</td>
349<tr valign="top" align="left">
350<td width="10%"></td>
351<td width="3%">
352
353<p><b>&minus;w</b></p>
354</td>
355<td width="5%"></td>
356<td width="80%">
357
358<p>Specify the horizontal size of the printed area (in
359inches).</p>
360</td>
361<td width="0%">
362</td>
363<tr valign="top" align="left">
364<td width="10%"></td>
365<td width="3%">
366
367<p><b>&minus;x</b></p>
368</td>
369<td width="5%"></td>
370<td width="80%">
371
372<p>Override resolution units specified in the TIFF as
373centimeters.</p>
374</td>
375<td width="0%">
376</td>
377<tr valign="top" align="left">
378<td width="10%"></td>
379<td width="3%">
380
381<p><b>&minus;y</b></p>
382</td>
383<td width="5%"></td>
384<td width="80%">
385
386<p>Override resolution units specified in the TIFF as
387inches.</p>
388</td>
389<td width="0%">
390</td>
391<tr valign="top" align="left">
392<td width="10%"></td>
393<td width="3%">
394
395<p><b>&minus;z</b></p>
396</td>
397<td width="5%"></td>
398<td width="80%">
399
80ed523f
VZ
400<p>When generating PostScript Level 2, data is scaled so
401that it does not image into the <i>deadzone</i> on a page
402(the outer margin that the printing device is unable to
403mark). This option suppresses this behavior. When PostScript
404Level 1 is generated, data is imaged to the entire printed
405page and this option has no affect.</p>
8414a40c
VZ
406</td>
407<td width="0%">
408</td>
409</table>
410<a name="EXAMPLES"></a>
411<h2>EXAMPLES</h2>
412<!-- INDENTATION -->
413<table width="100%" border=0 rules="none" frame="void"
414 cols="2" cellspacing="0" cellpadding="0">
415<tr valign="top" align="left">
416<td width="8%"></td>
417<td width="91%">
80ed523f
VZ
418<p>The following generates PostScript Level 2 for all pages
419of a facsimile:</p></td>
8414a40c
VZ
420</table>
421<!-- INDENTATION -->
422<table width="100%" border=0 rules="none" frame="void"
423 cols="2" cellspacing="0" cellpadding="0">
424<tr valign="top" align="left">
425<td width="17%"></td>
426<td width="82%">
80ed523f 427<pre>tiff2ps &minus;a2 fax.tif | lpr
8414a40c
VZ
428</pre>
429</td>
430</table>
431<!-- INDENTATION -->
432
433<table width="100%" border=0 rules="none" frame="void"
434 cols="2" cellspacing="0" cellpadding="0">
435<tr valign="top" align="left">
436<td width="8%"></td>
437<td width="91%">
438<p>Note also that if you have version 2.6.1 or newer of
439Ghostscript then you can efficiently preview facsimile
440generated with the above command.</p>
441<!-- INDENTATION -->
80ed523f
VZ
442<p>To generate Encapsulated PostScript for a the image at
443directory 2 of an image use:</p></td>
8414a40c
VZ
444</table>
445<!-- INDENTATION -->
446<table width="100%" border=0 rules="none" frame="void"
447 cols="2" cellspacing="0" cellpadding="0">
448<tr valign="top" align="left">
449<td width="17%"></td>
450<td width="82%">
80ed523f 451<pre>tiff2ps &minus;d 1 foo.tif
8414a40c
VZ
452</pre>
453</td>
454</table>
455<!-- INDENTATION -->
456
457<table width="100%" border=0 rules="none" frame="void"
458 cols="2" cellspacing="0" cellpadding="0">
459<tr valign="top" align="left">
460<td width="8%"></td>
461<td width="91%">
80ed523f 462<p>(Notice that directories are numbered starting at
8414a40c
VZ
463zero.)</p>
464<!-- INDENTATION -->
465<p>If you have a long image, it may be split in several
466pages:</p></td>
467</table>
468<!-- INDENTATION -->
469<table width="100%" border=0 rules="none" frame="void"
470 cols="2" cellspacing="0" cellpadding="0">
471<tr valign="top" align="left">
472<td width="17%"></td>
473<td width="82%">
80ed523f 474<pre>tiff2ps &minus;h11 &minus;w8.5 &minus;H14 &minus;L.5 foo.tif &gt; foo.ps
8414a40c
VZ
475</pre>
476</td>
477</table>
478<!-- INDENTATION -->
479
480<table width="100%" border=0 rules="none" frame="void"
481 cols="2" cellspacing="0" cellpadding="0">
482<tr valign="top" align="left">
483<td width="8%"></td>
484<td width="91%">
485<p>The page size is set to 8.5x11 by <b>&minus;w</b> and
486<b>&minus;h</b> options. We will accept a small amount of
487vertical compression, so <b>&minus;H</b> set to 14. Any
488pages between 11 and 14 inches will be fit onto one page.
489Pages longer than 14 inches are cut off at 11 and continued
490on the next page. The <b>&minus;L.5</b> option says to
491repeat a half inch on the next page (to improve
492readability).</p>
493</td>
494</table>
495<a name="BUGS"></a>
496<h2>BUGS</h2>
497<!-- INDENTATION -->
498<table width="100%" border=0 rules="none" frame="void"
499 cols="2" cellspacing="0" cellpadding="0">
500<tr valign="top" align="left">
501<td width="8%"></td>
502<td width="91%">
80ed523f
VZ
503<p>Because PostScript does not support the notion of a
504colormap, 8-bit palette images produce 24-bit PostScript
505images. This conversion results in output that is six times
506bigger than the original image and which takes a long time
507to send to a printer over a serial line. Matters are even
508worse for 4-, 2-, and 1-bit palette images.</p>
8414a40c 509<!-- INDENTATION -->
80ed523f
VZ
510<p>Does not handle tiled images when generating PostScript
511Level I output.</p>
8414a40c
VZ
512</td>
513</table>
514<a name="SEE ALSO"></a>
515<h2>SEE ALSO</h2>
516<!-- INDENTATION -->
517<table width="100%" border=0 rules="none" frame="void"
518 cols="2" cellspacing="0" cellpadding="0">
519<tr valign="top" align="left">
520<td width="8%"></td>
521<td width="91%">
522<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1),
523<b>tiffgt</b>(1), <b>tiffmedian</b>(1), <b>tiff2bw</b>(1),
524<b>tiffsv</b>(1), <b>libtiff</b>(3)</p>
525<!-- INDENTATION -->
526<p>Libtiff library home page:
527<b>http://www.remotesensing.org/libtiff/</b></p>
528</td>
529</table>
530<hr>
531</body>
532</html>