~ubuntu-branches/ubuntu/quantal/tiff/quantal

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Jay Berkenbilt
  • Date: 2009-08-28 15:44:23 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20090828154423-7oisj77n302jrroa
Tags: 3.9.1-1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- Creator     : groff version 1.18.1 -->
 
2
<!-- CreationDate: Fri Jul 13 17:43:18 2007 -->
 
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>RAW2TIFF</title>
 
8
</head>
 
9
<body>
 
10
 
 
11
<h1 align=center>RAW2TIFF</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="#GUESSING THE IMAGE GEOMETRY">GUESSING THE IMAGE GEOMETRY</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>raw2tiff &minus; create a <small>TIFF</small> file from a
 
29
raw data</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>raw2tiff</b> [ <i>options</i> ] <i>input.raw
 
41
output.tif</i></p>
 
42
</td>
 
43
</table>
 
44
<a name="DESCRIPTION"></a>
 
45
<h2>DESCRIPTION</h2>
 
46
<!-- INDENTATION -->
 
47
<table width="100%" border=0 rules="none" frame="void"
 
48
       cols="2" cellspacing="0" cellpadding="0">
 
49
<tr valign="top" align="left">
 
50
<td width="8%"></td>
 
51
<td width="91%">
 
52
<p><i>raw2tiff</i> converts a raw byte sequence into
 
53
<small>TIFF.</small> By default, the <small>TIFF</small>
 
54
image is created with data samples packed
 
55
(<i>PlanarConfiguration</i>=1), compressed with the PackBits
 
56
algorithm (<i>Compression</i>=32773), and with each strip no
 
57
more than 8 kilobytes. These characteristics can overridden,
 
58
or explicitly specified with the options described
 
59
below.</p>
 
60
</td>
 
61
</table>
 
62
<a name="OPTIONS"></a>
 
63
<h2>OPTIONS</h2>
 
64
<!-- INDENTATION -->
 
65
<table width="100%" border=0 rules="none" frame="void"
 
66
       cols="2" cellspacing="0" cellpadding="0">
 
67
<tr valign="top" align="left">
 
68
<td width="8%"></td>
 
69
<td width="91%">
 
70
<p><b>&minus;H</b> <i>number</i></p></td>
 
71
</table>
 
72
<!-- INDENTATION -->
 
73
<table width="100%" border=0 rules="none" frame="void"
 
74
       cols="2" cellspacing="0" cellpadding="0">
 
75
<tr valign="top" align="left">
 
76
<td width="19%"></td>
 
77
<td width="80%">
 
78
<p>size of input image file header in bytes (0 by default).
 
79
This amount of data just will be skipped from the start of
 
80
file while reading.</p>
 
81
</td>
 
82
</table>
 
83
<!-- INDENTATION -->
 
84
<table width="100%" border=0 rules="none" frame="void"
 
85
       cols="2" cellspacing="0" cellpadding="0">
 
86
<tr valign="top" align="left">
 
87
<td width="8%"></td>
 
88
<td width="91%">
 
89
<p><b>&minus;w</b> <i>number</i></p></td>
 
90
</table>
 
91
<!-- INDENTATION -->
 
92
<table width="100%" border=0 rules="none" frame="void"
 
93
       cols="2" cellspacing="0" cellpadding="0">
 
94
<tr valign="top" align="left">
 
95
<td width="19%"></td>
 
96
<td width="80%">
 
97
<p>width of input image in pixels (can be guessed, see
 
98
<b><small>GUESSING THE IMAGE GEOMETRY</small></b>
 
99
below).</p>
 
100
</td>
 
101
</table>
 
102
<!-- INDENTATION -->
 
103
<table width="100%" border=0 rules="none" frame="void"
 
104
       cols="2" cellspacing="0" cellpadding="0">
 
105
<tr valign="top" align="left">
 
106
<td width="8%"></td>
 
107
<td width="91%">
 
108
<p><b>&minus;l</b> <i>number</i></p></td>
 
109
</table>
 
110
<!-- INDENTATION -->
 
111
<table width="100%" border=0 rules="none" frame="void"
 
112
       cols="2" cellspacing="0" cellpadding="0">
 
113
<tr valign="top" align="left">
 
114
<td width="19%"></td>
 
115
<td width="80%">
 
116
<p>length of input image in lines (can be guessed, see
 
117
<b><small>GUESSING THE IMAGE GEOMETRY</small></b>
 
118
below).</p>
 
119
</td>
 
120
</table>
 
121
<!-- INDENTATION -->
 
122
<table width="100%" border=0 rules="none" frame="void"
 
