TIFFGT(1)                 UNIX System V(May 2, 1990)                  TIFFGT(1)


NAME
      tiffgt - display an image stored in a TIFF file (Silicon Graphics
      version)

SYNOPSIS
      tiffgt [ -d dirnum ] [ -f ] name

DESCRIPTION
      Tiffgt displays an image stored in a file with the Tag Image File Format,
      Revision 5.0.  The image is placed in a fixed size window that the user
      must position on the display.  If the display has fewer than 24
      bitplanes, or if the image does not warrant full color, then RGB color
      values are mapped to the closest values that exist in the colormap (this
      work is done by the rgbi routine found in the graphics utility library
      -lgutil.)  By default, the first image in the file is displayed; to
      display an alternate image, specify the directory number with the -d
      option; directories are numbered starting at zero.  Normally tiffgt runs
      as a background process; the -f option forces it to run as a foreground
      process.  The -d option sets the initial TIFF directory to dirnum.

      Tiffgt correctly handles files with any of the following characteristics:
           BitsPerSample              1, 2, 4, 8, 16
           SamplesPerPixel            1, 3, 4 (the 4th sample is ignored)
           PhotometricInterpretation  0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 (palette)
           PlanarConfiguration        1 (contiguous), 2 (separate)
           Orientation                1 (top-left), 4 (bottom-left)
      Data may be compressed with any of the compression algorithms supported
      by the libtiff(3) library.  If data are organized in separate planes
      (PlanarConfiguration=2), then the RowsPerStrip must be one.

      For palette images (PhotomatricInterpretation=3), tiffgt inspects the
      colormap values and assumes either 16-bit or 8-bit values according to
      the maximum value.  That is, if no colormap entry greater than 255 is
      found, tiffgt assumes the colormap has only 8-bit values; otherwise it
      assumes 16-bit values.  This inspection is done to handle old images
      written by previous (incorrect) versions of libtiff.

      If a file can be read with tiffinfo(1), but can not be displayed, convert
      it to have the above characteristics with tiffcp(1).

BUGS
      PhotometricInterpretation=4 (holdout mask) should be handled (I had no
      examples to use for testing).  Images wider and taller than the display
      are silently truncated to avoid crashing old versions of the window
      manager.

SEE ALSO
      tiffdump(1), tiffinfo(1), tiffcp(1), libtiff(3)






10/89                                                                    Page 1