~ubuntu-branches/ubuntu/karmic/tiff/karmic-security

« back to all changes in this revision

Viewing changes to html/man/tiffgt.1.html

  • Committer: Bazaar Package Importer
  • Author(s): Fabio M. Di Nitto
  • Date: 2004-10-14 07:57:59 UTC
  • Revision ID: james.westby@ubuntu.com-20041014075759-a77e7zuaetya8cp0
Tags: upstream-3.6.1
ImportĀ upstreamĀ versionĀ 3.6.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<html>
 
2
<head>
 
3
<meta name="generator" content="groff -Thtml, see www.gnu.org">
 
4
<meta name="Content-Style" content="text/css">
 
5
<title>TIFFGT</title>
 
6
</head>
 
7
<body>
 
8
 
 
9
<h1 align=center>TIFFGT</h1>
 
10
<a href="#NAME">NAME</a><br>
 
11
<a href="#SYNOPSIS">SYNOPSIS</a><br>
 
12
<a href="#DESCRIPTION">DESCRIPTION</a><br>
 
13
<a href="#OPTIONS">OPTIONS</a><br>
 
14
<a href="#BUGS">BUGS</a><br>
 
15
<a href="#SEE ALSO">SEE ALSO</a><br>
 
16
 
 
17
<hr>
 
18
<!-- Creator     : groff version 1.17.2 -->
 
19
<!-- CreationDate: Mon Dec 22 00:39:35 2003 -->
 
20
<a name="NAME"></a>
 
21
<h2>NAME</h2>
 
22
<table width="100%" border=0 rules="none" frame="void"
 
23
       cols="2" cellspacing="0" cellpadding="0">
 
24
<tr valign="top" align="left">
 
25
<td width="10%"></td><td width="90%">
 
26
tiffgt - display an image stored in a <small>TIFF</small> file (Silicon Graphics version)</td></table>
 
27
<a name="SYNOPSIS"></a>
 
28
<h2>SYNOPSIS</h2>
 
29
 
 
30
<table width="100%" border=0 rules="none" frame="void"
 
31
       cols="2" cellspacing="0" cellpadding="0">
 
32
<tr valign="top" align="left">
 
33
<td width="10%"></td><td width="90%">
 
34
<b>tiffgt</b> [ <i>options</i> ] <i>input.tif
 
35
...</i></td></table>
 
36
<a name="DESCRIPTION"></a>
 
37
<h2>DESCRIPTION</h2>
 
38
 
 
39
<table width="100%" border=0 rules="none" frame="void"
 
40
       cols="2" cellspacing="0" cellpadding="0">
 
41
<tr valign="top" align="left">
 
42
<td width="10%"></td><td width="90%">
 
43
<i>tiffgt</i> displays one or more images stored using the
 
44
Tag Image File Format, Revision 6.0. Each image is placed in
 
45
a fixed size window that the user must position on the
 
46
display (unless configured otherwise through X defaults). If
 
47
the display has fewer than 24 bitplanes, or if the image
 
48
does not warrant full color, then <small>RGB</small> color
 
49
values are mapped to the closest values that exist in the
 
50
colormap (this is done using the <i>rgbi</i> routine found
 
51
in the graphics utility library
 
52
<b>-lgutil</b>.)</td></table>
 
53
 
 
54
<table width="100%" border=0 rules="none" frame="void"
 
55
       cols="2" cellspacing="0" cellpadding="0">
 
56
<tr valign="top" align="left">
 
57
<td width="10%"></td><td width="90%">
 
58
<i>tiffgt</i> correctly handles files with any of the
 
59
following characteristics:</td></table>
 
60
 
 
61
<table width="100%" border=0 rules="none" frame="void"
 
62
       cols="2" cellspacing="0" cellpadding="0">
 
63
<tr valign="top" align="left">
 
64
<td width="18%"></td><td width="82%">
 
65
<pre>BitsPerSample              1, 2, 4, 8, 16
 
66
SamplesPerPixel            1, 3, 4 (the 4th sample is ignored)
 
