]> git.saurik.com Git - wxWidgets.git/blame - src/tiff/html/man/tiff2pdf.1.html
Merged libtiff 4.0.3 changes into the trunk.
[wxWidgets.git] / src / tiff / html / man / tiff2pdf.1.html
CommitLineData
8414a40c 1<!-- Creator : groff version 1.18.1 -->
80ed523f 2<!-- CreationDate: Sat Feb 24 18:37:19 2007 -->
8414a40c
VZ
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%">
80ed523f
VZ
29<p>tiff2pdf &minus; convert a TIFF image to a PDF
30document</p>
8414a40c
VZ
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%">
80ed523f 41<p><b>tiff2pdf</b> [ <i>options</i> ] <i>input.tiff</i></p>
8414a40c
VZ
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%">
80ed523f 52<p><i>tiff2pdf</i> opens a TIFF image and writes a PDF
8414a40c
VZ
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
80ed523f
VZ
70file name with the <b>&minus;o</b> <i>output.pdf</i>
71option.</p>
8414a40c
VZ
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
80ed523f
VZ
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>
8414a40c
VZ
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%">
80ed523f 134<p><b>&minus;o</b> <i>output-file</i></p></td>
8414a40c
VZ
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%">
80ed523f 142<p>Set the output to go to file. <i>output-file</i></p>
8414a40c
VZ
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
80ed523f
VZ
157<p>Compress with JPEG (requires <i>libjpeg</i> configured
158with <i>libtiff</i>).</p>
8414a40c
VZ
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
80ed523f
VZ
169<p>Compress with Zip/Deflate (requires <i>zlib</i>
170configured with <i>libtiff</i>).</p>
8414a40c
VZ
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%">
80ed523f 179<p><b>&minus;q</b> <i>quality</i></p></td>
8414a40c
VZ
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
80ed523f
VZ
214<p>Set PDF &lsquo;&lsquo;Interpolate&rsquo;&rsquo; user
215preference.</p>
8414a40c
VZ
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%">
80ed523f 246<p><b>&minus;p</b> <i>paper-size</i></p></td>
8414a40c
VZ
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%">
80ed523f
VZ
254<p>Set paper size, e.g., <b>letter</b>, <b>legal</b>,
255<b>A4</b>.</p>
8414a40c
VZ
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%">
80ed523f 264<p><b>&minus;u</b> [<b>i</b>|<b>m</b>]</p></td>
8414a40c
VZ
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%">
80ed523f 272<p>Set distance unit, <b>i</b> for inch, <b>m</b> for
8414a40c
VZ
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%">
80ed523f 282<p><b>&minus;w</b> <i>width</i></p></td>
8414a40c
VZ
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%">
80ed523f 299<p><b>&minus;l</b> <i>length</i></p></td>
8414a40c
VZ
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>
80ed523f 310<!-- INDENTATION -->
8414a40c 311<table width="100%" border=0 rules="none" frame="void"
80ed523f 312 cols="2" cellspacing="0" cellpadding="0">
8414a40c 313<tr valign="top" align="left">
80ed523f
VZ
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%">
8414a40c
VZ
324<p>Set x/width resolution default.</p>
325</td>
80ed523f
VZ
326</table>
327<!-- INDENTATION -->
328<table width="100%" border=0 rules="none" frame="void"
329 cols="2" cellspacing="0" cellpadding="0">
8414a40c 330<tr valign="top" align="left">
80ed523f
VZ
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%">
8414a40c
VZ
341<p>Set y/length resolution default.</p>
342</td>
8414a40c
VZ
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%">
80ed523f 350<p><b>&minus;r</b> [<b>d</b>|<b>o</b>]</p></td>
8414a40c
VZ
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%">
80ed523f
VZ
358<p>Set <b>d</b> for resolution default for images without
359resolution, <b>o</b> for resolution override for all
360images.</p>
8414a40c
VZ
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>
80ed523f 373<td width="57%">
8414a40c 374
80ed523f
VZ
375<p>Set PDF &lsquo;&lsquo;Fit Window&rsquo;&rsquo; user
376preference.</p>
8414a40c 377</td>
80ed523f 378<td width="14%">
8414a40c
VZ
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%">
80ed523f 387<p><b>&minus;e</b> <i>YYYYMMDDHHMMSS</i></p></td>
8414a40c
VZ
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%">
80ed523f 405<p><b>&minus;c</b> <i>creator</i></p></td>
8414a40c
VZ
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%">
80ed523f 423<p><b>&minus;a</b> <i>author</i></p></td>
8414a40c
VZ
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
80ed523f 432default.</p>
8414a40c
VZ
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%">
80ed523f 441<p><b>&minus;t</b> <i>title</i></p></td>
8414a40c
VZ
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
80ed523f 450name default.</p>
8414a40c
VZ
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%">
80ed523f 459<p><b>&minus;s</b> <i>subject</i></p></td>
8414a40c
VZ
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
80ed523f 468description default.</p>
8414a40c
VZ
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%">
80ed523f 477<p><b>&minus;k</b> <i>keywords</i></p></td>
8414a40c
VZ
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>
80ed523f 504</table>
8414a40c
VZ
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%">
80ed523f
VZ
522<pre>tiff2pdf &minus;o output.pdf input.tiff
523</pre>
524</td>
8414a40c
VZ
525</table>
526<!-- INDENTATION -->
80ed523f 527
8414a40c
VZ
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
80ed523f 534input.tiff and write it to standard output.</p></td>
8414a40c
VZ
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%">
80ed523f
VZ
542<pre>tiff2pdf input.tiff
543</pre>
544</td>
8414a40c
VZ
545</table>
546<!-- INDENTATION -->
80ed523f 547
8414a40c
VZ
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
80ed523f
VZ
55675, setting the title to
557&lsquo;&lsquo;Document&rsquo;&rsquo;, and setting the
558&lsquo;&lsquo;Fit Window&rsquo;&rsquo; option.</p></td>
8414a40c
VZ
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%">
80ed523f
VZ
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>
8414a40c
VZ
569</table>
570<a name="BUGS"></a>
571<h2>BUGS</h2>
572<!-- INDENTATION -->
80ed523f 573
8414a40c
VZ
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%">
80ed523f
VZ
600<p><b>libtiff</b>(3), <b>tiffcp</b>(1),
601<b>tiff2ps</b>(1)</p>
8414a40c
VZ
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>