src/tiff/html/man/tiff2pdf.1.html

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