326 lines
6.8 KiB
HTML
326 lines
6.8 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML><HEAD><TITLE>Manpage of TIFFGT</TITLE>
|
|
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
|
<H1>TIFFGT</H1>
|
|
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
|
<BR><A HREF="index.html">Return to Main Contents</A>
|
|
<HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
tiffgt - display an image stored in a
|
|
<FONT SIZE="-1">TIFF</FONT>
|
|
file (Silicon Graphics version)
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>tiffgt</B>
|
|
|
|
[
|
|
<I>options</I>
|
|
|
|
]
|
|
<I>input.tif ...</I>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<I>tiffgt</I>
|
|
|
|
displays one or more images stored using the
|
|
Tag Image File Format, Revision 6.0.
|
|
Each image is placed in a fixed size window that the
|
|
user must position on the display (unless configured
|
|
otherwise through X defaults).
|
|
If the display has fewer than 24 bitplanes, or if the
|
|
image does not warrant full color, then
|
|
<FONT SIZE="-1">RGB</FONT>
|
|
color values are mapped to the closest values that exist in
|
|
the colormap (this is done using the
|
|
<I>rgbi</I>
|
|
|
|
routine found in the graphics utility library
|
|
<B>-lgutil</B>.)
|
|
|
|
<P>
|
|
|
|
<I>tiffgt</I>
|
|
|
|
correctly handles files with any of the following characteristics:
|
|
<P>
|
|
|
|
|
|
|
|
<PRE>
|
|
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)
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
Data may be organized as strips or tiles and may be
|
|
compressed with any of the compression algorithms supported
|
|
by the
|
|
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
|
|
|
library.
|
|
<P>
|
|
|
|
For palette images (<I>PhotomatricInterpretation</I>=3),
|
|
|
|
<I>tiffgt</I>
|
|
|
|
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,
|
|
<I>tiffgt</I>
|
|
|
|
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
|
|
<I>libtiff</I>.
|
|
|
|
<P>
|
|
|
|
<I>tiffgt</I>
|
|
|
|
can be used to display multiple images one-at-a-time.
|
|
The left mouse button switches the display to the first image in the
|
|
<I>next</I>
|
|
|
|
file in the list of files specified on the command line.
|
|
The right mouse button switches to the first image in the
|
|
<I>previous</I>
|
|
|
|
file in the list.
|
|
The middle mouse button causes the first image in the first file
|
|
specified on the command line to be displayed.
|
|
In addition the following keyboard commands are recognized:
|
|
<DL COMPACT>
|
|
<DT><B>b</B>
|
|
|
|
<DD>
|
|
Use a
|
|
<I>PhotometricIntepretation</I>
|
|
|
|
of MinIsBlack in displaying the current image.
|
|
<DT><B>l</B>
|
|
|
|
<DD>
|
|
Use a
|
|
<I>FillOrder</I>
|
|
|
|
of lsb-to-msb in decoding the current image.
|
|
<DT><B>m</B>
|
|
|
|
<DD>
|
|
Use a
|
|
<I>FillOrder</I>
|
|
|
|
of msb-tolmsb in decoding the current image.
|
|
<DT><B>c</B>
|
|
|
|
<DD>
|
|
Use a colormap visual to display the current image.
|
|
<DT><B>r</B>
|
|
|
|
<DD>
|
|
Use a true color (24-bit RGB) visual to display the current image.
|
|
<DT><B>w</B>
|
|
|
|
<DD>
|
|
Use a
|
|
<I>PhotometricIntepretation</I>
|
|
|
|
of MinIsWhite in displaying the current image.
|
|
<DT><B>W</B>
|
|
|
|
<DD>
|
|
Toggle (enable/disable) display of warning messages from the
|
|
<FONT SIZE="-1">TIFF</FONT>
|
|
library when decoding images.
|
|
<DT><B>E</B>
|
|
|
|
<DD>
|
|
Toggle (enable/disable) display of error messages from the
|
|
<FONT SIZE="-1">TIFF</FONT>
|
|
library when decoding images.
|
|
<DT><B>z</B>
|
|
|
|
<DD>
|
|
Reset all parameters to their default settings (<I>FillOrder</I>,
|
|
|
|
<I>PhotometricInterpretation</I>,
|
|
|
|
handling of warnings and errors).
|
|
<DT><B>PageUp</B>
|
|
|
|
<DD>
|
|
Display the previous image in the current file or the last
|
|
image in the previous file.
|
|
<DT><B>PageDown</B>
|
|
|
|
<DD>
|
|
Display the next image in the current file or the first image
|
|
in the next file.
|
|
<DT><B>Home</B>
|
|
|
|
<DD>
|
|
Display the first image in the current file.
|
|
<DT><B>End</B>
|
|
|
|
<DD>
|
|
Display the last image in the current file (unimplemented).
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT><B>-c</B>
|
|
|
|
<DD>
|
|
Force image display in a colormap window.
|
|
<DT><B>-d</B>
|
|
|
|
<DD>
|
|
Specify an image to display by directory number.
|
|
By default the first image in the file is displayed.
|
|
Directories are numbered starting at zero.
|
|
<DT><B>-e</B>
|
|
|
|
<DD>
|
|
Enable reporting of error messages from the
|
|
<FONT SIZE="-1">TIFF</FONT>
|
|
library.
|
|
By default
|
|
<I>tiffgt</I>
|
|
|
|
silently ignores images that cannot be read.
|
|
<DT><B>-f</B>
|
|
|
|
<DD>
|
|
Force
|
|
<I>tiffgt</I>
|
|
|
|
to run as a foreground process.
|
|
By default
|
|
<I>tiffgt</I>
|
|
|
|
will place itself in the background once it has opened the
|
|
requested image file.
|
|
<DT><B>-l</B>
|
|
|
|
<DD>
|
|
Force the presumed bit ordering to be
|
|
<FONT SIZE="-1">LSB</FONT>
|
|
to
|
|
<FONT SIZE="-1">MSB.</FONT>
|
|
<DT><B>-m</B>
|
|
|
|
<DD>
|
|
Force the presumed bit ordering to be
|
|
<FONT SIZE="-1">MSB</FONT>
|
|
to
|
|
<FONT SIZE="-1">LSB.</FONT>
|
|
<DT><B>-o</B>
|
|
|
|
<DD>
|
|
Specify an image to display by directory offset.
|
|
By default the first image in the file is displayed.
|
|
Directories offsets may be specified using C-style syntax;
|
|
i.e. a leading ``0x'' for hexadecimal and a leading ``0'' for octal.
|
|
<DT><B>-p</B>
|
|
|
|
<DD>
|
|
Override the value of the
|
|
<I>PhotometricInterpretation</I>
|
|
|
|
tag; the parameter may be one of:
|
|
<I>miniswhite</I>,
|
|
|
|
<I>minisblack</I>,
|
|
|
|
<I>rgb</I>,
|
|
|
|
<I>palette</I>,
|
|
|
|
<I>mask</I>,
|
|
|
|
<I>separated</I>,
|
|
|
|
<I>ycbcr</I>,
|
|
|
|
and
|
|
<I>cielab</I>.
|
|
|
|
<DT><B>-r</B>
|
|
|
|
<DD>
|
|
Force image display in a full color window.
|
|
<DT><B>-s</B>
|
|
|
|
<DD>
|
|
Stop on the first read error.
|
|
By default all errors in the input data are ignored and
|
|
<I>tiffgt</I>
|
|
|
|
does it's best to display as much of an image as possible.
|
|
<DT><B>-w</B>
|
|
|
|
<DD>
|
|
Enable reporting of warning messages from the
|
|
<FONT SIZE="-1">TIFF</FONT>
|
|
library.
|
|
By default
|
|
<I>tiffgt</I>
|
|
|
|
ignores warning messages generated when reading an image.
|
|
<DT><B>-v</B>
|
|
|
|
<DD>
|
|
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.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Images wider and taller than the display are silently truncated to avoid
|
|
crashing old versions of the window manager.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<I><A HREF="tiffdump+1.html">tiffdump</A></I>(1),
|
|
|
|
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
|
|
|
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
|
|
|
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
|
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT><A HREF="#lbAB">NAME</A><DD>
|
|
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT><A HREF="#lbAF">BUGS</A><DD>
|
|
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="index.html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 01:31:48 GMT, November 23, 1999
|
|
</BODY>
|
|
</HTML>
|