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