source: trunk/src/3rdparty/libtiff/html/man/raw2tiff.1.html

Last change on this file was 846, checked in by Dmitry A. Kuminov, 14 years ago

trunk: Merged in qt 4.7.2 sources from branches/vendor/nokia/qt.
File size: 12.4 KB
Line 
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
29raw 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
41output.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>
54image is created with data samples packed
55(<i>PlanarConfiguration</i>=1), compressed with the PackBits
56algorithm (<i>Compression</i>=32773), and with each strip no
57more than 8 kilobytes. These characteristics can overridden,
58or explicitly specified with the options described
59below.</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).
79This amount of data just will be skipped from the start of
80file 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>
99below).</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>
118below).</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>
153may 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
295image, 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
433data: <b>&minus;c none</b> for no compression, <b>&minus;c
434packbits</b> for the PackBits compression algorithm (the
435default), <b>&minus;c jpeg</b> for the baseline JPEG
436compression algorithm, <b>&minus;c zip</b> for the Deflate
437compression algorithm, and <b>&minus;c lzw</b> for
438Lempel-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
458default the number of rows/strip is selected so that each
459strip 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
471one or both of these parameters are not specified. If you
472omit one of those parameters, the complementary one will be
473calculated based on the file size (taking into account
474header size, number of bands and data type). If you omit
475both parameters, the statistical approach will be used.
476Utility will compute correlation coefficient between two
477lines at the image center using several appropriate line
478sizes and the highest absolute value of the coefficient will
479indicate the right line size. That is why you should be
480cautious with the very large images, because guessing
481process may take a while (depending on your system
482performance). Of course, the utility can&rsquo;t guess the
483header size, number of bands and data type, so it should be
484specified manually. If you don&rsquo;t know anything about
485your image, just try with the several combinations of those
486options.</p>
487<!-- INDENTATION -->
488<p>There is no magic, it is just a mathematical statistics,
489so it can be wrong in some cases. But for most ordinary
490images 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>
Note: See TracBrowser for help on using the repository browser.