src/tiff/html/man/tiffgt.1.html

   1 <!-- Creator     : groff version 1.18.1 -->
   2 <!-- CreationDate: Mon Mar 13 18:03:13 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>TIFFGT</title>
   8 </head>
   9 <body>
  10
  11 <h1 align=center>TIFFGT</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="#BUGS">BUGS</a><br>
  17 <a href="#SEE ALSO">SEE ALSO</a><br>
  18
  19 <hr>
  20 <a name="NAME"></a>
  21 <h2>NAME</h2>
  22 <!-- INDENTATION -->
  23 <table width="100%" border=0 rules="none" frame="void"
  24        cols="2" cellspacing="0" cellpadding="0">
  25 <tr valign="top" align="left">
  26 <td width="8%"></td>
  27 <td width="91%">
  28 <p>tiffgt &minus; display an image stored in a
  29 <small>TIFF</small> file (Silicon Graphics version)</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="8%"></td>
  39 <td width="91%">
  40 <p><b>tiffgt</b> [ <i>options</i> ] <i>input.tif ...</i></p>
  41 </td>
  42 </table>
  43 <a name="DESCRIPTION"></a>
  44 <h2>DESCRIPTION</h2>
  45 <!-- INDENTATION -->
  46 <table width="100%" border=0 rules="none" frame="void"
  47        cols="2" cellspacing="0" cellpadding="0">
  48 <tr valign="top" align="left">
  49 <td width="8%"></td>
  50 <td width="91%">
  51 <p><i>tiffgt</i> displays one or more images stored using
  52 the Tag Image File Format, Revision 6.0. Each image is
  53 placed in a fixed size window that the user must position on
  54 the display (unless configured otherwise through X
  55 defaults). If the display has fewer than 24 bitplanes, or if
  56 the image does not warrant full color, then
  57 <small>RGB</small> color values are mapped to the closest
  58 values that exist in the colormap (this is done using the
  59 <i>rgbi</i> routine found in the graphics utility library
  60 <b>&minus;lgutil</b>.)</p>
  61 <!-- INDENTATION -->
  62 <p><i>tiffgt</i> correctly handles files with any of the
  63 following characteristics:</p></td>
  64 </table>
  65 <!-- TABS -->
  66 <table width="100%" border=0 rules="none" frame="void"
  67        cols="3" cellspacing="0" cellpadding="0">
  68 <tr valign="top" align="left">
  69 <td width="15%"></td>
  70 <td width="34%">
  71
  72 <p>BitsPerSample</p>
  73 </td>
  74 <td width="50%">
  75
  76 <p>1, 2, 4, 8, 16</p>
  77 </td>
  78 <tr valign="top" align="left">
  79 <td width="15%"></td>
  80 <td width="34%">
  81
  82 <p>SamplesPerPixel</p>
  83 </td>
  84 <td width="50%">
  85
  86 <p>1, 3, 4 (the 4th sample is ignored)</p>
  87 </td>
  88 <tr valign="top" align="left">
  89 <td width="15%"></td>
  90 <td width="34%">
  91
  92 <p>PhotometricInterpretation</p>
  93 </td>
  94 <td width="50%">
  95
  96 <p>0 (min-is-white), 1 (min-is-black), 2 (RGB), 3
  97 (palette), 6 (YCbCr)</p>
  98 </td>
  99 <tr valign="top" align="left">
 100 <td width="15%"></td>
 101 <td width="34%">
 102
 103 <p>PlanarConfiguration</p>
 104 </td>
 105 <td width="50%">
 106
 107 <p>1 (contiguous), 2 (separate)</p>
 108 </td>
 109 <tr valign="top" align="left">
 110 <td width="15%"></td>
 111 <td width="34%">
 112
 113 <p>Orientation</p>
 114 </td>
 115 <td width="50%">
 116
 117 <p>1 (top-left), 4 (bottom-left)</p>
 118 </td>
 119 </table>
 120 <!-- INDENTATION -->
 121 <table width="100%" border=0 rules="none" frame="void"
 122        cols="2" cellspacing="0" cellpadding="0">
 123 <tr valign="top" align="left">
 124 <td width="8%"></td>
 125 <td width="91%">
 126 <p>Data may be organized as strips or tiles and may be
 127 compressed with any of the compression algorithms supported
 128 by the <i>libtiff</i>(3) library.</p>
 129 <!-- INDENTATION -->
 130 <p>For palette images (<i>PhotometricInterpretation</i>=3),
 131 <i>tiffgt</i> inspects the colormap values and assumes
 132 either 16-bit or 8-bit values according to the maximum
 133 value. That is, if no colormap entry greater than 255 is
 134 found, <i>tiffgt</i> assumes the colormap has only 8-bit
 135 values; otherwise it assumes 16-bit values. This inspection
 136 is done to handle old images written by previous (incorrect)
 137 versions of <i>libtiff</i>.</p>
 138 <!-- INDENTATION -->
 139 <p><i>tiffgt</i> can be used to display multiple images
 140 one-at-a-time. The left mouse button switches the display to
 141 the first image in the <i>next</i> file in the list of files
 142 specified on the command line. The right mouse button
 143 switches to the first image in the <i>previous</i> file in
 144 the list. The middle mouse button causes the first image in
 145 the first file specified on the command line to be
 146 displayed. In addition the following keyboard commands are
 147 recognized:</p>
 148 </td>
 149 </table>
 150 <!-- TABS -->
 151 <table width="100%" border=0 rules="none" frame="void"
 152        cols="4" cellspacing="0" cellpadding="0">
 153 <tr valign="top" align="left">
 154 <td width="10%"></td>
 155 <td width="8%">
 156
 157 <p><b>b</b></p>
 158 </td>
 159 <td width="80%">
 160
 161 <p>Use a <i>PhotometricInterpretation</i> of MinIsBlack in
 162 displaying the current image.</p>
 163 </td>
 164 <td width="0%">
 165 </td>
 166 <tr valign="top" align="left">
 167 <td width="10%"></td>
 168 <td width="8%">
 169
 170 <p><b>l</b></p>
 171 </td>
 172 <td width="80%">
 173
 174 <p>Use a <i>FillOrder</i> of lsb-to-msb in decoding the
 175 current image.</p>
 176 </td>
 177 <td width="0%">
 178 </td>
 179 <tr valign="top" align="left">
 180 <td width="10%"></td>
 181 <td width="8%">
 182
 183 <p><b>m</b></p>
 184 </td>
 185 <td width="80%">
 186
 187 <p>Use a <i>FillOrder</i> of msb-to-lsb in decoding the
 188 current image.</p>
 189 </td>
 190 <td width="0%">
 191 </td>
 192 <tr valign="top" align="left">
 193 <td width="10%"></td>
 194 <td width="8%">
 195
 196 <p><b>c</b></p>
 197 </td>
 198 <td width="80%">
 199
 200 <p>Use a colormap visual to display the current image.</p>
 201 </td>
 202 <td width="0%">
 203 </td>
 204 <tr valign="top" align="left">
 205 <td width="10%"></td>
 206 <td width="8%">
 207
 208 <p><b>r</b></p>
 209 </td>
 210 <td width="80%">
 211
 212 <p>Use a true color (24-bit RGB) visual to display the
 213 current image.</p>
 214 </td>
 215 <td width="0%">
 216 </td>
 217 <tr valign="top" align="left">
 218 <td width="10%"></td>
 219 <td width="8%">
 220
 221 <p><b>w</b></p>
 222 </td>
 223 <td width="80%">
 224
 225 <p>Use a <i>PhotometricInterpretation</i> of MinIsWhite in
 226 displaying the current image.</p>
 227 </td>
 228 <td width="0%">
 229 </td>
 230 <tr valign="top" align="left">
 231 <td width="10%"></td>
 232 <td width="8%">
 233
 234 <p><b>W</b></p>
 235 </td>
 236 <td width="80%">
 237
 238 <p>Toggle (enable/disable) display of warning messages from
 239 the <small>TIFF</small> library when decoding images.</p>
 240 </td>
 241 <td width="0%">
 242 </td>
 243 <tr valign="top" align="left">
 244 <td width="10%"></td>
 245 <td width="8%">
 246
 247 <p><b>E</b></p>
 248 </td>
 249 <td width="80%">
 250
 251 <p>Toggle (enable/disable) display of error messages from
 252 the <small>TIFF</small> library when decoding images.</p>
 253 </td>
 254 <td width="0%">
 255 </td>
 256 <tr valign="top" align="left">
 257 <td width="10%"></td>
 258 <td width="8%">
 259
 260 <p><b>z</b></p>
 261 </td>
 262 <td width="80%">
 263
 264 <p>Reset all parameters to their default settings
 265 (<i>FillOrder</i>, <i>PhotometricInterpretation</i>,
 266 handling of warnings and errors).</p>
 267 </td>
 268 <td width="0%">
 269 </td>
 270 <tr valign="top" align="left">
 271 <td width="10%"></td>
 272 <td width="8%">
 273
 274 <p><b>PageUp</b></p>
 275 </td>
 276 <td width="80%">
 277
 278 <p>Display the previous image in the current file or the
 279 last image in the previous file.</p>
 280 </td>
 281 <td width="0%">
 282 </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="8%"></td>
 289 <td width="91%">
 290 <p><b>PageDown</b></p></td>
 291 </table>
 292 <!-- INDENTATION -->
 293 <table width="100%" border=0 rules="none" frame="void"
 294        cols="2" cellspacing="0" cellpadding="0">
 295 <tr valign="top" align="left">
 296 <td width="19%"></td>
 297 <td width="80%">
 298 <p>Display the next image in the current file or the first
 299 image in the next file.</p>
 300 </td>
 301 </table>
 302 <!-- TABS -->
 303 <table width="100%" border=0 rules="none" frame="void"
 304        cols="5" cellspacing="0" cellpadding="0">
 305 <tr valign="top" align="left">
 306 <td width="10%"></td>
 307 <td width="6%">
 308
 309 <p><b>Home</b></p>
 310 </td>
 311 <td width="2%"></td>
 312 <td width="80%">
 313
 314 <p>Display the first image in the current file.</p>
 315 </td>
 316 <td width="0%">
 317 </td>
 318 <tr valign="top" align="left">
 319 <td width="10%"></td>
 320 <td width="6%">
 321
 322 <p><b>End</b></p>
 323 </td>
 324 <td width="2%"></td>
 325 <td width="80%">
 326
 327 <p>Display the last image in the current file
 328 (unimplemented).</p>
 329 </td>
 330 <td width="0%">
 331 </td>
 332 </table>
 333 <a name="OPTIONS"></a>
 334 <h2>OPTIONS</h2>
 335 <!-- TABS -->
 336 <table width="100%" border=0 rules="none" frame="void"
 337        cols="5" cellspacing="0" cellpadding="0">
 338 <tr valign="top" align="left">
 339 <td width="10%"></td>
 340 <td width="3%">
 341
 342 <p><b>&minus;c</b></p>
 343 </td>
 344 <td width="5%"></td>
 345 <td width="80%">
 346
 347 <p>Force image display in a colormap window.</p>
 348 </td>
 349 <td width="0%">
 350 </td>
 351 <tr valign="top" align="left">
 352 <td width="10%"></td>
 353 <td width="3%">
 354
 355 <p><b>&minus;d</b></p>
 356 </td>
 357 <td width="5%"></td>
 358 <td width="80%">
 359
 360 <p>Specify an image to display by directory number. By
 361 default the first image in the file is displayed.
 362 Directories are numbered starting at zero.</p>
 363 </td>
 364 <td width="0%">
 365 </td>
 366 <tr valign="top" align="left">
 367 <td width="10%"></td>
 368 <td width="3%">
 369
 370 <p><b>&minus;e</b></p>
 371 </td>
 372 <td width="5%"></td>
 373 <td width="80%">
 374
 375 <p>Enable reporting of error messages from the
 376 <small>TIFF</small> library. By default <i>tiffgt</i>
 377 silently ignores images that cannot be read.</p>
 378 </td>
 379 <td width="0%">
 380 </td>
 381 <tr valign="top" align="left">
 382 <td width="10%"></td>
 383 <td width="3%">
 384
 385 <p><b>&minus;f</b></p>
 386 </td>
 387 <td width="5%"></td>
 388 <td width="80%">
 389
 390 <p>Force <i>tiffgt</i> to run as a foreground process. By
 391 default <i>tiffgt</i> will place itself in the background
 392 once it has opened the requested image file.</p>
 393 </td>
 394 <td width="0%">
 395 </td>
 396 <tr valign="top" align="left">
 397 <td width="10%"></td>
 398 <td width="3%">
 399
 400 <p><b>&minus;l</b></p>
 401 </td>
 402 <td width="5%"></td>
 403 <td width="80%">
 404
 405 <p>Force the presumed bit ordering to be <small>LSB</small>
 406 to <small>MSB.</small></p>
 407 </td>
 408 <td width="0%">
 409 </td>
 410 <tr valign="top" align="left">
 411 <td width="10%"></td>
 412 <td width="3%">
 413
 414 <p><b>&minus;m</b></p>
 415 </td>
 416 <td width="5%"></td>
 417 <td width="80%">
 418
 419 <p>Force the presumed bit ordering to be <small>MSB</small>
 420 to <small>LSB.</small></p>
 421 </td>
 422 <td width="0%">
 423 </td>
 424 <tr valign="top" align="left">
 425 <td width="10%"></td>
 426 <td width="3%">
 427
 428 <p><b>&minus;o</b></p>
 429 </td>
 430 <td width="5%"></td>
 431 <td width="80%">
 432
 433 <p>Specify an image to display by directory offset. By
 434 default the first image in the file is displayed.
 435 Directories offsets may be specified using C-style syntax;
 436 i.e. a leading &lsquo;&lsquo;0x&rsquo;&rsquo; for
 437 hexadecimal and a leading &lsquo;&lsquo;0&rsquo;&rsquo; for
 438 octal.</p>
 439 </td>
 440 <td width="0%">
 441 </td>
 442 <tr valign="top" align="left">
 443 <td width="10%"></td>
 444 <td width="3%">
 445
 446 <p><b>&minus;p</b></p>
 447 </td>
 448 <td width="5%"></td>
 449 <td width="80%">
 450
 451 <p>Override the value of the
 452 <i>PhotometricInterpretation</i> tag; the parameter may be
 453 one of: <i>miniswhite</i>, <i>minisblack</i>, <i>rgb</i>,
 454 <i>palette</i>, <i>mask</i>, <i>separated</i>, <i>ycbcr</i>,
 455 and <i>cielab</i>.</p>
 456 </td>
 457 <td width="0%">
 458 </td>
 459 <tr valign="top" align="left">
 460 <td width="10%"></td>
 461 <td width="3%">
 462
 463 <p><b>&minus;r</b></p>
 464 </td>
 465 <td width="5%"></td>
 466 <td width="80%">
 467
 468 <p>Force image display in a full color window.</p>
 469 </td>
 470 <td width="0%">
 471 </td>
 472 <tr valign="top" align="left">
 473 <td width="10%"></td>
 474 <td width="3%">
 475
 476 <p><b>&minus;s</b></p>
 477 </td>
 478 <td width="5%"></td>
 479 <td width="80%">
 480
 481 <p>Stop on the first read error. By default all errors in
 482 the input data are ignored and <i>tiffgt</i> does it&rsquo;s
 483 best to display as much of an image as possible.</p>
 484 </td>
 485 <td width="0%">
 486 </td>
 487 <tr valign="top" align="left">
 488 <td width="10%"></td>
 489 <td width="3%">
 490
 491 <p><b>&minus;w</b></p>
 492 </td>
 493 <td width="5%"></td>
 494 <td width="80%">
 495
 496 <p>Enable reporting of warning messages from the
 497 <small>TIFF</small> library. By default <i>tiffgt</i>
 498 ignores warning messages generated when reading an
 499 image.</p>
 500 </td>
 501 <td width="0%">
 502 </td>
 503 <tr valign="top" align="left">
 504 <td width="10%"></td>
 505 <td width="3%">
 506
 507 <p><b>&minus;v</b></p>
 508 </td>
 509 <td width="5%"></td>
 510 <td width="80%">
 511
 512 <p>Place information in the title bar describing what type
 513 of window (full color or colormap) is being used, the name
 514 of the input file, and the directory index of the image (if
 515 non-zero). By default, the window type is not shown in the
 516 title bar.</p>
 517 </td>
 518 <td width="0%">
 519 </td>
 520 </table>
 521 <a name="BUGS"></a>
 522 <h2>BUGS</h2>
 523 <!-- INDENTATION -->
 524 <table width="100%" border=0 rules="none" frame="void"
 525        cols="2" cellspacing="0" cellpadding="0">
 526 <tr valign="top" align="left">
 527 <td width="8%"></td>
 528 <td width="91%">
 529 <p>Images wider and taller than the display are silently
 530 truncated to avoid crashing old versions of the window
 531 manager.</p>
 532 </td>
 533 </table>
 534 <a name="SEE ALSO"></a>
 535 <h2>SEE ALSO</h2>
 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="8%"></td>
 541 <td width="91%">
 542 <p><b>tiffdump</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1),
 543 <b>libtiff</b>(3TIFF)</p>
 544 <!-- INDENTATION -->
 545 <p>Libtiff library home page:
 546 <b>http://www.remotesensing.org/libtiff/</b></p>
 547 </td>
 548 </table>
 549 <hr>
 550 </body>
 551 </html>