xref: /libtiff-4.0.7/html/man/tiff2pdf.1.html (revision 0dcb9ef1) 
1<!-- Creator     : groff version 1.18.1 -->
2<!-- CreationDate: Mon Mar 13 18:03:12 2006 -->
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>TIFF2PDF</title>
8</head>
9<body>
10
11<h1 align=center>TIFF2PDF</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="10%"></td>
28<td width="89%">
29<p>tiff2pdf - convert a TIFF image to a PDF document</p>
30</td>
31</table>
32<a name="SYNOPSIS"></a>
33<h2>SYNOPSIS</h2>
34<!-- INDENTATION -->
35<table width="100%" border=0 rules="none" frame="void"
36       cols="2" cellspacing="0" cellpadding="0">
37<tr valign="top" align="left">
38<td width="10%"></td>
39<td width="89%">
40<p><b>tiff2pdf [</b> <i>options</i> <b>]</b>
41<i>input.tiff</i></p>
42</td>
43</table>
44<a name="DESCRIPTION"></a>
45<h2>DESCRIPTION</h2>
46<!-- INDENTATION -->
47<table width="100%" border=0 rules="none" frame="void"
48       cols="2" cellspacing="0" cellpadding="0">
49<tr valign="top" align="left">
50<td width="10%"></td>
51<td width="89%">
52<p><b>tiff2pdf</b> opens a TIFF image and writes a PDF
53document to standard output.</p>
54<!-- INDENTATION -->
55<p>The program converts one TIFF file to one PDF file,
56including multiple page TIFF files, tiled TIFF files, black
57and white. grayscale, and color TIFF files that contain data
58of TIFF photometric interpretations of bilevel, grayscale,
59RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by
60<i>libtiff</i> and PDF.</p>
61<!-- INDENTATION -->
62<p>If you have multiple TIFF files to convert into one PDF
63file then use <i>tiffcp</i> or other program to concatenate
64the files into a multiple page TIFF file. If the input TIFF
65file is of huge dimensions (greater than 10000 pixels height
66or width) convert the input image to a tiled TIFF if it is
67not already.</p>
68<!-- INDENTATION -->
69<p>The standard output is standard output. Set the output
70file name with the <b>-o</b><i>output.pdf</i> option.</p>
71<!-- INDENTATION -->
72<p>All black and white files are compressed into a single
73strip CCITT G4 Fax compressed PDF, unless tiled, where tiled
74black and white images are compressed into tiled CCITT G4
75Fax compressed PDF, <i>libtiff</i> CCITT support is
76assumed.</p>
77<!-- INDENTATION -->
78<p>Color and grayscale data can be compressed using either
79JPEG compression, ITU-T T.81, or Zip/Deflate LZ77
80compression. Set the compression type using the
81<b>&minus;j</b> or <b>&minus;z</b> options. JPEG compression
82support requires that <i>libtiff</i> be configured with JPEG
83support, and Zip/Deflate compression support requires that
84<i>libtiff</i> be configured with Zip support, in
85tiffconf.h. Use only one or the other of <b>&minus;j</b> and
86<b>&minus;z.</b></p>
87<!-- INDENTATION -->
88<p>If the input TIFF contains single strip CCITT G4 Fax
89compressed information, then that is written to the PDF file
90without transcoding, unless the options of no compression
91and no passthrough are set, <b>&minus;d</b> and
92<b>&minus;n.</b></p>
93<!-- INDENTATION -->
94<p>If the input TIFF contains JPEG or single strip
95Zip/Deflate compressed information, and they are configured,
96then that is written to the PDF file without transcoding,
97unless the options of no compression and no passthrough are
98set.</p>
99<!-- INDENTATION -->
100<p>The default page size upon which the TIFF image is placed
101is determined by the resolution and extent of the image
102data. Default values for the TIFF image resolution can be
103set using the <b>&minus;x</b> and <b>&minus;y</b> options.
104The page size can be set using the <b>&minus;p</b> option
105for paper size, or <b>&minus;w</b> and <b>&minus;l</b> for
106paper width and length, then each page of the TIFF image is
107centered on its page. The distance unit for default
108resolution and page width and length can be set by the
109<b>&minus;u</b> option, the default unit is inch.</p>
110<!-- INDENTATION -->
111<p>Various items of the output document information can be
112set with the <b>&minus;e, &minus;c, &minus;a, &minus;t,
113&minus;s,</b> and <b>&minus;k</b> options. Setting the
114argument of the option to &quot;&quot; for these tags causes
115the relevant document information field to be not written.
116Some of the document information values otherwise get their
117information from the input TIFF image, the software, author,
118document name, and image description.</p>
119<!-- INDENTATION -->
120<p>The Portable Document Format (PDF) specification is
121copyrighted by Adobe Systems, Incorporated.</p>
122</td>
123</table>
124<a name="OPTIONS"></a>
125<h2>OPTIONS</h2>
126<!-- INDENTATION -->
127<table width="100%" border=0 rules="none" frame="void"
128       cols="2" cellspacing="0" cellpadding="0">
129<tr valign="top" align="left">
130<td width="10%"></td>
131<td width="89%">
132<p><b>&minus;o</b><i>output-file</i></p></td>
133</table>
134<!-- INDENTATION -->
135<table width="100%" border=0 rules="none" frame="void"
136       cols="2" cellspacing="0" cellpadding="0">
137<tr valign="top" align="left">
138<td width="21%"></td>
139<td width="77%">
140<p>Set the output to go to file <i>output-file</i></p>
141</td>
142</table>
143<!-- TABS -->
144<table width="100%" border=0 rules="none" frame="void"
145       cols="4" cellspacing="0" cellpadding="0">
146<tr valign="top" align="left">
147<td width="11%"></td>
148<td width="4%">
149
150<p><b>&minus;j</b></p>
151</td>
152<td width="5%"></td>
153<td width="77%">
154
155<p>Compress with JPEG (requires libjpeg configured with
156libtiff).</p>
157</td>
158<tr valign="top" align="left">
159<td width="11%"></td>
160<td width="4%">
161
162<p><b>&minus;z</b></p>
163</td>
164<td width="5%"></td>
165<td width="77%">
166
167<p>Compress with Zip/Deflate (requires zlib configured with
168libtiff).</p>
169</td>
170</table>
171<!-- INDENTATION -->
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>
176<td width="89%">
177<p><b>&minus;q</b><i>quality</i></p></td>
178</table>
179<!-- INDENTATION -->
180<table width="100%" border=0 rules="none" frame="void"
181       cols="2" cellspacing="0" cellpadding="0">
182<tr valign="top" align="left">
183<td width="21%"></td>
184<td width="77%">
185<p>Set the compression quality, 1-100 for JPEG.</p>
186</td>
187</table>
188<!-- TABS -->
189<table width="100%" border=0 rules="none" frame="void"
190       cols="4" cellspacing="0" cellpadding="0">
191<tr valign="top" align="left">
192<td width="11%"></td>
193<td width="2%">
194
195<p><b>&minus;n</b></p>
196</td>
197<td width="7%"></td>
198<td width="77%">
199
200<p>Do not allow data to be converted without uncompressing,
201no compressed data passthrough.</p>
202</td>
203<tr valign="top" align="left">
204<td width="11%"></td>
205<td width="2%">
206
207<p><b>&minus;b</b></p>
208</td>
209<td width="7%"></td>
210<td width="77%">
211
212<p>Set PDF &quot;Interpolate&quot; user preference.</p>
213</td>
214<tr valign="top" align="left">
215<td width="11%"></td>
216<td width="2%">
217
218<p><b>&minus;d</b></p>
219</td>
220<td width="7%"></td>
221<td width="77%">
222
223<p>Do not compress (decompress).</p>
224</td>
225<tr valign="top" align="left">
226<td width="11%"></td>
227<td width="2%">
228
229<p><b>&minus;i</b></p>
230</td>
231<td width="7%"></td>
232<td width="77%">
233
234<p>Invert colors.</p>
235</td>
236</table>
237<!-- INDENTATION -->
238<table width="100%" border=0 rules="none" frame="void"
239       cols="2" cellspacing="0" cellpadding="0">
240<tr valign="top" align="left">
241<td width="10%"></td>
242<td width="89%">
243<p><b>&minus;p</b><i>paper-size</i></p></td>
244</table>
245<!-- INDENTATION -->
246<table width="100%" border=0 rules="none" frame="void"
247       cols="2" cellspacing="0" cellpadding="0">
248<tr valign="top" align="left">
249<td width="21%"></td>
250<td width="77%">
251<p>Set paper size, eg &quot;letter&quot;, &quot;legal&quot;,
252&quot;A4&quot;.</p>
253</td>
254</table>
255<!-- INDENTATION -->
256<table width="100%" border=0 rules="none" frame="void"
257       cols="2" cellspacing="0" cellpadding="0">
258<tr valign="top" align="left">
259<td width="10%"></td>
260<td width="89%">
261<p><b>&minus;u</b><i>[i|m]</i></p></td>
262</table>
263<!-- INDENTATION -->
264<table width="100%" border=0 rules="none" frame="void"
265       cols="2" cellspacing="0" cellpadding="0">
266<tr valign="top" align="left">
267<td width="21%"></td>
268<td width="77%">
269<p>Set distance unit, <i>i</i> for inch, <i>m</i> for
270centimeter.</p>
271</td>
272</table>
273<!-- INDENTATION -->
274<table width="100%" border=0 rules="none" frame="void"
275       cols="2" cellspacing="0" cellpadding="0">
276<tr valign="top" align="left">
277<td width="10%"></td>
278<td width="89%">
279<p><b>&minus;w</b><i>width</i></p></td>
280</table>
281<!-- INDENTATION -->
282<table width="100%" border=0 rules="none" frame="void"
283       cols="2" cellspacing="0" cellpadding="0">
284<tr valign="top" align="left">
285<td width="21%"></td>
286<td width="77%">
287<p>Set width in units.</p>
288</td>
289</table>
290<!-- INDENTATION -->
291<table width="100%" border=0 rules="none" frame="void"
292       cols="2" cellspacing="0" cellpadding="0">
293<tr valign="top" align="left">
294<td width="10%"></td>
295<td width="89%">
296<p><b>&minus;l</b><i>length</i></p></td>
297</table>
298<!-- INDENTATION -->
299<table width="100%" border=0 rules="none" frame="void"
300       cols="2" cellspacing="0" cellpadding="0">
301<tr valign="top" align="left">
302<td width="21%"></td>
303<td width="77%">
304<p>Set length in units.</p>
305</td>
306</table>
307<!-- TABS -->
308<table width="100%" border=0 rules="none" frame="void"
309       cols="5" cellspacing="0" cellpadding="0">
310<tr valign="top" align="left">
311<td width="11%"></td>
312<td width="8%">
313
314<p><b>&minus;x</b><i>xres</i></p>
315</td>
316<td width="13%"></td>
317<td width="47%">
318
319<p>Set x/width resolution default.</p>
320</td>
321<td width="19%">
322</td>
323<tr valign="top" align="left">
324<td width="11%"></td>
325<td width="8%">
326
327<p><b>&minus;y</b><i>yres</i></p>
328</td>
329<td width="13%"></td>
330<td width="47%">
331
332<p>Set y/length resolution default.</p>
333</td>
334<td width="19%">
335</td>
336</table>
337<!-- INDENTATION -->
338<table width="100%" border=0 rules="none" frame="void"
339       cols="2" cellspacing="0" cellpadding="0">
340<tr valign="top" align="left">
341<td width="10%"></td>
342<td width="89%">
343<p><b>&minus;r</b><i>[d|o]</i></p></td>
344</table>
345<!-- INDENTATION -->
346<table width="100%" border=0 rules="none" frame="void"
347       cols="2" cellspacing="0" cellpadding="0">
348<tr valign="top" align="left">
349<td width="21%"></td>
350<td width="77%">
351<p>Set <i>d</i> for resolution default for images without
352resolution, <i>o for resolution override for all
353images.</i></p>
354</td>
355</table>
356<!-- TABS -->
357<table width="100%" border=0 rules="none" frame="void"
358       cols="5" cellspacing="0" cellpadding="0">
359<tr valign="top" align="left">
360<td width="11%"></td>
361<td width="2%">
362
363<p><b>&minus;f</b></p>
364</td>
365<td width="13%"></td>
366<td width="54%">
367
368<p>Set PDF &quot;Fit Window&quot; user preference.</p>
369</td>
370<td width="17%">
371</td>
372</table>
373<!-- INDENTATION -->
374<table width="100%" border=0 rules="none" frame="void"
375       cols="2" cellspacing="0" cellpadding="0">
376<tr valign="top" align="left">
377<td width="10%"></td>
378<td width="89%">
379<p><b>&minus;e</b><i>YYYYMMDDHHMMSS</i></p></td>
380</table>
381<!-- INDENTATION -->
382<table width="100%" border=0 rules="none" frame="void"
383       cols="2" cellspacing="0" cellpadding="0">
384<tr valign="top" align="left">
385<td width="21%"></td>
386<td width="77%">
387<p>Set document information date, overrides image or current
388date/time default, <i>YYYYMMDDHHMMSS.</i></p>
389</td>
390</table>
391<!-- INDENTATION -->
392<table width="100%" border=0 rules="none" frame="void"
393       cols="2" cellspacing="0" cellpadding="0">
394<tr valign="top" align="left">
395<td width="10%"></td>
396<td width="89%">
397<p><b>&minus;c</b><i>creator</i></p></td>
398</table>
399<!-- INDENTATION -->
400<table width="100%" border=0 rules="none" frame="void"
401       cols="2" cellspacing="0" cellpadding="0">
402<tr valign="top" align="left">
403<td width="21%"></td>
404<td width="77%">
405<p>Set document information creator, overrides image
406software default.</p>
407</td>
408</table>
409<!-- INDENTATION -->
410<table width="100%" border=0 rules="none" frame="void"
411       cols="2" cellspacing="0" cellpadding="0">
412<tr valign="top" align="left">
413<td width="10%"></td>
414<td width="89%">
415<p><b>&minus;a</b><i>author</i></p></td>
416</table>
417<!-- INDENTATION -->
418<table width="100%" border=0 rules="none" frame="void"
419       cols="2" cellspacing="0" cellpadding="0">
420<tr valign="top" align="left">
421<td width="21%"></td>
422<td width="77%">
423<p>Set document information author, overrides image artist
424default</p>
425</td>
426</table>
427<!-- INDENTATION -->
428<table width="100%" border=0 rules="none" frame="void"
429       cols="2" cellspacing="0" cellpadding="0">
430<tr valign="top" align="left">
431<td width="10%"></td>
432<td width="89%">
433<p><b>&minus;t</b><i>title</i></p></td>
434</table>
435<!-- INDENTATION -->
436<table width="100%" border=0 rules="none" frame="void"
437       cols="2" cellspacing="0" cellpadding="0">
438<tr valign="top" align="left">
439<td width="21%"></td>
440<td width="77%">
441<p>Set document information title, overrides image document
442name default</p>
443</td>
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="10%"></td>
450<td width="89%">
451<p><b>&minus;s</b><i>subject</i></p></td>
452</table>
453<!-- INDENTATION -->
454<table width="100%" border=0 rules="none" frame="void"
455       cols="2" cellspacing="0" cellpadding="0">
456<tr valign="top" align="left">
457<td width="21%"></td>
458<td width="77%">
459<p>Set document information subject, overrides image image
460description default</p>
461</td>
462</table>
463<!-- INDENTATION -->
464<table width="100%" border=0 rules="none" frame="void"
465       cols="2" cellspacing="0" cellpadding="0">
466<tr valign="top" align="left">
467<td width="10%"></td>
468<td width="89%">
469<p><b>&minus;k</b><i>keywords</i></p></td>
470</table>
471<!-- INDENTATION -->
472<table width="100%" border=0 rules="none" frame="void"
473       cols="2" cellspacing="0" cellpadding="0">
474<tr valign="top" align="left">
475<td width="21%"></td>
476<td width="77%">
477<p>Set document information keywords.</p>
478</td>
479</table>
480<!-- TABS -->
481<table width="100%" border=0 rules="none" frame="void"
482       cols="5" cellspacing="0" cellpadding="0">
483<tr valign="top" align="left">
484<td width="11%"></td>
485<td width="2%">
486
487<p><b>&minus;h</b></p>
488</td>
489<td width="13%"></td>
490<td width="57%">
491
492<p>List usage reminder to stderr and exit.</p>
493</td>
494<td width="14%">
495</td>
496<tr valign="top" align="left">
497<td width="11%"></td>
498<td width="2%">
499</td>
500<td width="13%"></td>
501<td width="57%">
502<a name="EXAMPLES"></a>
503<h2>EXAMPLES</h2>
504<!-- INDENTATION -->
505<table width="100%" border=0 rules="none" frame="void"
506       cols="2" cellspacing="0" cellpadding="0">
507<tr valign="top" align="left">
508<td width="10%"></td>
509<td width="89%">
510<p>The following example would generate the file output.pdf
511from input.tiff.</p></td>
512</table>
513<!-- INDENTATION -->
514<table width="100%" border=0 rules="none" frame="void"
515       cols="2" cellspacing="0" cellpadding="0">
516<tr valign="top" align="left">
517<td width="20%"></td>
518<td width="79%">
519<p>tiff2pdf -o output.pdf input.tiff</p></td>
520</table>
521<!-- INDENTATION -->
522<table width="100%" border=0 rules="none" frame="void"
523       cols="2" cellspacing="0" cellpadding="0">
524<tr valign="top" align="left">
525<td width="10%"></td>
526<td width="89%">
527<p>The following example would generate PDF output from
528input.tiff and write it to standard output.</p>
529</td>
530</table>
531<!-- INDENTATION -->
532<table width="100%" border=0 rules="none" frame="void"
533       cols="2" cellspacing="0" cellpadding="0">
534<tr valign="top" align="left">
535<td width="20%"></td>
536<td width="79%">
537<p>tiff2pdf input.tiff</p></td>
538</table>
539<!-- INDENTATION -->
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="10%"></td>
544<td width="89%">
545<p>The following example would generate the file output.pdf
546from input.tiff, putting the image pages on a letter sized
547page, compressing the output with JPEG, with JPEG quality
54875, setting the title to &quot;Document&quot;, and setting
549the &quot;Fit Window&quot; option.</p>
550</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="20%"></td>
557<td width="79%">
558<p>tiff2pdf -p letter -j -q 75 -t &quot;Document&quot; -f -o
559output.pdf input.tiff</p></td>
560</table>
561<a name="BUGS"></a>
562<h2>BUGS</h2>
563<!-- INDENTATION -->
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="10%"></td>
568<td width="89%">
569<p>Please report bugs via the web interface at</p>
570</td>
571</table>
572<!-- INDENTATION -->
573<table width="100%" border=0 rules="none" frame="void"
574       cols="2" cellspacing="0" cellpadding="0">
575<tr valign="top" align="left">
576<td width="20%"></td>
577<td width="79%">
578
579<p>http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</p>
580</td>
581</table>
582<a name="SEE ALSO"></a>
583<h2>SEE ALSO</h2>
584<!-- INDENTATION -->
585<table width="100%" border=0 rules="none" frame="void"
586       cols="2" cellspacing="0" cellpadding="0">
587<tr valign="top" align="left">
588<td width="10%"></td>
589<td width="89%">
590<p><b>libtiff</b>(3)<b>, tiffcp</b>(1)<b>,
591tiff2ps</b>(1)</p>
592<!-- INDENTATION -->
593<p>Libtiff library home page:
594<b>http://www.remotesensing.org/libtiff/</b></p>
595</td>
596</table>
597<hr>
598</body>
599</html>
600