67
PhotometricInterpretation  0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 (palette), 6 (YCbCr)
 
68
PlanarConfiguration        1 (contiguous), 2 (separate)
 
69
Orientation                1 (top-left), 4 (bottom-left)
 
70
</pre></td></table>
 
71
 
 
72
<table width="100%" border=0 rules="none" frame="void"
 
73
       cols="2" cellspacing="0" cellpadding="0">
 
74
<tr valign="top" align="left">
 
75
<td width="10%"></td><td width="90%">
 
76
Data may be organized as strips or tiles and may be
 
77
compressed with any of the compression algorithms supported
 
78
by the <i>libtiff</i>(3) library.</td></table>
 
79
 
 
80
<table width="100%" border=0 rules="none" frame="void"
 
81
       cols="2" cellspacing="0" cellpadding="0">
 
82
<tr valign="top" align="left">
 
83
<td width="10%"></td><td width="90%">
 
84
For palette images (<i>PhotomatricInterpretation</i>=3),
 
85
<i>tiffgt</i> inspects the colormap values and assumes
 
86
either 16-bit or 8-bit values according to the maximum
 
87
value. That is, if no colormap entry greater than 255 is
 
88
found, <i>tiffgt</i> assumes the colormap has only 8-bit
 
89
values; otherwise it assumes 16-bit values. This inspection
 
90
is done to handle old images written by previous (incorrect)
 
91
versions of <i>libtiff</i>.</td></table>
 
92
 
 
93
<table width="100%" border=0 rules="none" frame="void"
 
94
       cols="2" cellspacing="0" cellpadding="0">
 
95
<tr valign="top" align="left">
 
96
<td width="10%"></td><td width="90%">
 
97
<i>tiffgt</i> can be used to display multiple images
 
98
one-at-a-time. The left mouse button switches the display to
 
99
the first image in the <i>next</i> file in the list of files
 
100
specified on the command line. The right mouse button
 
101
switches to the first image in the <i>previous</i> file in
 
102
the list. The middle mouse button causes the first image in
 
103
the first file specified on the command line to be
 
104
displayed. In addition the following keyboard commands are
 
105
recognized:</td></table>
 
106
 
 
107
<table width="100%" border=0 rules="none" frame="void"
 
108
       cols="2" cellspacing="0" cellpadding="0">
 
109
<tr valign="top" align="left">
 
110
<td width="10%"></td><td width="90%">
 
111
<b>b</b></td></table>
 
112
 
 
113
<table width="100%" border=0 rules="none" frame="void"
 
114
       cols="2" cellspacing="0" cellpadding="0">
 
115
<tr valign="top" align="left">
 
116
<td width="21%"></td><td width="79%">
 
117
Use a <i>PhotometricIntepretation</i> of MinIsBlack in
 
118
displaying the current image.</td></table>
 
119
 
 
120
<table width="100%" border=0 rules="none" frame="void"
 
121
       cols="2" cellspacing="0" cellpadding="0">
 
122
<tr valign="top" align="left">
 
123
<td width="10%"></td><td width="90%">
 
124
<b>l</b></td></table>
 
125
 
 
126
<table width="100%" border=0 rules="none" frame="void"
 
127
       cols="2" cellspacing="0" cellpadding="0">
 
128
<tr valign="top" align="left">
 
129
<td width="21%"></td><td width="79%">
 
130
Use a <i>FillOrder</i> of lsb-to-msb in decoding the current
 
131
image.</td></table>
 
132
 
 
133
<table width="100%" border=0 rules="none" frame="void"
 
134
       cols="2" cellspacing="0" cellpadding="0">
 
135
<tr valign="top" align="left">
 
136
<td width="10%"></td><td width="90%">
 
137
<b>m</b></td></table>
 
138
 
 
139
<table width="100%" border=0 rules="none" frame="void"
 
140
       cols="2" cellspacing="0" cellpadding="0">
 
141
<tr valign="top" align="left">
 
142
<td width="21%"></td><td width="79%">
 
