TIFFGT(1)

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

SYNOPSIS
tiffgt [ -c ] [ -d dirnum ] [ -f ] [ -l ] [ -m ] [ -r ] [ -s ] [ -v ] name

DESCRIPTION
Tiffgt displays an image stored in a file with the Tag Image File Format, Revision 6.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 is done using the rgbi routine found in the graphics utility library -lgutil.) To force an image to be displayed in a full color window, the -r flag may be specified. The -c flag forces a colormap window to be used for display.

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.

If the -v option is specified, tiffgt will place information in the title bar describing what type of window (full color or colormap) is being used, the name of the input file, and the directory index of the image (if non-zero). By default, the window type is not shown in the title bar.

By default, tiffgt will ignore errors in the input data. If the -s option is specified, tiffgt will stop on the first read error it encounters.

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), 6 (YCbCr)
PlanarConfiguration	1 (contiguous), 2 (separate)
Orientation	1 (top-left), 4 (bottom-left)

Data may be organized as strips or tiles and may be compressed with any of the compression algorithms supported by the libtiff(3) library.

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.

By default, tiffgt interprets the bit ordering of the image data according to the FillOrder tag. Some vendors incorrectly write images without the FillOrder tag and with bits ordered from Least Significant Bit (LSB ) to Most Significant Bit (MSB ). If an image does not have a FillOrder tag, the -l and -m options can be used to force the bit ordering to be LSB to MSB and MSB to LSB , respectively.

BUGS
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)