xref: /libtiff-4.0.7/html/man/tiff2pdf.1.html (revision dbdbe4c0)
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>TIFF2PDF</title>
6</head>
7<body>
8
9<h1 align=center>TIFF2PDF</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="#SEE ALSO">SEE ALSO</a><br>
17
18<hr>
19<!-- Creator     : groff version 1.17.2 -->
20<!-- CreationDate: Thu Nov 27 17:58:11 2003 -->
21<a name="NAME"></a>
22<h2>NAME</h2>
23<table width="100%" border=0 rules="none" frame="void"
24       cols="2" cellspacing="0" cellpadding="0">
25<tr valign="top" align="left">
26<td width="10%"></td><td width="90%">
27tiff2pdf - convert a TIFF image to a PDF document</td></table>
28<a name="SYNOPSIS"></a>
29<h2>SYNOPSIS</h2>
30
31<table width="100%" border=0 rules="none" frame="void"
32       cols="2" cellspacing="0" cellpadding="0">
33<tr valign="top" align="left">
34<td width="10%"></td><td width="90%">
35<b>tiff2pdf [</b> <i>options</i> <b>]</b>
36<i>input.tiff</i></td></table>
37<a name="DESCRIPTION"></a>
38<h2>DESCRIPTION</h2>
39
40<table width="100%" border=0 rules="none" frame="void"
41       cols="2" cellspacing="0" cellpadding="0">
42<tr valign="top" align="left">
43<td width="10%"></td><td width="90%">
44<b>tiff2pdf</b> opens a TIFF image and writes a PDF document
45to standard output.</td></table>
46
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><td width="90%">
51The program converts one TIFF file to one PDF file,
52including multiple page TIFF files, tiled TIFF files, black
53and white. grayscale, and color TIFF files that contain data
54of TIFF photometric interpretations of bilevel, grayscale,
55RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by
56<i>libtiff</i> and PDF.</td></table>
57
58<table width="100%" border=0 rules="none" frame="void"
59       cols="2" cellspacing="0" cellpadding="0">
60<tr valign="top" align="left">
61<td width="10%"></td><td width="90%">
62If you have multiple TIFF files to convert into one PDF file
63then use <i>tiffcp</i> or other program to concatenate the
64files into a multiple page TIFF file. If the input TIFF file
65is of huge dimensions (greater than 10000 pixels height or
66width) convert the input image to a tiled TIFF if it is not
67already.</td></table>
68
69<table width="100%" border=0 rules="none" frame="void"
70       cols="2" cellspacing="0" cellpadding="0">
71<tr valign="top" align="left">
72<td width="10%"></td><td width="90%">
73The standard output is standard output. Set the output file
74name with the <b>-o</b><i>output.pdf</i>
75option.</td></table>
76
77<table width="100%" border=0 rules="none" frame="void"
78       cols="2" cellspacing="0" cellpadding="0">
79<tr valign="top" align="left">
80<td width="10%"></td><td width="90%">
81All black and white files are compressed into a single strip
82CCITT G4 Fax compressed PDF, unless tiled, where tiled black
83and white images are compressed into tiled CCITT G4 Fax
84compressed PDF, <i>libtiff</i> CCITT support is
85assumed.</td></table>
86
87<table width="100%" border=0 rules="none" frame="void"
88       cols="2" cellspacing="0" cellpadding="0">
89<tr valign="top" align="left">
90<td width="10%"></td><td width="90%">
91Color and grayscale data can be compressed using either JPEG
92compression, ITU-T T.81, or Zip/Deflate LZ77 compression.
93Set the compression type using the <b>-j</b> or <b>-z</b>
94options. JPEG compression support requires that
95<i>libtiff</i> be configured with JPEG support, and
96Zip/Deflate compression support requires that <i>libtiff</i>
97be configured with Zip support, in tiffconf.h. Use only one
98or the other of <b>-j</b> and <b>-z.</b></td></table>
99
100<table width="100%" border=0 rules="none" frame="void"
101       cols="2" cellspacing="0" cellpadding="0">
102<tr valign="top" align="left">
103<td width="10%"></td><td width="90%">
104If the input TIFF contains single strip CCITT G4 Fax
105compressed information, then that is written to the PDF file
106without transcoding, unless the options of no compression
107and no passthrough are set, <b>-d</b> and
108<b>-n.</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="10%"></td><td width="90%">
114If the input TIFF contains JPEG or single strip Zip/Deflate
115compressed information, and they are configured, then that
116is written to the PDF file without transcoding, unless the
117options of no compression and no passthrough are
118set.</td></table>
119
120<table width="100%" border=0 rules="none" frame="void"
121       cols="2" cellspacing="0" cellpadding="0">
122<tr valign="top" align="left">
123<td width="10%"></td><td width="90%">
124The default page size upon which the TIFF image is placed is
125determined by the resolution and extent of the image data.
126Default values for the TIFF image resolution can be set
127using the <b>-x</b> and <b>-y</b> options. The page size can
128be set using the <b>-p</b> option for paper size, or
129<b>-w</b> and <b>-l</b> for paper width and length, then
130each page of the TIFF image is centered on its page. The
131distance unit for default resolution and page width and
132length can be set by the <b>-u</b> option, the default unit
133is inch.</td></table>
134
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="10%"></td><td width="90%">
139Various items of the output document information can be set
140with the <b>-e, -c, -a, -t, -s,</b> and <b>-k</b> options.
141Setting the argument of the option to &quot;&quot; for these
142tags causes the relevant document information field to be
143not written. Some of the document information values
144otherwise get their information from the input TIFF image,
145the software, author, document name, and image
146description.</td></table>
147
148<table width="100%" border=0 rules="none" frame="void"
149       cols="2" cellspacing="0" cellpadding="0">
150<tr valign="top" align="left">
151<td width="10%"></td><td width="90%">
152The Portable Document Format (PDF) specification is
153copyrighted by Adobe Systems, Incorporated.</td></table>
154<a name="OPTIONS"></a>
155<h2>OPTIONS</h2>
156
157<table width="100%" border=0 rules="none" frame="void"
158       cols="2" cellspacing="0" cellpadding="0">
159<tr valign="top" align="left">
160<td width="10%"></td><td width="90%">
161<b>-o</b><i>output-file</i></td></table>
162
163<table width="100%" border=0 rules="none" frame="void"
164       cols="2" cellspacing="0" cellpadding="0">
165<tr valign="top" align="left">
166<td width="21%"></td><td width="79%">
167Set the output to go to file <i>output-file</i></td></table>
168
169<table width="100%" border=0 rules="none" frame="void"
170       cols="2" cellspacing="0" cellpadding="0">
171<tr valign="top" align="left">
172<td width="10%"></td><td width="90%">
173<b>-j</b></td></table>
174
175<table width="100%" border=0 rules="none" frame="void"
176       cols="2" cellspacing="0" cellpadding="0">
177<tr valign="top" align="left">
178<td width="21%"></td><td width="79%">
179Compress with JPEG (requires libjpeg configured with
180libtiff).</td></table>
181
182<table width="100%" border=0 rules="none" frame="void"
183       cols="2" cellspacing="0" cellpadding="0">
184<tr valign="top" align="left">
185<td width="10%"></td><td width="90%">
186<b>-z</b></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="21%"></td><td width="79%">
192Compress with Zip/Deflate (requires zlib configured with
193libtiff).</td></table>
194
195<table width="100%" border=0 rules="none" frame="void"
196       cols="2" cellspacing="0" cellpadding="0">
197<tr valign="top" align="left">
198<td width="10%"></td><td width="90%">
199<b>-q</b><i>quality</i></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="21%"></td><td width="79%">
205Set the compression quality, 1-100 for JPEG.</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="10%"></td><td width="90%">
211<b>-n</b></td></table>
212
213<table width="100%" border=0 rules="none" frame="void"
214       cols="2" cellspacing="0" cellpadding="0">
215<tr valign="top" align="left">
216<td width="21%"></td><td width="79%">
217Do not allow data to be converted without uncompressing, no
218compressed data passthrough.</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="10%"></td><td width="90%">
224<b>-d</b></td></table>
225
226<table width="100%" border=0 rules="none" frame="void"
227       cols="2" cellspacing="0" cellpadding="0">
228<tr valign="top" align="left">
229<td width="21%"></td><td width="79%">
230Do not compress (decompress).</td></table>
231
232<table width="100%" border=0 rules="none" frame="void"
233       cols="2" cellspacing="0" cellpadding="0">
234<tr valign="top" align="left">
235<td width="10%"></td><td width="90%">
236<b>-i</b></td></table>
237
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="21%"></td><td width="79%">
242Invert colors.</td></table>
243
244<table width="100%" border=0 rules="none" frame="void"
245       cols="2" cellspacing="0" cellpadding="0">
246<tr valign="top" align="left">
247<td width="10%"></td><td width="90%">
248<b>-p</b><i>paper-size</i></td></table>
249
250<table width="100%" border=0 rules="none" frame="void"
251       cols="2" cellspacing="0" cellpadding="0">
252<tr valign="top" align="left">
253<td width="21%"></td><td width="79%">
254Set paper size, eg &quot;letter&quot;, &quot;legal&quot;,
255&quot;A4&quot;.</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>-u</b><i>[i|m]</i></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%">
267Set distance unit, <i>i</i> for inch, <i>m</i> for
268centimeter.</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>-w</b><i>width</i></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%">
280Set width in units.</td></table>
281
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="10%"></td><td width="90%">
286<b>-l</b><i>length</i></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="21%"></td><td width="79%">
292Set length in units.</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="10%"></td><td width="90%">
298<b>-x</b><i>xres</i></td></table>
299
300<table width="100%" border=0 rules="none" frame="void"
301       cols="2" cellspacing="0" cellpadding="0">
302<tr valign="top" align="left">
303<td width="21%"></td><td width="79%">
304Set x/width resolution default.</td></table>
305
306<table width="100%" border=0 rules="none" frame="void"
307       cols="2" cellspacing="0" cellpadding="0">
308<tr valign="top" align="left">
309<td width="10%"></td><td width="90%">
310<b>-y</b><i>yres</i></td></table>
311
312<table width="100%" border=0 rules="none" frame="void"
313       cols="2" cellspacing="0" cellpadding="0">
314<tr valign="top" align="left">
315<td width="21%"></td><td width="79%">
316Set y/length resolution default.</td></table>
317
318<table width="100%" border=0 rules="none" frame="void"
319       cols="2" cellspacing="0" cellpadding="0">
320<tr valign="top" align="left">
321<td width="10%"></td><td width="90%">
322<b>-r</b><i>[d|o]</i></td></table>
323
324<table width="100%" border=0 rules="none" frame="void"
325       cols="2" cellspacing="0" cellpadding="0">
326<tr valign="top" align="left">
327<td width="21%"></td><td width="79%">
328Set <i>d</i> for resolution default for images without
329resolution, <i>o for resolution override for all
330images.</i></td></table>
331
332<table width="100%" border=0 rules="none" frame="void"
333       cols="2" cellspacing="0" cellpadding="0">
334<tr valign="top" align="left">
335<td width="10%"></td><td width="90%">
336<b>-f</b></td></table>
337
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="21%"></td><td width="79%">
342Set PDF &quot;Fit Window&quot; user preference</td></table>
343
344<table width="100%" border=0 rules="none" frame="void"
345       cols="2" cellspacing="0" cellpadding="0">
346<tr valign="top" align="left">
347<td width="10%"></td><td width="90%">
348<b>-e</b><i>YYYYMMDDHHMMSS</i></td></table>
349
350<table width="100%" border=0 rules="none" frame="void"
351       cols="2" cellspacing="0" cellpadding="0">
352<tr valign="top" align="left">
353<td width="21%"></td><td width="79%">
354Set document information date, overrides image or current
355date/time default, <i>YYYYMMDDHHMMSS.</i></td></table>
356
357<table width="100%" border=0 rules="none" frame="void"
358       cols="2" cellspacing="0" cellpadding="0">
359<tr valign="top" align="left">
360<td width="10%"></td><td width="90%">
361<b>-c</b><i>creator</i></td></table>
362
363<table width="100%" border=0 rules="none" frame="void"
364       cols="2" cellspacing="0" cellpadding="0">
365<tr valign="top" align="left">
366<td width="21%"></td><td width="79%">
367Set document information creator, overrides image software
368default.</td></table>
369
370<table width="100%" border=0 rules="none" frame="void"
371       cols="2" cellspacing="0" cellpadding="0">
372<tr valign="top" align="left">
373<td width="10%"></td><td width="90%">
374<b>-a</b><i>author</i></td></table>
375
376<table width="100%" border=0 rules="none" frame="void"
377       cols="2" cellspacing="0" cellpadding="0">
378<tr valign="top" align="left">
379<td width="21%"></td><td width="79%">
380Set document information author, overrides image artist
381default</td></table>
382
383<table width="100%" border=0 rules="none" frame="void"
384       cols="2" cellspacing="0" cellpadding="0">
385<tr valign="top" align="left">
386<td width="10%"></td><td width="90%">
387<b>-t</b><i>title</i></td></table>
388
389<table width="100%" border=0 rules="none" frame="void"
390       cols="2" cellspacing="0" cellpadding="0">
391<tr valign="top" align="left">
392<td width="21%"></td><td width="79%">
393Set document information title, overrides image document
394name default</td></table>
395
396<table width="100%" border=0 rules="none" frame="void"
397       cols="2" cellspacing="0" cellpadding="0">
398<tr valign="top" align="left">
399<td width="10%"></td><td width="90%">
400<b>-s</b><i>subject</i></td></table>
401
402<table width="100%" border=0 rules="none" frame="void"
403       cols="2" cellspacing="0" cellpadding="0">
404<tr valign="top" align="left">
405<td width="21%"></td><td width="79%">
406Set document information subject, overrides image image
407description default</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="10%"></td><td width="90%">
413<b>-k</b><i>keywords</i></td></table>
414
415<table width="100%" border=0 rules="none" frame="void"
416       cols="2" cellspacing="0" cellpadding="0">
417<tr valign="top" align="left">
418<td width="21%"></td><td width="79%">
419Set document information keywords.</td></table>
420
421<table width="100%" border=0 rules="none" frame="void"
422       cols="2" cellspacing="0" cellpadding="0">
423<tr valign="top" align="left">
424<td width="10%"></td><td width="90%">
425<b>-h</b></td></table>
426
427<table width="100%" border=0 rules="none" frame="void"
428       cols="2" cellspacing="0" cellpadding="0">
429<tr valign="top" align="left">
430<td width="21%"></td><td width="79%">
431List usage reminder to stderr and exit.</td></table>
432<a name="EXAMPLES"></a>
433<h2>EXAMPLES</h2>
434
435<table width="100%" border=0 rules="none" frame="void"
436       cols="2" cellspacing="0" cellpadding="0">
437<tr valign="top" align="left">
438<td width="10%"></td><td width="90%">
439The following example would generate the file output.pdf
440from input.tiff.</td></table>
441
442<table width="100%" border=0 rules="none" frame="void"
443       cols="2" cellspacing="0" cellpadding="0">
444<tr valign="top" align="left">
445<td width="21%"></td><td width="79%">
446tiff2pdf -o output.pdf input.tiff</td></table>
447
448<table width="100%" border=0 rules="none" frame="void"
449       cols="2" cellspacing="0" cellpadding="0">
450<tr valign="top" align="left">
451<td width="10%"></td><td width="90%">
452The following example would generate PDF output from
453input.tiff and write it to standard output.</td></table>
454
455<table width="100%" border=0 rules="none" frame="void"
456       cols="2" cellspacing="0" cellpadding="0">
457<tr valign="top" align="left">
458<td width="21%"></td><td width="79%">
459tiff2pdf input.tiff</td></table>
460
461<table width="100%" border=0 rules="none" frame="void"
462       cols="2" cellspacing="0" cellpadding="0">
463<tr valign="top" align="left">
464<td width="10%"></td><td width="90%">
465The following example would generate the file output.pdf
466from input.tiff, putting the image pages on a letter sized
467page, compressing the output with JPEG, with JPEG quality
46875, setting the title to &quot;Document&quot;, and setting
469the &quot;Fit Window&quot; option.</td></table>
470
471<table width="100%" border=0 rules="none" frame="void"
472       cols="2" cellspacing="0" cellpadding="0">
473<tr valign="top" align="left">
474<td width="21%"></td><td width="79%">
475tiff2pdf -p letter -j -q 75 -t &quot;Document&quot; -f -o
476output.pdf input.tiff</td></table>
477<a name="BUGS"></a>
478<h2>BUGS</h2>
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="10%"></td><td width="90%">
484Please report bugs via the web interface at</td></table>
485
486<table width="100%" border=0 rules="none" frame="void"
487       cols="2" cellspacing="0" cellpadding="0">
488<tr valign="top" align="left">
489<td width="21%"></td><td width="79%">
490
491http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</td></table>
492<a name="SEE ALSO"></a>
493<h2>SEE ALSO</h2>
494
495<table width="100%" border=0 rules="none" frame="void"
496       cols="2" cellspacing="0" cellpadding="0">
497<tr valign="top" align="left">
498<td width="10%"></td><td width="90%">
499<b>libtiff</b>(3)<b>, tiffcp</b>(1)<b>,
500tiff2ps</b>(1)</td></table>
501<hr>
502</body>
503</html>
504