143
Use a <i>FillOrder</i> of msb-tolmsb in decoding the current
 
144
image.</td></table>
 
145
 
 
146
<table width="100%" border=0 rules="none" frame="void"
 
147
       cols="2" cellspacing="0" cellpadding="0">
 
148
<tr valign="top" align="left">
 
149
<td width="10%"></td><td width="90%">
 
150
<b>c</b></td></table>
 
151
 
 
152
<table width="100%" border=0 rules="none" frame="void"
 
153
       cols="2" cellspacing="0" cellpadding="0">
 
154
<tr valign="top" align="left">
 
155
<td width="21%"></td><td width="79%">
 
156
Use a colormap visual to display the current
 
157
image.</td></table>
 
158
 
 
159
<table width="100%" border=0 rules="none" frame="void"
 
160
       cols="2" cellspacing="0" cellpadding="0">
 
161
<tr valign="top" align="left">
 
162
<td width="10%"></td><td width="90%">
 
163
<b>r</b></td></table>
 
164
 
 
165
<table width="100%" border=0 rules="none" frame="void"
 
166
       cols="2" cellspacing="0" cellpadding="0">
 
167
<tr valign="top" align="left">
 
168
<td width="21%"></td><td width="79%">
 
169
Use a true color (24-bit RGB) visual to display the current
 
170
image.</td></table>
 
171
 
 
172
<table width="100%" border=0 rules="none" frame="void"
 
173
       cols="2" cellspacing="0" cellpadding="0">
 
174
<tr valign="top" align="left">
 
175
<td width="10%"></td><td width="90%">
 
176
<b>w</b></td></table>
 
177
 
 
178
<table width="100%" border=0 rules="none" frame="void"
 
179
       cols="2" cellspacing="0" cellpadding="0">
 
180
<tr valign="top" align="left">
 
181
<td width="21%"></td><td width="79%">
 
182
Use a <i>PhotometricIntepretation</i> of MinIsWhite in
 
183
displaying the current image.</td></table>
 
184
 
 
185
<table width="100%" border=0 rules="none" frame="void"
 
186
       cols="2" cellspacing="0" cellpadding="0">
 
187
<tr valign="top" align="left">
 
188
<td width="10%"></td><td width="90%">
 
189
<b>W</b></td></table>
 
190
 
 
191
<table width="100%" border=0 rules="none" frame="void"
 
192
       cols="2" cellspacing="0" cellpadding="0">
 
193
<tr valign="top" align="left">
 
194
<td width="21%"></td><td width="79%">
 
195
Toggle (enable/disable) display of warning messages from the
 
196
<small>TIFF</small> library when decoding
 
197
images.</td></table>
 
198
 
 
199
<table width="100%" border=0 rules="none" frame="void"
 
200
       cols="2" cellspacing="0" cellpadding="0">
 
201
<tr valign="top" align="left">
 
202
<td width="10%"></td><td width="90%">
 
203
<b>E</b></td></table>
 
204
 
 
205
<table width="100%" border=0 rules="none" frame="void"
 
206
       cols="2" cellspacing="0" cellpadding="0">
 
207
<tr valign="top" align="left">
 
208
<td width="21%"></td><td width="79%">
 
209
Toggle (enable/disable) display of error messages from the
 
210
<small>TIFF</small> library when decoding
 
211
images.</td></table>
 
212
 
 
213
<table width="100%" border=0 rules="none" frame="void"
 
214
       cols="2" cellspacing="0" cellpadding="0">
 
215
<tr valign="top" align="left">
 
216
<td width="10%"></td><td width="90%">
 
217
<b>z</b></td></table>
 
218
 
 
219
<table width="100%" border=0 rules="none" frame="void"
 
220
       cols="2" cellspacing="0" cellpadding="0">
 
221
<tr valign="top" align="left">
 
222
<td width="21%"></td><td width="79%">
 
223
Reset all parameters to their default settings
 
224
(<i>FillOrder</i>, <i>PhotometricInterpretation</i>,
 
225
handling of warnings and errors).</td></table>
 