123
       cols="2" cellspacing="0" cellpadding="0">
 
124
<tr valign="top" align="left">
 
125
<td width="8%"></td>
 
126
<td width="91%">
 
127
<p><b>&minus;b</b> <i>number</i></p></td>
 
128
</table>
 
129
<!-- INDENTATION -->
 
130
<table width="100%" border=0 rules="none" frame="void"
 
131
       cols="2" cellspacing="0" cellpadding="0">
 
132
<tr valign="top" align="left">
 
133
<td width="19%"></td>
 
134
<td width="80%">
 
135
<p>number of bands in input image (1 by default).</p>
 
136
</td>
 
137
</table>
 
138
<!-- INDENTATION -->
 
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="8%"></td>
 
143
<td width="91%">
 
144
<p><b>&minus;d</b> <i>data_type</i></p></td>
 
145
</table>
 
146
<!-- INDENTATION -->
 
147
<table width="100%" border=0 rules="none" frame="void"
 
148
       cols="2" cellspacing="0" cellpadding="0">
 
149
<tr valign="top" align="left">
 
150
<td width="19%"></td>
 
151
<td width="80%">
 
152
<p>type of samples in input image, where <i>data_type</i>
 
153
may be:</p></td>
 
154
</table>
 
155
<!-- TABS -->
 
156
<table width="100%" border=0 rules="none" frame="void"
 
157
       cols="3" cellspacing="0" cellpadding="0">
 
158
<tr valign="top" align="left">
 
159
<td width="19%"></td>
 
160
<td width="10%">
 
161
 
 
162
<p><b>byte</b></p>
 
163
</td>
 
164
<td width="70%">
 
165
 
 
166
<p>8-bit unsigned integer (default),</p>
 
167
</td>
 
168
<tr valign="top" align="left">
 
169
<td width="19%"></td>
 
170
<td width="10%">
 
171
 
 
172
<p><b>short</b></p>
 
173
</td>
 
174
<td width="70%">
 
175
 
 
176
<p>16-bit unsigned integer,</p>
 
177
</td>
 
178
<tr valign="top" align="left">
 
179
<td width="19%"></td>
 
180
<td width="10%">
 
181
 
 
182
<p><b>long</b></p>
 
183
</td>
 
184
<td width="70%">
 
185
 
 
186
<p>32-bit unsigned integer,</p>
 
187
</td>
 
188
<tr valign="top" align="left">
 
189
<td width="19%"></td>
 
190
<td width="10%">
 
191
 
 
192
<p><b>sbyte</b></p>
 
193
</td>
 
194
<td width="70%">
 
195
 
 
196
<p>8-bit signed integer,</p>
 
197
</td>
 
198
<tr valign="top" align="left">
 
199
<td width="19%"></td>
 
200
<td width="10%">
 
201
 
 
202
<p><b>sshort</b></p>
 
203
</td>
 
204
<td width="70%">
 
205
 
 
206
<p>16-bit signed integer,</p>
 
207
</td>
 
208
<tr valign="top" align="left">
 
209
<td width="19%"></td>
 
210
<td width="10%">
 
211
 
 
212
<p><b>slong</b></p>
 
213
</td>
 
214
<td width="70%">
 
215
 
 
216
<p>32-bit signed integer,</p>
 
217
</td>
 
218
<tr valign="top" align="left">
 
219
<td width="19%"></td>
 
220
<td width="10%">
 
221
 
 
222
<p><b>float</b></p>
 
223
</td>
 
224
<td width="70%">
 
225
 
 
226
<p>32-bit IEEE floating point,</p>
 
227
</td>
 
228
<tr valign="top" align="left">
 
229
<td width="19%"></td>
 
230
<td width="10%">
 
231
 
 
232
<p><b>double</b></p>
 
233
</td>
 
234
<td width="70%">
 
235
 
 
236
<p>64-bit IEEE floating point.</p>
 
237
</td>
 
238
</table>
 
239
<!-- INDENTATION -->
 
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="8%"></td>
 
244
<td width="91%">
 
245
<p><b>&minus;i</b> <i>config</i></p></td>
 
246
</table>
 
247
<!-- INDENTATION -->
 
248
<table width="100%" border=0 rules="none" frame="void"
 
249
       cols="2" cellspacing="0" cellpadding="0">
 
250
<tr valign="top" align="left">
 
251
<td width="19%"></td>
 
252
<td width="80%">
 
253
<p>type of samples interleaving in input image, where
 
254
<i>config</i> may be:</p></td>
 
255
</table>
 
256
<!-- TABS -->
 
257
<table width="100%" border=0 rules="none" frame="void"
 
