]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/tiff/html/man/tiffgt.1.html
fix off by 1 error in GetTextRaw() (#4317)
[wxWidgets.git] / src / tiff / html / man / tiffgt.1.html
... / ...
CommitLineData
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
52the Tag Image File Format, Revision 6.0. Each image is
53placed in a fixed size window that the user must position on
54the display (unless configured otherwise through X
55defaults). If the display has fewer than 24 bitplanes, or if
56the image does not warrant full color, then
57<small>RGB</small> color values are mapped to the closest
58values 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
63following 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
127compressed with any of the compression algorithms supported
128by 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
132either 16-bit or 8-bit values according to the maximum
133value. That is, if no colormap entry greater than 255 is
134found, <i>tiffgt</i> assumes the colormap has only 8-bit
135values; otherwise it assumes 16-bit values. This inspection
136is done to handle old images written by previous (incorrect)
137versions of <i>libtiff</i>.</p>
138<!-- INDENTATION -->
139<p><i>tiffgt</i> can be used to display multiple images
140one-at-a-time. The left mouse button switches the display to
141the first image in the <i>next</i> file in the list of files
142specified on the command line. The right mouse button
143switches to the first image in the <i>previous</i> file in
144the list. The middle mouse button causes the first image in
145the first file specified on the command line to be
146displayed. In addition the following keyboard commands are
147recognized:</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
162displaying 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
175current 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
188current 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
213current 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
226displaying 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
239the <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
252the <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>,
266handling 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
279last 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
299image 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
361default the first image in the file is displayed.
362Directories 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>
377silently 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
391default <i>tiffgt</i> will place itself in the background
392once 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>
406to <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>
420to <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
434default the first image in the file is displayed.
435Directories offsets may be specified using C-style syntax;
436i.e. a leading &lsquo;&lsquo;0x&rsquo;&rsquo; for
437hexadecimal and a leading &lsquo;&lsquo;0&rsquo;&rsquo; for
438octal.</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
453one of: <i>miniswhite</i>, <i>minisblack</i>, <i>rgb</i>,
454<i>palette</i>, <i>mask</i>, <i>separated</i>, <i>ycbcr</i>,
455and <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
482the input data are ignored and <i>tiffgt</i> does it&rsquo;s
483best 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>
498ignores warning messages generated when reading an
499image.</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
513of window (full color or colormap) is being used, the name
514of the input file, and the directory index of the image (if
515non-zero). By default, the window type is not shown in the
516title 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
530truncated to avoid crashing old versions of the window
531manager.</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>