226
 
 
227
<table width="100%" border=0 rules="none" frame="void"
 
228
       cols="2" cellspacing="0" cellpadding="0">
 
229
<tr valign="top" align="left">
 
230
<td width="10%"></td><td width="90%">
 
231
<b>PageUp</b></td></table>
 
232
 
 
233
<table width="100%" border=0 rules="none" frame="void"
 
234
       cols="2" cellspacing="0" cellpadding="0">
 
235
<tr valign="top" align="left">
 
236
<td width="21%"></td><td width="79%">
 
237
Display the previous image in the current file or the last
 
238
image in the previous file.</td></table>
 
239
 
 
240
<table width="100%" border=0 rules="none" frame="void"
 
241
       cols="2" cellspacing="0" cellpadding="0">
 
242
<tr valign="top" align="left">
 
243
<td width="10%"></td><td width="90%">
 
244
<b>PageDown</b></td></table>
 
245
 
 
246
<table width="100%" border=0 rules="none" frame="void"
 
247
       cols="2" cellspacing="0" cellpadding="0">
 
248
<tr valign="top" align="left">
 
249
<td width="21%"></td><td width="79%">
 
250
Display the next image in the current file or the first
 
251
image in the next file.</td></table>
 
252
 
 
253
<table width="100%" border=0 rules="none" frame="void"
 
254
       cols="2" cellspacing="0" cellpadding="0">
 
255
<tr valign="top" align="left">
 
256
<td width="10%"></td><td width="90%">
 
257
<b>Home</b></td></table>
 
258
 
 
259
<table width="100%" border=0 rules="none" frame="void"
 
260
       cols="2" cellspacing="0" cellpadding="0">
 
261
<tr valign="top" align="left">
 
262
<td width="21%"></td><td width="79%">
 
263
Display the first image in the current file.</td></table>
 
264
 
 
265
<table width="100%" border=0 rules="none" frame="void"
 
266
       cols="2" cellspacing="0" cellpadding="0">
 
267
<tr valign="top" align="left">
 
268
<td width="10%"></td><td width="90%">
 
269
<b>End</b></td></table>
 
270
 
 
271
<table width="100%" border=0 rules="none" frame="void"
 
272
       cols="2" cellspacing="0" cellpadding="0">
 
273
<tr valign="top" align="left">
 
274
<td width="21%"></td><td width="79%">
 
275
Display the last image in the current file
 
276
(unimplemented).</td></table>
 
277
<a name="OPTIONS"></a>
 
278
<h2>OPTIONS</h2>
 
279
 
 
280
<table width="100%" border=0 rules="none" frame="void"
 
281
       cols="2" cellspacing="0" cellpadding="0">
 
282
<tr valign="top" align="left">
 
283
<td width="10%"></td><td width="90%">
 
284
<b>-c</b></td></table>
 
285
 
 
286
<table width="100%" border=0 rules="none" frame="void"
 
287
       cols="2" cellspacing="0" cellpadding="0">
 
288
<tr valign="top" align="left">
 
289
<td width="21%"></td><td width="79%">
 
290
Force image display in a colormap window.</td></table>
 
291
 
 
292
<table width="100%" border=0 rules="none" frame="void"
 
293
       cols="2" cellspacing="0" cellpadding="0">
 
294
<tr valign="top" align="left">
 
295
<td width="10%"></td><td width="90%">
 
296
<b>-d</b></td></table>
 
297
 
 
298
<table width="100%" border=0 rules="none" frame="void"
 
299
       cols="2" cellspacing="0" cellpadding="0">
 
300
<tr valign="top" align="left">
 
301
<td width="21%"></td><td width="79%">
 
302
Specify an image to display by directory number. By default
 
303
the first image in the file is displayed. Directories are
 
304
numbered starting at zero.</td></table>
 
305
 
 
306
<table width="100%" border=0 rules="none" frame="void"
 
307
       cols="2" cellspacing="0" cellpadding="0">
 
308
<tr valign="top" align="left">
 
309
<td width="10%"></td><td width="90%">
 