258
       cols="3" cellspacing="0" cellpadding="0">
 
259
<tr valign="top" align="left">
 
260
<td width="19%"></td>
 
261
<td width="8%">
 
262
 
 
263
<p><b>pixel</b></p>
 
264
</td>
 
265
<td width="71%">
 
266
 
 
267
<p>pixel interleaved data (default),</p>
 
268
</td>
 
269
<tr valign="top" align="left">
 
270
<td width="19%"></td>
 
271
<td width="8%">
 
272
 
 
273
<p><b>band</b></p>
 
274
</td>
 
275
<td width="71%">
 
276
 
 
277
<p>band interleaved data.</p>
 
278
</td>
 
279
</table>
 
280
<!-- INDENTATION -->
 
281
<table width="100%" border=0 rules="none" frame="void"
 
282
       cols="2" cellspacing="0" cellpadding="0">
 
283
<tr valign="top" align="left">
 
284
<td width="8%"></td>
 
285
<td width="91%">
 
286
<p><b>&minus;p</b> <i>photo</i></p></td>
 
287
</table>
 
288
<!-- INDENTATION -->
 
289
<table width="100%" border=0 rules="none" frame="void"
 
290
       cols="2" cellspacing="0" cellpadding="0">
 
291
<tr valign="top" align="left">
 
292
<td width="19%"></td>
 
293
<td width="80%">
 
294
<p>photometric interpretation (color space) of the input
 
295
image, where <i>photo</i> may be:</p></td>
 
296
</table>
 
297
<!-- TABS -->
 
298
<table width="100%" border=0 rules="none" frame="void"
 
299
       cols="3" cellspacing="0" cellpadding="0">
 
300
<tr valign="top" align="left">
 
301
<td width="19%"></td>
 
302
<td width="15%">
 
303
 
 
304
<p><b>miniswhite</b></p>
 
305
</td>
 
306
<td width="65%">
 
307
 
 
308
<p>white color represented with 0 value,</p>
 
309
</td>
 
310
<tr valign="top" align="left">
 
311
<td width="19%"></td>
 
312
<td width="15%">
 
313
 
 
314
<p><b>minisblack</b></p>
 
315
</td>
 
316
<td width="65%">
 
317
 
 
318
<p>black color represented with 0 value (default),</p>
 
319
</td>
 
320
<tr valign="top" align="left">
 
321
<td width="19%"></td>
 
322
<td width="15%">
 
323
 
 
324
<p><b>rgb</b></p>
 
325
</td>
 
326
<td width="65%">
 
327
 
 
328
<p>image has RGB color model,</p>
 
329
</td>
 
330
<tr valign="top" align="left">
 
331
<td width="19%"></td>
 
332
<td width="15%">
 
333
 
 
334
<p><b>cmyk</b></p>
 
335
</td>
 
336
<td width="65%">
 
337
 
 
338
<p>image has CMYK (separated) color model,</p>
 
339
</td>
 
340
<tr valign="top" align="left">
 
341
<td width="19%"></td>
 
342
<td width="15%">
 
343
 
 
344
<p><b>ycbcr</b></p>
 
345
</td>
 
346
<td width="65%">
 
347
 
 
348
<p>image has YCbCr color model,</p>
 
349
</td>
 
350
<tr valign="top" align="left">
 
351
<td width="19%"></td>
 
352
<td width="15%">
 
353
 
 
354
<p><b>cielab</b></p>
 
355
</td>
 
356
<td width="65%">
 
357
 
 
358
<p>image has CIE L*a*b color model,</p>
 
359
</td>
 
360
<tr valign="top" align="left">
 
361
<td width="19%"></td>
 
362
<td width="15%">
 
363
 
 
364
<p><b>icclab</b></p>
 
365
</td>
 
366
<td width="65%">
 
367
 
 
368
<p>image has ICC L*a*b color model,</p>
 
369
</td>
 
370
<tr valign="top" align="left">
 
371
<td width="19%"></td>
 
372
<td width="15%">
 
373
 
 
374
<p><b>itulab</b></p>
 
375
</td>
 
376
<td width="65%">
 
377
 
 
378
<p>image has ITU L*a*b color model.</p>
 
379
</td>
 
380
</table>
 
381
<!-- TABS -->
 
382
<table width="100%" border=0 rules="none" frame="void"
 
383
       cols="5" cellspacing="0" cellpadding="0">
 
384
<tr valign="top" align="left">
 
385
<td width="10%"></td>
 
386
<td width="3%">
 
387
 
 
388
<p><b>&minus;s</b></p>
 
389
</td>
 
390
<td width="5%"></td>
 
