]> git.saurik.com Git - wxWidgets.git/blob - 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
1 <!-- Creator : groff version 1.18.1 -->
2 <!-- CreationDate: Sat Feb 24 18:37: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
30 document</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
53 document to standard output.</p>
54 <!-- INDENTATION -->
55 <p>The program converts one TIFF file to one PDF file,
56 including multiple page TIFF files, tiled TIFF files, black
57 and white. grayscale, and color TIFF files that contain data
58 of TIFF photometric interpretations of bilevel, grayscale,
59 RGB, 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
63 file then use <i>tiffcp</i> or other program to concatenate
64 the files into a multiple page TIFF file. If the input TIFF
65 file is of huge dimensions (greater than 10000 pixels height
66 or width) convert the input image to a tiled TIFF if it is
67 not already.</p>
68 <!-- INDENTATION -->
69 <p>The standard output is standard output. Set the output
70 file name with the <b>&minus;o</b> <i>output.pdf</i>
71 option.</p>
72 <!-- INDENTATION -->
73 <p>All black and white files are compressed into a single
74 strip CCITT G4 Fax compressed PDF, unless tiled, where tiled
75 black and white images are compressed into tiled CCITT G4
76 Fax compressed PDF, <i>libtiff</i> CCITT support is
77 assumed.</p>
78 <!-- INDENTATION -->
79 <p>Color and grayscale data can be compressed using either
80 JPEG compression, ITU-T T.81, or Zip/Deflate LZ77
81 compression. Set the compression type using the
82 <b>&minus;j</b> or <b>&minus;z</b> options. JPEG compression
83 support requires that <i>libtiff</i> be configured with JPEG
84 support, and Zip/Deflate compression support requires that
85 <i>libtiff</i> be configured with Zip support, in
86 tiffconf.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
90 compressed information, then that is written to the PDF file
91 without transcoding, unless the options of no compression
92 and 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
96 Zip/Deflate compressed information, and they are configured,
97 then that is written to the PDF file without transcoding,
98 unless the options of no compression and no passthrough are
99 set.</p>
100 <!-- INDENTATION -->
101 <p>The default page size upon which the TIFF image is placed
102 is determined by the resolution and extent of the image
103 data. Default values for the TIFF image resolution can be
104 set using the <b>&minus;x</b> and <b>&minus;y</b> options.
105 The page size can be set using the <b>&minus;p</b> option
106 for paper size, or <b>&minus;w</b> and <b>&minus;l</b> for
107 paper width and length, then each page of the TIFF image is
108 centered on its page. The distance unit for default
109 resolution 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
113 set 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
116 to &quot;&quot; for these tags causes the relevant document
117 information field to be not written. Some of the document
118 information values otherwise get their information from the
119 input TIFF image, the software, author, document name, and
120 image description.</p>
121 <!-- INDENTATION -->
122 <p>The Portable Document Format (PDF) specification is
123 copyrighted 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
158 with <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>
170 configured 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,
203 no 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
215 preference.</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
273 centimeter.</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
359 resolution, <b>o</b> for resolution override for all
360 images.</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
376 preference.</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
396 date/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
414 software 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
432 default.</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
450 name 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
468 description 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
514 from 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
534 input.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
554 from input.tiff, putting the image pages on a letter sized
555 page, compressing the output with JPEG, with JPEG quality
556 75, 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>