xref: /libtiff-4.0.7/html/man/raw2tiff.1.html (revision 0dcb9ef1) 
1<!-- Creator     : groff version 1.18.1 -->
2<!-- CreationDate: Mon Mar 13 18:03:12 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>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>=<i>32773),</i> and with each
57strip no more than 8 kilobytes. These characteristics can
58overridden, or explicitly specified with the options
59described 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 &lt;number&gt;</b></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 &lt;number&gt;</b></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 &lt;number&gt;</b></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 &lt;number&gt;</b></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 data_type</b></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 <b>data_type</b>
153may be:</p></td>
154</table>
155<!-- TABS -->
156<table width="100%" border=0 rules="none" frame="void"
157       cols="5" cellspacing="0" cellpadding="0">
158<tr valign="top" align="left">
159<td width="19%"></td>
160<td width="6%">
161
162<p><i>byte</i></p>
163</td>
164<td width="6%">
165</td>
166<td width="6%">
167
168<p>8-bit unsigned integer (default),</p>
169</td>
170<td width="61%">
171</td>
172<tr valign="top" align="left">
173<td width="19%"></td>
174<td width="6%">
175
176<p><i>short</i></p>
177</td>
178<td width="6%"></td>
179<td width="6%">
180
181<p>16-bit unsigned integer,</p>
182</td>
183<td width="61%">
184</td>
185<tr valign="top" align="left">
186<td width="19%"></td>
187<td width="6%">
188
189<p><i>long</i></p>
190</td>
191<td width="6%">
192</td>
193<td width="6%">
194
195<p>32-bit unsigned integer,</p>
196</td>
197<td width="61%">
198</td>
199<tr valign="top" align="left">
200<td width="19%"></td>
201<td width="6%">
202
203<p><i>sbyte</i></p>
204</td>
205<td width="6%"></td>
206<td width="6%">
207
208<p>8-bit signed integer,</p>
209</td>
210<td width="61%">
211</td>
212<tr valign="top" align="left">
213<td width="19%"></td>
214<td width="6%">
215
216<p><i>sshort</i></p>
217</td>
218<td width="6%"></td>
219<td width="6%">
220
221<p>16-bit signed integer,</p>
222</td>
223<td width="61%">
224</td>
225<tr valign="top" align="left">
226<td width="19%"></td>
227<td width="6%">
228
229<p><i>slong</i></p>
230</td>
231<td width="6%"></td>
232<td width="6%">
233
234<p>32-bit signed integer,</p>
235</td>
236<td width="61%">
237</td>
238<tr valign="top" align="left">
239<td width="19%"></td>
240<td width="6%">
241
242<p><i>float</i></p>
243</td>
244<td width="6%"></td>
245<td width="6%">
246
247<p>32-bit IEEE floating point,</p>
248</td>
249<td width="61%">
250</td>
251<tr valign="top" align="left">
252<td width="19%"></td>
253<td width="6%">
254
255<p><i>double</i></p>
256</td>
257<td width="6%"></td>
258<td width="6%">
259
260<p>64-bit IEEE floating point,</p>
261</td>
262<td width="61%">
263</td>
264</table>
265<!-- INDENTATION -->
266<table width="100%" border=0 rules="none" frame="void"
267       cols="2" cellspacing="0" cellpadding="0">
268<tr valign="top" align="left">
269<td width="8%"></td>
270<td width="91%">
271<p><b>&minus;i config</b></p></td>
272</table>
273<!-- INDENTATION -->
274<table width="100%" border=0 rules="none" frame="void"
275       cols="2" cellspacing="0" cellpadding="0">
276<tr valign="top" align="left">
277<td width="19%"></td>
278<td width="80%">
279<p>type of samples interleaving in input image, where
280<b>config</b> may be:</p></td>
281</table>
282<!-- TABS -->
283<table width="100%" border=0 rules="none" frame="void"
284       cols="5" cellspacing="0" cellpadding="0">
285<tr valign="top" align="left">
286<td width="19%"></td>
287<td width="6%">
288
289<p><i>pixel</i></p>
290</td>
291<td width="6%"></td>
292<td width="6%">
293
294<p>pixel interleaved data (default),</p>
295</td>
296<td width="61%">
297</td>
298<tr valign="top" align="left">
299<td width="19%"></td>
300<td width="6%">
301
302<p><i>band</i></p>
303</td>
304<td width="6%">
305</td>
306<td width="6%">
307
308<p>band interleaved data.</p>
309</td>
310<td width="61%">
311</td>
312</table>
313<!-- INDENTATION -->
314<table width="100%" border=0 rules="none" frame="void"
315       cols="2" cellspacing="0" cellpadding="0">
316<tr valign="top" align="left">
317<td width="8%"></td>
318<td width="91%">
319<p><b>&minus;p photo</b></p></td>
320</table>
321<!-- INDENTATION -->
322<table width="100%" border=0 rules="none" frame="void"
323       cols="2" cellspacing="0" cellpadding="0">
324<tr valign="top" align="left">
325<td width="19%"></td>
326<td width="80%">
327<p>photometric interpretation (color space) of the input
328image, where <b>photo</b> may be:<i><br>
329miniswhite</i> white color represented with 0 value,<i><br>
330minisblack</i> black color represented with 0 value
331(default),</p></td>
332</table>
333<!-- TABS -->
334<table width="100%" border=0 rules="none" frame="void"
335       cols="6" cellspacing="0" cellpadding="0">
336<tr valign="top" align="left">
337<td width="19%"></td>
338<td width="6%">
339
340<p><i>rgb</i></p>
341</td>
342<td width="6%">
343</td>
344<td width="6%">
345
346<p>image has RGB color model,</p>
347</td>
348<td width="6%"></td>
349<td width="55%">
350</td>
351<tr valign="top" align="left">
352<td width="19%"></td>
353<td width="6%">
354
355<p><i>cmyk</i></p>
356</td>
357<td width="6%">
358</td>
359<td width="6%">
360
361<p>image has CMYK (separated) color model,</p>
362</td>
363<td width="6%"></td>
364<td width="55%">
365</td>
366<tr valign="top" align="left">
367<td width="19%"></td>
368<td width="6%">
369
370<p><i>ycbcr</i></p>
371</td>
372<td width="6%"></td>
373<td width="6%">
374</td>
375<td width="6%">
376
377<p>image has YCbCr color model,</p>
378</td>
379<td width="55%">
380</td>
381<tr valign="top" align="left">
382<td width="19%"></td>
383<td width="6%">
384
385<p><i>cielab</i></p>
386</td>
387<td width="6%"></td>
388<td width="6%">
389
390<p>image has CIE L*a*b color model,</p>
391</td>
392<td width="6%"></td>
393<td width="55%">
394</td>
395<tr valign="top" align="left">
396<td width="19%"></td>
397<td width="6%">
398
399<p><i>icclab</i></p>
400</td>
401<td width="6%"></td>
402<td width="6%">
403
404<p>image has ICC L*a*b color model,</p>
405</td>
406<td width="6%"></td>
407<td width="55%">
408</td>
409<tr valign="top" align="left">
410<td width="19%"></td>
411<td width="6%">
412
413<p><i>itulab</i></p>
414</td>
415<td width="6%"></td>
416<td width="6%">
417
418<p>image has ITU L*a*b color model,</p>
419</td>
420<td width="6%"></td>
421<td width="55%">
422</td>
423</table>
424<!-- TABS -->
425<table width="100%" border=0 rules="none" frame="void"
426       cols="5" cellspacing="0" cellpadding="0">
427<tr valign="top" align="left">
428<td width="10%"></td>
429<td width="3%">
430
431<p><b>&minus;s</b></p>
432</td>
433<td width="5%"></td>
434<td width="80%">
435
436<p>swap bytes fetched from the input file.</p>
437</td>
438<td width="0%">
439</td>
440<tr valign="top" align="left">
441<td width="10%"></td>
442<td width="3%">
443
444<p><b>&minus;L</b></p>
445</td>
446<td width="5%"></td>
447<td width="80%">
448
449<p>input data has LSB2MSB bit order (default).</p>
450</td>
451<td width="0%">
452</td>
453<tr valign="top" align="left">
454<td width="10%"></td>
455<td width="3%">
456
457<p><b>&minus;M</b></p>
458</td>
459<td width="5%"></td>
460<td width="80%">
461
462<p>input data has MSB2LSB bit order.</p>
463</td>
464<td width="0%">
465</td>
466<tr valign="top" align="left">
467<td width="10%"></td>
468<td width="3%">
469
470<p><b>&minus;c</b></p>
471</td>
472<td width="5%"></td>
473<td width="80%">
474
475<p>Specify a compression scheme to use when writing image
476data: <b>&minus;c none</b> for no compression, <b>-c
477packbits</b> for the PackBits compression algorithm (the
478default), <b>-c jpeg</b> for the baseline JPEG compression
479algorithm, <b>-c zip</b> for the Deflate compression
480algorithm, and <b>&minus;c lzw</b> for Lempel-Ziv &amp;
481Welch.</p>
482</td>
483<td width="0%">
484</td>
485</table>
486<!-- INDENTATION -->
487<table width="100%" border=0 rules="none" frame="void"
488       cols="2" cellspacing="0" cellpadding="0">
489<tr valign="top" align="left">
490<td width="8%"></td>
491<td width="91%">
492<p><b>&minus;r &lt;number&gt;</b></p></td>
493</table>
494<!-- INDENTATION -->
495<table width="100%" border=0 rules="none" frame="void"
496       cols="2" cellspacing="0" cellpadding="0">
497<tr valign="top" align="left">
498<td width="19%"></td>
499<td width="80%">
500<p>Write data with a specified number of rows per strip; by
501default the number of rows/strip is selected so that each
502strip is approximately 8 kilobytes.</p>
503</td>
504</table>
505<a name="GUESSING THE IMAGE GEOMETRY"></a>
506<h2>GUESSING THE IMAGE GEOMETRY</h2>
507<!-- INDENTATION -->
508<table width="100%" border=0 rules="none" frame="void"
509       cols="2" cellspacing="0" cellpadding="0">
510<tr valign="top" align="left">
511<td width="8%"></td>
512<td width="91%">
513<p><i>raw2tiff</i> can guess image width and height in case
514one or both of these parameters are not specified. If you
515omit one of those parameters, the complementary one will be
516calculated based on the file size (taking into account
517header size, number of bands and data type). If you omit
518both parameters, the statistical approach will be used.
519Utility will compute correlation coefficient between two
520lines at the image center using several appropriate line
521sizes and the highest absolute value of the coefficient will
522indicate the right line size. That is why you should be
523cautious with the very large images, because guessing
524process may take a while (depending on your system
525performance). Of course, the utility can&rsquo;t guess the
526header size, number of bands and data type, so it should be
527specified manually. If you don&rsquo;t know anything about
528your image, just try with the several combinations of those
529options.</p>
530<!-- INDENTATION -->
531<p>There is no magic, it is just a mathematical statistics,
532so it can be wrong in some cases. But for most ordinary
533images guessing method will work fine.</p>
534</td>
535</table>
536<a name="SEE ALSO"></a>
537<h2>SEE ALSO</h2>
538<!-- INDENTATION -->
539<table width="100%" border=0 rules="none" frame="void"
540       cols="2" cellspacing="0" cellpadding="0">
541<tr valign="top" align="left">
542<td width="8%"></td>
543<td width="91%">
544<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1),
545<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p>
546<!-- INDENTATION -->
547<p>Libtiff library home page:
548<b>http://www.remotesensing.org/libtiff/</b></p>
549</td>
550</table>
551<hr>
552</body>
553</html>
554