391
<td width="80%">
 
392
 
 
393
<p>swap bytes fetched from the input file.</p>
 
394
</td>
 
395
<td width="0%">
 
396
</td>
 
397
<tr valign="top" align="left">
 
398
<td width="10%"></td>
 
399
<td width="3%">
 
400
 
 
401
<p><b>&minus;L</b></p>
 
402
</td>
 
403
<td width="5%"></td>
 
404
<td width="80%">
 
405
 
 
406
<p>input data has LSB2MSB bit order (default).</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>input data has MSB2LSB bit order.</p>
 
420
</td>
 
421
<td width="0%">
 
422
</td>
 
423
<tr valign="top" align="left">
 
424
<td width="10%"></td>
 
425
<td width="3%">
 
426
 
 
427
<p><b>&minus;c</b></p>
 
428
</td>
 
429
<td width="5%"></td>
 
430
<td width="80%">
 
431
 
 
432
<p>Specify a compression scheme to use when writing image
 
433
data: <b>&minus;c none</b> for no compression, <b>&minus;c
 
434
packbits</b> for the PackBits compression algorithm (the
 
435
default), <b>&minus;c jpeg</b> for the baseline JPEG
 
436
compression algorithm, <b>&minus;c zip</b> for the Deflate
 
437
compression algorithm, and <b>&minus;c lzw</b> for
 
438
Lempel-Ziv &amp; Welch.</p>
 
439
</td>
 
440
<td width="0%">
 
441
</td>
 
442
</table>
 
443
<!-- INDENTATION -->
 
444
<table width="100%" border=0 rules="none" frame="void"
 
445
       cols="2" cellspacing="0" cellpadding="0">
 
446
<tr valign="top" align="left">
 
447
<td width="8%"></td>
 
448
<td width="91%">
 
449
<p><b>&minus;r</b> <i>number</i></p></td>
 
450
</table>
 
451
<!-- INDENTATION -->
 
452
<table width="100%" border=0 rules="none" frame="void"
 
453
       cols="2" cellspacing="0" cellpadding="0">
 
454
<tr valign="top" align="left">
 
455
<td width="19%"></td>
 
456
<td width="80%">
 
457
<p>Write data with a specified number of rows per strip; by
 
458
default the number of rows/strip is selected so that each
 
459
strip is approximately 8 kilobytes.</p>
 
460
</td>
 
461
</table>
 
462
<a name="GUESSING THE IMAGE GEOMETRY"></a>
 
463
<h2>GUESSING THE IMAGE GEOMETRY</h2>
 
464
<!-- INDENTATION -->
 
465
<table width="100%" border=0 rules="none" frame="void"
 
466
       cols="2" cellspacing="0" cellpadding="0">
 
467
<tr valign="top" align="left">
 
468
<td width="8%"></td>
 
469
<td width="91%">
 
470
<p><i>raw2tiff</i> can guess image width and height in case
 
471
one or both of these parameters are not specified. If you
 
472
omit one of those parameters, the complementary one will be
 
473
calculated based on the file size (taking into account
 
474
header size, number of bands and data type). If you omit
 
475
both parameters, the statistical approach will be used.
 
476
Utility will compute correlation coefficient between two
 
477
lines at the image center using several appropriate line
 
478
sizes and the highest absolute value of the coefficient will
 
479
indicate the right line size. That is why you should be
 
480
cautious with the very large images, because guessing
 
481
process may take a while (depending on your system
 
482
performance). Of course, the utility can&rsquo;t guess the
 
483
header size, number of bands and data type, so it should be
 
484
specified manually. If you don&rsquo;t know anything about
 
485
your image, just try with the several combinations of those
 
486
options.</p>
 
487
<!-- INDENTATION -->
 
488
<p>There is no magic, it is just a mathematical statistics,
 
489
so it can be wrong in some cases. But for most ordinary
 
490
images guessing method will work fine.</p>
 
491
</td>
 
492
</table>
 
493
<a name="SEE ALSO"></a>
 
494
<h2>SEE ALSO</h2>
 
495
<!-- INDENTATION -->
 
496
<table width="100%" border=0 rules="none" frame="void"
 
497
       cols="2" cellspacing="0" cellpadding="0">
 
498
<tr valign="top" align="left">
 
499
<td width="8%"></td>
 
500
<td width="91%">
 
501
<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1),
 
502
<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p>
 
503
<!-- INDENTATION -->
 
504
<p>Libtiff library home page:
 
505
<b>http://www.remotesensing.org/libtiff/</b></p>
 
506
</td>
 
507
</table>
 
508
<hr>
 
509
</body>
 
510
</html>