310
<b>-e</b></td></table>
 
311
 
 
312
<table width="100%" border=0 rules="none" frame="void"
 
313
       cols="2" cellspacing="0" cellpadding="0">
 
314
<tr valign="top" align="left">
 
315
<td width="21%"></td><td width="79%">
 
316
Enable reporting of error messages from the
 
317
<small>TIFF</small> library. By default <i>tiffgt</i>
 
318
silently ignores images that cannot be read.</td></table>
 
319
 
 
320
<table width="100%" border=0 rules="none" frame="void"
 
321
       cols="2" cellspacing="0" cellpadding="0">
 
322
<tr valign="top" align="left">
 
323
<td width="10%"></td><td width="90%">
 
324
<b>-f</b></td></table>
 
325
 
 
326
<table width="100%" border=0 rules="none" frame="void"
 
327
       cols="2" cellspacing="0" cellpadding="0">
 
328
<tr valign="top" align="left">
 
329
<td width="21%"></td><td width="79%">
 
330
Force <i>tiffgt</i> to run as a foreground process. By
 
331
default <i>tiffgt</i> will place itself in the background
 
332
once it has opened the requested image file.</td></table>
 
333
 
 
334
<table width="100%" border=0 rules="none" frame="void"
 
335
       cols="2" cellspacing="0" cellpadding="0">
 
336
<tr valign="top" align="left">
 
337
<td width="10%"></td><td width="90%">
 
338
<b>-l</b></td></table>
 
339
 
 
340
<table width="100%" border=0 rules="none" frame="void"
 
341
       cols="2" cellspacing="0" cellpadding="0">
 
342
<tr valign="top" align="left">
 
343
<td width="21%"></td><td width="79%">
 
344
Force the presumed bit ordering to be <small>LSB</small> to
 
345
<small>MSB.</small></td></table>
 
346
 
 
347
<table width="100%" border=0 rules="none" frame="void"
 
348
       cols="2" cellspacing="0" cellpadding="0">
 
349
<tr valign="top" align="left">
 
350
<td width="10%"></td><td width="90%">
 
351
<b>-m</b></td></table>
 
352
 
 
353
<table width="100%" border=0 rules="none" frame="void"
 
354
       cols="2" cellspacing="0" cellpadding="0">
 
355
<tr valign="top" align="left">
 
356
<td width="21%"></td><td width="79%">
 
357
Force the presumed bit ordering to be <small>MSB</small> to
 
358
<small>LSB.</small></td></table>
 
359
 
 
360
<table width="100%" border=0 rules="none" frame="void"
 
361
       cols="2" cellspacing="0" cellpadding="0">
 
362
<tr valign="top" align="left">
 
363
<td width="10%"></td><td width="90%">
 
364
<b>-o</b></td></table>
 
365
 
 
366
<table width="100%" border=0 rules="none" frame="void"
 
367
       cols="2" cellspacing="0" cellpadding="0">
 
368
<tr valign="top" align="left">
 
369
<td width="21%"></td><td width="79%">
 
370
Specify an image to display by directory offset. By default
 
371
the first image in the file is displayed. Directories
 
372
offsets may be specified using C-style syntax; i.e. a
 
373
leading ``0x'' for hexadecimal and a leading ``0'' for
 
374
octal.</td></table>
 
375
 
 
376
<table width="100%" border=0 rules="none" frame="void"
 
377
       cols="2" cellspacing="0" cellpadding="0">
 
378
<tr valign="top" align="left">
 
379
<td width="10%"></td><td width="90%">
 
380
<b>-p</b></td></table>
 
381
 
 
382
<table width="100%" border=0 rules="none" frame="void"
 
383
       cols="2" cellspacing="0" cellpadding="0">
 
384
<tr valign="top" align="left">
 
385
<td width="21%"></td><td width="79%">
 
386
Override the value of the <i>PhotometricInterpretation</i>
 
387
tag; the parameter may be one of: <i>miniswhite</i>,
 
