source: trunk/src/3rdparty/libtiff/html/man/tiff2pdf.1.html

Last change on this file was 846, checked in by Dmitry A. Kuminov, 15 years ago

trunk: Merged in qt 4.7.2 sources from branches/vendor/nokia/qt.
File size: 17.5 KB
Line 
1<!-- Creator : groff version 1.18.1 -->
2<!-- CreationDate: Fri Jul 13 17:43: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>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 &minus; convert a TIFF image to a PDF
30document</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="10%"></td>
40<td width="89%">
41<p><b>tiff2pdf</b> [ <i>options</i> ] <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><i>tiff2pdf</i> 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>&minus;o</b> <i>output.pdf</i>
71option.</p>
72<!-- INDENTATION -->
73<p>All black and white files are compressed into a single
74strip CCITT G4 Fax compressed PDF, unless tiled, where tiled
75black and white images are compressed into tiled CCITT G4
76Fax compressed PDF, <i>libtiff</i> CCITT support is
77assumed.</p>
78<!-- INDENTATION -->
79<p>Color and grayscale data can be compressed using either
80JPEG compression, ITU-T T.81, or Zip/Deflate LZ77
81compression. Set the compression type using the
82<b>&minus;j</b> or <b>&minus;z</b> options. JPEG compression
83support requires that <i>libtiff</i> be configured with JPEG
84support, and Zip/Deflate compression support requires that
85<i>libtiff</i> be configured with Zip support, in
86tiffconf.h. Use only one or the other of <b>&minus;j</b> and
87<b>&minus;z.</b></p>
88<!-- INDENTATION -->
89<p>If the input TIFF contains single strip CCITT G4 Fax
90compressed information, then that is written to the PDF file
91without transcoding, unless the options of no compression
92and no passthrough are set, <b>&minus;d</b> and
93<b>&minus;n.</b></p>
94<!-- INDENTATION -->
95<p>If the input TIFF contains JPEG or single strip
96Zip/Deflate compressed information, and they are configured,
97then that is written to the PDF file without transcoding,
98unless the options of no compression and no passthrough are
99set.</p>
100<!-- INDENTATION -->
101<p>The default page size upon which the TIFF image is placed
102is determined by the resolution and extent of the image
103data. Default values for the TIFF image resolution can be
104set using the <b>&minus;x</b> and <b>&minus;y</b> options.
105The page size can be set using the <b>&minus;p</b> option
106for paper size, or <b>&minus;w</b> and <b>&minus;l</b> for
107paper width and length, then each page of the TIFF image is
108centered on its page. The distance unit for default
109resolution and page width and length can be set by the
110<b>&minus;u</b> option, the default unit is inch.</p>
111<!-- INDENTATION -->
112<p>Various items of the output document information can be
113set with the <b>&minus;e</b>, <b>&minus;c</b>,
114<b>&minus;a</b>, <b>&minus;t</b>, <b>&minus;s</b>, and
115<b>&minus;k</b> options. Setting the argument of the option
116to &quot;&quot; for these tags causes the relevant document
117information field to be not written. Some of the document
118information values otherwise get their information from the
119input TIFF image, the software, author, document name, and
120image description.</p>
121<!-- INDENTATION -->
122<p>The Portable Document Format (PDF) specification is
123copyrighted by Adobe Systems, Incorporated.</p>
124</td>
125</table>
126<a name="OPTIONS"></a>
127<h2>OPTIONS</h2>
128<!-- INDENTATION -->
129<table width="100%" border=0 rules="none" frame="void"
130 cols="2" cellspacing="0" cellpadding="0">
131<tr valign="top" align="left">
132<td width="10%"></td>
133<td width="89%">
134<p><b>&minus;o</b> <i>output-file</i></p></td>
135</table>
136<!-- INDENTATION -->
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>
141<td width="77%">
142<p>Set the output to go to file. <i>output-file</i></p>
143</td>
144</table>
145<!-- TABS -->
146<table width="100%" border=0 rules="none" frame="void"
147 cols="4" cellspacing="0" cellpadding="0">
148<tr valign="top" align="left">
149<td width="11%"></td>
150<td width="4%">
151
152<p><b>&minus;j</b></p>
153</td>
154<td width="5%"></td>
155<td width="77%">
156
157<p>Compress with JPEG (requires <i>libjpeg</i> configured
158with <i>libtiff</i>).</p>
159</td>
160<tr valign="top" align="left">
161<td width="11%"></td>
162<td width="4%">
163
164<p><b>&minus;z</b></p>
165</td>
166<td width="5%"></td>
167<td width="77%">
168
169<p>Compress with Zip/Deflate (requires <i>zlib</i>
170configured with <i>libtiff</i>).</p>
171</td>
172</table>
173<!-- INDENTATION -->
174<table width="100%" border=0 rules="none" frame="void"
175 cols="2" cellspacing="0" cellpadding="0">
176<tr valign="top" align="left">
177<td width="10%"></td>
178<td width="89%">
179<p><b>&minus;q</b> <i>quality</i></p></td>
180</table>
181<!-- INDENTATION -->
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="21%"></td>
186<td width="77%">
187<p>Set the compression quality, 1-100 for JPEG.</p>
188</td>
189</table>
190<!-- TABS -->
191<table width="100%" border=0 rules="none" frame="void"
192 cols="4" cellspacing="0" cellpadding="0">
193<tr valign="top" align="left">
194<td width="11%"></td>
195<td width="2%">
196
197<p><b>&minus;n</b></p>
198</td>
199<td width="7%"></td>
200<td width="77%">
201
202<p>Do not allow data to be converted without uncompressing,
203no compressed data passthrough.</p>
204</td>
205<tr valign="top" align="left">
206<td width="11%"></td>
207<td width="2%">
208
209<p><b>&minus;b</b></p>
210</td>
211<td width="7%"></td>
212<td width="77%">
213
214<p>Set PDF &lsquo;&lsquo;Interpolate&rsquo;&rsquo; user
215preference.</p>
216</td>
217<tr valign="top" align="left">
218<td width="11%"></td>
219<td width="2%">
220
221<p><b>&minus;d</b></p>
222</td>
223<td width="7%"></td>
224<td width="77%">
225
226<p>Do not compress (decompress).</p>
227</td>
228<tr valign="top" align="left">
229<td width="11%"></td>
230<td width="2%">
231
232<p><b>&minus;i</b></p>
233</td>
234<td width="7%"></td>
235<td width="77%">
236
237<p>Invert colors.</p>
238</td>
239</table>
240<!-- INDENTATION -->
241<table width="100%" border=0 rules="none" frame="void"
242 cols="2" cellspacing="0" cellpadding="0">
243<tr valign="top" align="left">
244<td width="10%"></td>
245<td width="89%">
246<p><b>&minus;p</b> <i>paper-size</i></p></td>
247</table>
248<!-- INDENTATION -->
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>
253<td width="77%">
254<p>Set paper size, e.g., <b>letter</b>, <b>legal</b>,
255<b>A4</b>.</p>
256</td>
257</table>
258<!-- INDENTATION -->
259<table width="100%" border=0 rules="none" frame="void"
260 cols="2" cellspacing="0" cellpadding="0">
261<tr valign="top" align="left">
262<td width="10%"></td>
263<td width="89%">
264<p><b>&minus;u</b> [<b>i</b>|<b>m</b>]</p></td>
265</table>
266<!-- INDENTATION -->
267<table width="100%" border=0 rules="none" frame="void"
268 cols="2" cellspacing="0" cellpadding="0">
269<tr valign="top" align="left">
270<td width="21%"></td>
271<td width="77%">
272<p>Set distance unit, <b>i</b> for inch, <b>m</b> for
273centimeter.</p>
274</td>
275</table>
276<!-- INDENTATION -->
277<table width="100%" border=0 rules="none" frame="void"
278 cols="2" cellspacing="0" cellpadding="0">
279<tr valign="top" align="left">
280<td width="10%"></td>
281<td width="89%">
282<p><b>&minus;w</b> <i>width</i></p></td>
283</table>
284<!-- INDENTATION -->
285<table width="100%" border=0 rules="none" frame="void"
286 cols="2" cellspacing="0" cellpadding="0">
287<tr valign="top" align="left">
288<td width="21%"></td>
289<td width="77%">
290<p>Set width in units.</p>
291</td>
292</table>
293<!-- INDENTATION -->
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>
298<td width="89%">
299<p><b>&minus;l</b> <i>length</i></p></td>
300</table>
301<!-- INDENTATION -->
302<table width="100%" border=0 rules="none" frame="void"
303 cols="2" cellspacing="0" cellpadding="0">
304<tr valign="top" align="left">
305<td width="21%"></td>
306<td width="77%">
307<p>Set length in units.</p>
308</td>
309</table>
310<!-- INDENTATION -->
311<table width="100%" border=0 rules="none" frame="void"
312 cols="2" cellspacing="0" cellpadding="0">
313<tr valign="top" align="left">
314<td width="10%"></td>
315<td width="89%">
316<p><b>&minus;x</b> <i>xres</i></p></td>
317</table>
318<!-- INDENTATION -->
319<table width="100%" border=0 rules="none" frame="void"
320 cols="2" cellspacing="0" cellpadding="0">
321<tr valign="top" align="left">
322<td width="21%"></td>
323<td width="77%">
324<p>Set x/width resolution default.</p>
325</td>
326</table>
327<!-- INDENTATION -->
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>
332<td width="89%">
333<p><b>&minus;y</b> <i>yres</i></p></td>
334</table>
335<!-- INDENTATION -->
336<table width="100%" border=0 rules="none" frame="void"
337 cols="2" cellspacing="0" cellpadding="0">
338<tr valign="top" align="left">
339<td width="21%"></td>
340<td width="77%">
341<p>Set y/length resolution default.</p>
342</td>
343</table>
344<!-- INDENTATION -->
345<table width="100%" border=0 rules="none" frame="void"
346 cols="2" cellspacing="0" cellpadding="0">
347<tr valign="top" align="left">
348<td width="10%"></td>
349<td width="89%">
350<p><b>&minus;r</b> [<b>d</b>|<b>o</b>]</p></td>
351</table>
352<!-- INDENTATION -->
353<table width="100%" border=0 rules="none" frame="void"
354 cols="2" cellspacing="0" cellpadding="0">
355<tr valign="top" align="left">
356<td width="21%"></td>
357<td width="77%">
358<p>Set <b>d</b> for resolution default for images without
359resolution, <b>o</b> for resolution override for all
360images.</p>
361</td>
362</table>
363<!-- TABS -->
364<table width="100%" border=0 rules="none" frame="void"
365 cols="5" cellspacing="0" cellpadding="0">
366<tr valign="top" align="left">
367<td width="11%"></td>
368<td width="2%">
369
370<p><b>&minus;f</b></p>
371</td>
372<td width="13%"></td>
373<td width="57%">
374
375<p>Set PDF &lsquo;&lsquo;Fit Window&rsquo;&rsquo; user
376preference.</p>
377</td>
378<td width="14%">
379</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="10%"></td>
386<td width="89%">
387<p><b>&minus;e</b> <i>YYYYMMDDHHMMSS</i></p></td>
388</table>
389<!-- INDENTATION -->
390<table width="100%" border=0 rules="none" frame="void"
391 cols="2" cellspacing="0" cellpadding="0">
392<tr valign="top" align="left">
393<td width="21%"></td>
394<td width="77%">
395<p>Set document information date, overrides image or current
396date/time default, <i>YYYYMMDDHHMMSS.</i></p>
397</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="10%"></td>
404<td width="89%">
405<p><b>&minus;c</b> <i>creator</i></p></td>
406</table>
407<!-- INDENTATION -->
408<table width="100%" border=0 rules="none" frame="void"
409 cols="2" cellspacing="0" cellpadding="0">
410<tr valign="top" align="left">
411<td width="21%"></td>
412<td width="77%">
413<p>Set document information creator, overrides image
414software default.</p>
415</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="10%"></td>
422<td width="89%">
423<p><b>&minus;a</b> <i>author</i></p></td>
424</table>
425<!-- INDENTATION -->
426<table width="100%" border=0 rules="none" frame="void"
427 cols="2" cellspacing="0" cellpadding="0">
428<tr valign="top" align="left">
429<td width="21%"></td>
430<td width="77%">
431<p>Set document information author, overrides image artist
432default.</p>
433</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="10%"></td>
440<td width="89%">
441<p><b>&minus;t</b> <i>title</i></p></td>
442</table>
443<!-- INDENTATION -->
444<table width="100%" border=0 rules="none" frame="void"
445 cols="2" cellspacing="0" cellpadding="0">
446<tr valign="top" align="left">
447<td width="21%"></td>
448<td width="77%">
449<p>Set document information title, overrides image document
450name default.</p>
451</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="10%"></td>
458<td width="89%">
459<p><b>&minus;s</b> <i>subject</i></p></td>
460</table>
461<!-- INDENTATION -->
462<table width="100%" border=0 rules="none" frame="void"
463 cols="2" cellspacing="0" cellpadding="0">
464<tr valign="top" align="left">
465<td width="21%"></td>
466<td width="77%">
467<p>Set document information subject, overrides image image
468description default.</p>
469</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="10%"></td>
476<td width="89%">
477<p><b>&minus;k</b> <i>keywords</i></p></td>
478</table>
479<!-- INDENTATION -->
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="21%"></td>
484<td width="77%">
485<p>Set document information keywords.</p>
486</td>
487</table>
488<!-- TABS -->
489<table width="100%" border=0 rules="none" frame="void"
490 cols="5" cellspacing="0" cellpadding="0">
491<tr valign="top" align="left">
492<td width="11%"></td>
493<td width="2%">
494
495<p><b>&minus;h</b></p>
496</td>
497<td width="13%"></td>
498<td width="57%">
499
500<p>List usage reminder to stderr and exit.</p>
501</td>
502<td width="14%">
503</td>
504</table>
505<a name="EXAMPLES"></a>
506<h2>EXAMPLES</h2>
507<!-- INDENTATION -->
508<table width="100%" border=0 rules="none" frame="void"
509 cols="2" cellspacing="0" cellpadding="0">
510<tr valign="top" align="left">
511<td width="10%"></td>
512<td width="89%">
513<p>The following example would generate the file output.pdf
514from input.tiff.</p></td>
515</table>
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="20%"></td>
521<td width="79%">
522<pre>tiff2pdf &minus;o output.pdf input.tiff
523</pre>
524</td>
525</table>
526<!-- INDENTATION -->
527
528<table width="100%" border=0 rules="none" frame="void"
529 cols="2" cellspacing="0" cellpadding="0">
530<tr valign="top" align="left">
531<td width="10%"></td>
532<td width="89%">
533<p>The following example would generate PDF output from
534input.tiff and write it to standard output.</p></td>
535</table>
536<!-- INDENTATION -->
537<table width="100%" border=0 rules="none" frame="void"
538 cols="2" cellspacing="0" cellpadding="0">
539<tr valign="top" align="left">
540<td width="20%"></td>
541<td width="79%">
542<pre>tiff2pdf input.tiff
543</pre>
544</td>
545</table>
546<!-- INDENTATION -->
547
548<table width="100%" border=0 rules="none" frame="void"
549 cols="2" cellspacing="0" cellpadding="0">
550<tr valign="top" align="left">
551<td width="10%"></td>
552<td width="89%">
553<p>The following example would generate the file output.pdf
554from input.tiff, putting the image pages on a letter sized
555page, compressing the output with JPEG, with JPEG quality
55675, setting the title to
557&lsquo;&lsquo;Document&rsquo;&rsquo;, and setting the
558&lsquo;&lsquo;Fit Window&rsquo;&rsquo; option.</p></td>
559</table>
560<!-- INDENTATION -->
561<table width="100%" border=0 rules="none" frame="void"
562 cols="2" cellspacing="0" cellpadding="0">
563<tr valign="top" align="left">
564<td width="20%"></td>
565<td width="79%">
566<pre>tiff2pdf &minus;p letter &minus;j &minus;q 75 &minus;t &quot;Document&quot; &minus;f &minus;o output.pdf input.tiff
567</pre>
568</td>
569</table>
570<a name="BUGS"></a>
571<h2>BUGS</h2>
572<!-- INDENTATION -->
573
574<table width="100%" border=0 rules="none" frame="void"
575 cols="2" cellspacing="0" cellpadding="0">
576<tr valign="top" align="left">
577<td width="10%"></td>
578<td width="89%">
579<p>Please report bugs via the web interface at</p>
580</td>
581</table>
582<!-- INDENTATION -->
583<table width="100%" border=0 rules="none" frame="void"
584 cols="2" cellspacing="0" cellpadding="0">
585<tr valign="top" align="left">
586<td width="20%"></td>
587<td width="79%">
588
589<p>http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</p>
590</td>
591</table>
592<a name="SEE ALSO"></a>
593<h2>SEE ALSO</h2>
594<!-- INDENTATION -->
595<table width="100%" border=0 rules="none" frame="void"
596 cols="2" cellspacing="0" cellpadding="0">
597<tr valign="top" align="left">
598<td width="10%"></td>
599<td width="89%">
600<p><b>libtiff</b>(3), <b>tiffcp</b>(1),
601<b>tiff2ps</b>(1)</p>
602<!-- INDENTATION -->
603<p>Libtiff library home page:
604<b>http://www.remotesensing.org/libtiff/</b></p>
605</td>
606</table>
607<hr>
608</body>
609</html>
Note: See TracBrowser for help on using the repository browser.