1<!-- Creator     : groff version 1.18.1 -->
2<!-- CreationDate: Sat Feb 24 18:37:19 2007 -->
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>
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
30PostScript&trade;</p>
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
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>
58<!-- INDENTATION -->
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
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 -->
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>
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
95<p>Generate PostScript Level 1 (the default).</p>
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
108<p>Generate PostScript Level 2.</p>
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
121<p>Generate PostScript Level 3. It basically allows one to
122use the /flateDecode filter for ZIP compressed TIFF
123images.</p>
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;8</b></p>
132</td>
133<td width="5%"></td>
134<td width="80%">
135
136<p>Disable use of ASCII85 encoding with PostScript Level 2/3.</p>
137</td>
138<td width="0%">
139</td>
140<tr valign="top" align="left">
141<td width="10%"></td>
142<td width="3%">
143
144<p><b>&minus;a</b></p>
145</td>
146<td width="5%"></td>
147<td width="80%">
148
149<p>Generate output for all IFDs (pages) in the input
150file.</p>
151</td>
152<td width="0%">
153</td>
154<tr valign="top" align="left">
155<td width="10%"></td>
156<td width="3%">
157
158<p><b>&minus;b</b></p>
159</td>
160<td width="5%"></td>
161<td width="80%">
162
163<p>Specify the bottom margin for the output (in inches).
164This does not affect the height of the printed image.</p>
165</td>
166<td width="0%">
167</td>
168<tr valign="top" align="left">
169<td width="10%"></td>
170<td width="3%">
171
172<p><b>&minus;c</b></p>
173</td>
174<td width="5%"></td>
175<td width="80%">
176
177<p>Center the image in the output. This option only shows
178an effect if both the <b>&minus;w</b> and the
179<b>&minus;h</b> option are given.</p>
180</td>
181<td width="0%">
182</td>
183<tr valign="top" align="left">
184<td width="10%"></td>
185<td width="3%">
186
187<p><b>&minus;C</b></p>
188</td>
189<td width="5%"></td>
190<td width="80%">
191
192<p>Specify the document creator name.</p>
193</td>
194<td width="0%">
195</td>
196<tr valign="top" align="left">
197<td width="10%"></td>
198<td width="3%">
199
200<p><b>&minus;d</b></p>
201</td>
202<td width="5%"></td>
203<td width="80%">
204
205<p>Set the initial <small>TIFF</small> directory to the
206specified directory number. (NB: Directories are numbered
207starting at zero.) This option is useful for selecting
208individual pages in a multi-page (e.g. facsimile) file.</p>
209</td>
210<td width="0%">
211</td>
212<tr valign="top" align="left">
213<td width="10%"></td>
214<td width="3%">
215
216<p><b>&minus;D</b></p>
217</td>
218<td width="5%"></td>
219<td width="80%">
220
221<p>Enable duplex printing (two pages per sheet of paper).</p>
222</td>
223<td width="0%">
224</td>
225<tr valign="top" align="left">
226<td width="10%"></td>
227<td width="3%">
228
229<p><b>&minus;e</b></p>
230</td>
231<td width="5%"></td>
232<td width="80%">
233
234<p>Force the generation of Encapsulated PostScript (implies
235<b>&minus;z</b>).</p>
236</td>
237<td width="0%">
238</td>
239<tr valign="top" align="left">
240<td width="10%"></td>
241<td width="3%">
242
243<p><b>&minus;h</b></p>
244</td>
245<td width="5%"></td>
246<td width="80%">
247
248<p>Specify the vertical size of the printed area (in
249inches).</p>
250</td>
251<td width="0%">
252</td>
253<tr valign="top" align="left">
254<td width="10%"></td>
255<td width="3%">
256
257<p><b>&minus;H</b></p>
258</td>
259<td width="5%"></td>
260<td width="80%">
261
262<p>Specify the maximum height of image (in inches). Images
263with larger sizes will be split in several pages. Option
264<b>&minus;L</b> may be used for specifying size of split
265images overlapping.</p>
266</td>
267<td width="0%">
268</td>
269<tr valign="top" align="left">
270<td width="10%"></td>
271<td width="3%">
272
273<p><b>&minus;i</b></p>
274</td>
275<td width="5%"></td>
276<td width="80%">
277
278<p>Enable/disable pixel interpolation. This option requires
279a single numeric value: zero to disable pixel interpolation
280and non-zero to enable. The default is enabled.</p>
281</td>
282<td width="0%">
283</td>
284<tr valign="top" align="left">
285<td width="10%"></td>
286<td width="3%">
287
288<p><b>&minus;L</b></p>
289</td>
290<td width="5%"></td>
291<td width="80%">
292
293<p>Specify the size of overlapping for split images (in
294inches). Used in conjunction with <b>&minus;H</b> and <b>&minus;W</b>
295options.</p>
296</td>
297<td width="0%">
298</td>
299<tr valign="top" align="left">
300<td width="10%"></td>
301<td width="3%">
302
303<p><b>&minus;l</b></p>
304</td>
305<td width="5%"></td>
306<td width="80%">
307
308<p>Specify the left margin for the output (in inches). This
309does not affect the width of the printed image.</p>
310</td>
311<td width="0%">
312</td>
313<tr valign="top" align="left">
314<td width="10%"></td>
315<td width="3%">
316
317<p><b>&minus;m</b></p>
318</td>
319<td width="5%"></td>
320<td width="80%">
321
322<p>Where possible render using the <i>imagemask</i>
323PostScript operator instead of the <i>image</i> operator.
324When this option is specified <i>tiff2ps</i> will use
325<i>imagemask</i> for rendering 1 bit deep images. If this
326option is not specified or if the image depth is greater
327than 1 then the <i>image</i> operator is used.</p>
328</td>
329<td width="0%">
330</td>
331<tr valign="top" align="left">
332<td width="10%"></td>
333<td width="3%">
334
335<p><b>&minus;o</b></p>
336</td>
337<td width="5%"></td>
338<td width="80%">
339
340<p>Set the initial <small>TIFF</small> directory to the
341<small>IFD</small> at the specified file offset. This option
342is useful for selecting thumbnail images and the like which
343are hidden using the <i>SubIFD</i> tag.</p>
344</td>
345<td width="0%">
346</td>
347<tr valign="top" align="left">
348<td width="10%"></td>
349<td width="3%">
350
351<p><b>&minus;O</b></p>
352</td>
353<td width="5%"></td>
354<td width="80%">
355
356<p>Write PostScript to specified file instead of standard output.</p>
357</td>
358<td width="0%">
359</td>
360<tr valign="top" align="left">
361<td width="10%"></td>
362<td width="3%">
363
364<p><b>&minus;p</b></p>
365</td>
366<td width="5%"></td>
367<td width="80%">
368
369<p>Force the generation of (non-Encapsulated)
370PostScript.</p>
371</td>
372<td width="0%">
373</td>
374<tr valign="top" align="left">
375<td width="10%"></td>
376<td width="3%">
377
378<p><b>&minus;P</b></p>
379</td>
380<td width="5%"></td>
381<td width="80%">
382
383<p>Set optional PageOrientation DSC comment to Landscape or Portrait.</p>
384</td>
385<td width="0%">
386</td>
387<tr valign="top" align="left">
388<td width="10%"></td>
389<td width="3%">
390
391<p><b>&minus;r</b></p>
392</td>
393<td width="5%"></td>
394<td width="80%">
395
396<p>Rotate image by 180 degrees.</p>
397</td>
398<td width="0%">
399</td>
400<tr valign="top" align="left">
401<td width="10%"></td>
402<td width="3%">
403
404<p><b>&minus;s</b></p>
405</td>
406<td width="5%"></td>
407<td width="80%">
408
409<p>Generate output for a single IFD (page) in the input
410file.</p>
411</td>
412<td width="0%">
413</td>
414<tr valign="top" align="left">
415<td width="10%"></td>
416<td width="3%">
417
418<p><b>&minus;t</b></p>
419</td>
420<td width="5%"></td>
421<td width="80%">
422
423<p>Specify the document title string.</p>
424</td>
425<td width="0%">
426</td>
427<tr valign="top" align="left">
428<td width="10%"></td>
429<td width="3%">
430
431<p><b>&minus;T</b></p>
432</td>
433<td width="5%"></td>
434<td width="80%">
435
436<p>Print pages for top edge binding.</p>
437</td>
438<td width="0%">
439</td>
440<tr valign="top" align="left">
441<td width="10%"></td>
442<td width="3%">
443
444<p><b>&minus;w</b></p>
445</td>
446<td width="5%"></td>
447<td width="80%">
448
449<p>Specify the horizontal size of the printed area (in
450inches).</p>
451</td>
452<td width="0%">
453</td>
454<tr valign="top" align="left">
455<td width="10%"></td>
456<td width="3%">
457
458<p><b>&minus;W</b></p>
459</td>
460<td width="5%"></td>
461<td width="80%">
462
463<p>Specify the maximum width of image (in inches). Images
464with larger sizes will be split in several pages. Option
465<b>&minus;L</b> may be used for specifying size of split
466images overlapping.</p>
467</td>
468<td width="0%">
469</td>
470<tr valign="top" align="left">
471<td width="10%"></td>
472<td width="3%">
473
474<p><b>&minus;x</b></p>
475</td>
476<td width="5%"></td>
477<td width="80%">
478
479<p>Override resolution units specified in the TIFF as
480centimeters.</p>
481</td>
482<td width="0%">
483</td>
484<tr valign="top" align="left">
485<td width="10%"></td>
486<td width="3%">
487
488<p><b>&minus;y</b></p>
489</td>
490<td width="5%"></td>
491<td width="80%">
492
493<p>Override resolution units specified in the TIFF as
494inches.</p>
495</td>
496<td width="0%">
497</td>
498<tr valign="top" align="left">
499<td width="10%"></td>
500<td width="3%">
501
502<p><b>&minus;z</b></p>
503</td>
504<td width="5%"></td>
505<td width="80%">
506
507<p>When generating PostScript Level 2, data is scaled so
508that it does not image into the <i>deadzone</i> on a page
509(the outer margin that the printing device is unable to
510mark). This option suppresses this behavior. When PostScript
511Level 1 is generated, data is imaged to the entire printed
512page and this option has no affect.</p>
513</td>
514<td width="0%">
515</td>
516</table>
517<a name="EXAMPLES"></a>
518<h2>EXAMPLES</h2>
519<!-- INDENTATION -->
520<table width="100%" border=0 rules="none" frame="void"
521       cols="2" cellspacing="0" cellpadding="0">
522<tr valign="top" align="left">
523<td width="8%"></td>
524<td width="91%">
525<p>The following generates PostScript Level 2 for all pages
526of a facsimile:</p></td>
527</table>
528<!-- INDENTATION -->
529<table width="100%" border=0 rules="none" frame="void"
530       cols="2" cellspacing="0" cellpadding="0">
531<tr valign="top" align="left">
532<td width="17%"></td>
533<td width="82%">
534<pre>tiff2ps &minus;a2 fax.tif | lpr
535</pre>
536</td>
537</table>
538<!-- INDENTATION -->
539
540<table width="100%" border=0 rules="none" frame="void"
541       cols="2" cellspacing="0" cellpadding="0">
542<tr valign="top" align="left">
543<td width="8%"></td>
544<td width="91%">
545<p>Note also that if you have version 2.6.1 or newer of
546Ghostscript then you can efficiently preview facsimile
547generated with the above command.</p>
548<!-- INDENTATION -->
549<p>To generate Encapsulated PostScript for a the image at
550directory 2 of an image use:</p></td>
551</table>
552<!-- INDENTATION -->
553<table width="100%" border=0 rules="none" frame="void"
554       cols="2" cellspacing="0" cellpadding="0">
555<tr valign="top" align="left">
556<td width="17%"></td>
557<td width="82%">
558<pre>tiff2ps &minus;d 1 foo.tif
559</pre>
560</td>
561</table>
562<!-- INDENTATION -->
563
564<table width="100%" border=0 rules="none" frame="void"
565       cols="2" cellspacing="0" cellpadding="0">
566<tr valign="top" align="left">
567<td width="8%"></td>
568<td width="91%">
569<p>(Notice that directories are numbered starting at
570zero.)</p>
571<!-- INDENTATION -->
572<p>If you have a long image, it may be split in several
573pages:</p></td>
574</table>
575<!-- INDENTATION -->
576<table width="100%" border=0 rules="none" frame="void"
577       cols="2" cellspacing="0" cellpadding="0">
578<tr valign="top" align="left">
579<td width="17%"></td>
580<td width="82%">
581<pre>tiff2ps &minus;h11 &minus;w8.5 &minus;H14 &minus;L.5 foo.tif &gt; foo.ps
582</pre>
583</td>
584</table>
585<!-- INDENTATION -->
586
587<table width="100%" border=0 rules="none" frame="void"
588       cols="2" cellspacing="0" cellpadding="0">
589<tr valign="top" align="left">
590<td width="8%"></td>
591<td width="91%">
592<p>The page size is set to 8.5x11 by <b>&minus;w</b> and
593<b>&minus;h</b> options. We will accept a small amount of
594vertical compression, so <b>&minus;H</b> set to 14. Any
595pages between 11 and 14 inches will be fit onto one page.
596Pages longer than 14 inches are cut off at 11 and continued
597on the next page. The <b>&minus;L.5</b> option says to
598repeat a half inch on the next page (to improve
599readability).</p>
600</td>
601</table>
602<a name="BUGS"></a>
603<h2>BUGS</h2>
604<!-- INDENTATION -->
605<table width="100%" border=0 rules="none" frame="void"
606       cols="2" cellspacing="0" cellpadding="0">
607<tr valign="top" align="left">
608<td width="8%"></td>
609<td width="91%">
610<p>Because PostScript does not support the notion of a
611colormap, 8-bit palette images produce 24-bit PostScript
612images. This conversion results in output that is six times
613bigger than the original image and which takes a long time
614to send to a printer over a serial line. Matters are even
615worse for 4-, 2-, and 1-bit palette images.</p>
616<!-- INDENTATION -->
617<p>Does not handle tiled images when generating PostScript
618Level I output.</p>
619</td>
620</table>
621<a name="SEE ALSO"></a>
622<h2>SEE ALSO</h2>
623<!-- INDENTATION -->
624<table width="100%" border=0 rules="none" frame="void"
625       cols="2" cellspacing="0" cellpadding="0">
626<tr valign="top" align="left">
627<td width="8%"></td>
628<td width="91%">
629<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1),
630<b>tiffgt</b>(1), <b>tiffmedian</b>(1), <b>tiff2bw</b>(1),
631<b>tiffsv</b>(1), <b>libtiff</b>(3)</p>
632<!-- INDENTATION -->
633<p>Libtiff library home page:
634<b>http://www.simplesystems.org/libtiff/</b></p>
635</td>
636</table>
637<hr>
638</body>
639</html>
640