xref: /libtiff-4.0.7/html/tools.html (revision 9d706da7)
1<HTML>
2<HEAD>
3<TITLE>
4TIFF Tools Overview
5</TITLE>
6</HEAD>
7<BODY BGCOLOR=WHITE>
8<FONT FACE="Arial, Helvetica, Sans">
9<H1>
10<IMG SRC=images/quad.jpg WIDTH=144 HEIGHT=108 ALIGN=left BORDER=1 HSPACE=6>
11TIFF Tools Overview
12</H1>
13
14<P>
15This software distribution comes with a small collection of programs
16for converting non-TIFF format images to TIFF and for manipulating
17and interogating the contents of TIFF images.
18Several of these tools are useful in their own right.
19Many of them however are more intended to serve as programming
20examples for using the TIFF library.
21
22<H3>Device-dependent Programs</H3>
23
24There are two device-dependent programs that serve as simple examples
25for writing programs to display and save TIFF images.
26
27
28<P>
29<TABLE BORDER CELLPADDING=3>
30
31<TR>
32<TD valign=top WIDTH=10%><TT>tiffgt&nbsp;&nbsp;&nbsp;&nbsp;</TT></TD>
33<TD>Display the contents of one or
34more TIFF images on a Silicon Graphics system using
35the Silicon Graphics IRIS GL.
36The software makes extensive use of the <TT>TIFFRGBAImage</TT>
37facilities described elsewhere.</TD>
38</TR>
39
40<TR>
41<TD valign=top WIDTH=10%><TT>tiffsv</TT></TD>
42<TD>A program to save all or part of a screen dump on a Silicon
43Graphics system.
44As for <TT>tiffgt</TT> this code, while written to use the IRIS GL,
45can be easily tailored to other devices.</TD>
46</TR>
47
48</TABLE>
49
50<H3>Device-independent Programs</H3>
51
52The remaining programs should be device-independent:
53
54<P>
55<TABLE BORDER CELLPADDING=3>
56
57<TR>
58<TD VALIGN=top WIDTH=10%><TT>tiffinfo</TT></TD>
59<TD>Display information about one or more TIFF files.</TD>
60</TR>
61
62<TR>
63<TD VALIGN=top WIDTH=10%><TT>tiffdump</TT></TD>
64<TD>Display the verbatim contents of the TIFF directory in a
65  file (it's very useful for debugging bogus files that you may get from
66  someone that claims they support TIFF)</TD>
67</TR>
68
69<TR>
70<TD VALIGN=top WIDTH=10%><TT>tiffcp</TT></TD>
71<TD>Copy, concatenate, and convert TIFF images (e.g.
72  switching from Compression=5 to Compression=1)</TD>
73</TR>
74
75<TR>
76<TD VALIGN=top WIDTH=10%><TT>tiff2ps</TT></TD>
77<TD>Convert TIFF images to PostScript</TD>
78</TR>
79
80<TR>
81<TD VALIGN=top WIDTH=10%><TT>tiffcmp</TT></TD>
82<TD>Compare the contents of two TIFF files (it does
83  not check all the directory information, but does check all the data)</TD>
84</TR>
85
86<TR>
87<TD VALIGN=top WIDTH=10%><TT>tiff2bw</TT></TD>
88<TD>A simple program to convert a color image to grayscale</TD>
89</TR>
90
91<TR>
92<TD VALIGN=top WIDTH=10%><TT>ras2tiff</TT></TD>
93<TD>A quick hack that converts Sun rasterfile format images to
94  TIFF -- it's less than complete</TD>
95</TR>
96
97<TR>
98<TD VALIGN=top WIDTH=10%><TT>rgb2ycbcr</TT></TD>
99<TD>Convert an RGB, grayscale, or bilevel TIFF image to a
100  YCbCr TIFF image; it's mainly provided for testing</TD>
101</TR>
102
103<TR>
104<TD VALIGN=top WIDTH=10%><TT>gif2tiff</TT></TD>
105<TD>A quick hack that converts GIF 87a format images to TIFF</TD>
106</TR>
107
108<TR>
109<TD VALIGN=top WIDTH=10%><TT>ppm2tiff</TT></TD>
110<TD>A quick hack that converts PPM format images to TIFF</TD>
111</TR>
112
113<TR>
114<TD VALIGN=top WIDTH=10%><TT>fax2tiff</TT></TD>
115<TD>Convert raw Group 3 or Group 4 facsimile data to TIFF</TD>
116</TR>
117
118<TR>
119<TD VALIGN=top WIDTH=10%><TT>pal2rgb</TT></TD>
120<TD>Convert a Palette-style image to a full color RGB image by
121  applying the colormap</TD>
122</TR>
123
124<TR>
125<TD VALIGN=top WIDTH=10%><TT>tiffdither</TT></TD>
126<TD>Dither a b&w image into a bilevel image (suitable for
127  use in creating fax files)</TD>
128</TR>
129
130<TR>
131<TD VALIGN=top WIDTH=10%><TT>tiffsplit</TT></TD>
132<TD>Create one or more single-image files from a (possibly)
133  multi-image file</TD>
134</TR>
135
136<TR>
137<TD VALIGN=top WIDTH=10%><TT>fax2ps</TT></TD>
138<TD>Convert a Group 3- or Group 4- compressed TIFF to PostScript
139  that is significantly more compressed than is generated by <TT>tiff2ps</TT>
140  (unless <TT>tiff2ps</TT> writes PS Level II)</TD>
141
142<TR>
143<TD VALIGN=top WIDTH=10%><TT>thumbnail</TT></TD>
144<TD>Copy a bilevel TIFF to one that includes 8-bit greyscale
145  "thumbnail images" for each page; it is provided as an example of
146  how one might use the <TT>SubIFD</TT> tag
147  (and the library support for it)</TD>
148</TR>
149
150<TR>
151<TD VALIGN=top WIDTH=10%><TT>tiffmedian</TT></TD>
152<TD>A version of Paul Heckbert's median cut program
153  that reads an RGB TIFF image, and creates a TIFF palette file as a
154  result; it's useful for converting full-color RGB images to 8-bit
155  color for your friends that have cheapo 8-bit framebuffers.</TD>
156</TR>
157
158<TR>
159<TD VALIGN=top WIDTH=10%><TT>sgi2tiff</TT></TD>
160<TD>A program to convert SGI image files to TIFF.  This
161  program is only useful on SGI machines as it uses <TT>-limage</TT>.</TD>
162</TR>
163
164</TABLE>
165
166<P>
167Check out the manual pages for details about the above programs.
168
169
170<P>
171<HR>
172
173
174Last updated: $Date: 1999-08-13 19:30:57 $
175
176
177</BODY>
178</HTML>
179