388
<i>minisblack</i>, <i>rgb</i>, <i>palette</i>, <i>mask</i>,
 
389
<i>separated</i>, <i>ycbcr</i>, and
 
390
<i>cielab</i>.</td></table>
 
391
 
 
392
<table width="100%" border=0 rules="none" frame="void"
 
393
       cols="2" cellspacing="0" cellpadding="0">
 
394
<tr valign="top" align="left">
 
395
<td width="10%"></td><td width="90%">
 
396
<b>-r</b></td></table>
 
397
 
 
398
<table width="100%" border=0 rules="none" frame="void"
 
399
       cols="2" cellspacing="0" cellpadding="0">
 
400
<tr valign="top" align="left">
 
401
<td width="21%"></td><td width="79%">
 
402
Force image display in a full color window.</td></table>
 
403
 
 
404
<table width="100%" border=0 rules="none" frame="void"
 
405
       cols="2" cellspacing="0" cellpadding="0">
 
406
<tr valign="top" align="left">
 
407
<td width="10%"></td><td width="90%">
 
408
<b>-s</b></td></table>
 
409
 
 
410
<table width="100%" border=0 rules="none" frame="void"
 
411
       cols="2" cellspacing="0" cellpadding="0">
 
412
<tr valign="top" align="left">
 
413
<td width="21%"></td><td width="79%">
 
414
Stop on the first read error. By default all errors in the
 
415
input data are ignored and <i>tiffgt</i> does it's best to
 
416
display as much of an image as possible.</td></table>
 
417
 
 
418
<table width="100%" border=0 rules="none" frame="void"
 
419
       cols="2" cellspacing="0" cellpadding="0">
 
420
<tr valign="top" align="left">
 
421
<td width="10%"></td><td width="90%">
 
422
<b>-w</b></td></table>
 
423
 
 
424
<table width="100%" border=0 rules="none" frame="void"
 
425
       cols="2" cellspacing="0" cellpadding="0">
 
426
<tr valign="top" align="left">
 
427
<td width="21%"></td><td width="79%">
 
428
Enable reporting of warning messages from the
 
429
<small>TIFF</small> library. By default <i>tiffgt</i>
 
430
ignores warning messages generated when reading an
 
431
image.</td></table>
 
432
 
 
433
<table width="100%" border=0 rules="none" frame="void"
 
434
       cols="2" cellspacing="0" cellpadding="0">
 
435
<tr valign="top" align="left">
 
436
<td width="10%"></td><td width="90%">
 
437
<b>-v</b></td></table>
 
438
 
 
439
<table width="100%" border=0 rules="none" frame="void"
 
440
       cols="2" cellspacing="0" cellpadding="0">
 
441
<tr valign="top" align="left">
 
442
<td width="21%"></td><td width="79%">
 
443
Place information in the title bar describing what type of
 
444
window (full color or colormap) is being used, the name of
 
445
the input file, and the directory index of the image (if
 
446
non-zero). By default, the window type is not shown in the
 
447
title bar.</td></table>
 
448
<a name="BUGS"></a>
 
449
<h2>BUGS</h2>
 
450
 
 
451
<table width="100%" border=0 rules="none" frame="void"
 
452
       cols="2" cellspacing="0" cellpadding="0">
 
453
<tr valign="top" align="left">
 
454
<td width="10%"></td><td width="90%">
 
455
Images wider and taller than the display are silently
 
456
truncated to avoid crashing old versions of the window
 
457
manager.</td></table>
 
458
<a name="SEE ALSO"></a>
 
459
<h2>SEE ALSO</h2>
 
460
 
 
461
<table width="100%" border=0 rules="none" frame="void"
 
462
       cols="2" cellspacing="0" cellpadding="0">
 
463
<tr valign="top" align="left">
 
464
<td width="10%"></td><td width="90%">
 
465
<i>tiffdump</i>(1), <i>tiffinfo</i>(1), <i>tiffcp</i>(1),
 
466
<i>libtiff</i>(3)</td></table>
 
467
<hr>
 
468
</body>
 
469
</html>