]> git.saurik.com Git - wxWidgets.git/blame - src/tiff/html/man/tiff2pdf.1.html
projects / wxWidgets.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
wxMessageBox off the main thread lost result code.
[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>
wxWidgets (Impactor)