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