]> git.saurik.com Git - wxWidgets.git/blame - src/tiff/html/man/raw2tiff.1.html
wxMessageBox off the main thread lost result code.
[wxWidgets.git] / src / tiff / html / man / raw2tiff.1.html
CommitLineData
8414a40c 1<!-- Creator : groff version 1.18.1 -->
80ed523f 2<!-- CreationDate: Sat Feb 24 18:37:19 2007 -->
8414a40c
VZ
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
80ed523f
VZ
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>
8414a40c
VZ
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%">
80ed523f 70<p><b>&minus;H</b> <i>number</i></p></td>
8414a40c
VZ
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%">
80ed523f 89<p><b>&minus;w</b> <i>number</i></p></td>
8414a40c
VZ
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%">
80ed523f 108<p><b>&minus;l</b> <i>number</i></p></td>
8414a40c
VZ
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%">
80ed523f 116<p>length of input image in lines (can be guessed, see
8414a40c
VZ
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%">
80ed523f 127<p><b>&minus;b</b> <i>number</i></p></td>
8414a40c
VZ
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%">
80ed523f 144<p><b>&minus;d</b> <i>data_type</i></p></td>
8414a40c
VZ
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%">
80ed523f 152<p>type of samples in input image, where <i>data_type</i>
8414a40c
VZ
153may be:</p></td>
154</table>
155<!-- TABS -->
156<table width="100%" border=0 rules="none" frame="void"
80ed523f 157 cols="3" cellspacing="0" cellpadding="0">
8414a40c
VZ
158<tr valign="top" align="left">
159<td width="19%"></td>
80ed523f 160<td width="10%">
8414a40c 161
80ed523f 162<p><b>byte</b></p>
8414a40c 163</td>
80ed523f 164<td width="70%">
8414a40c
VZ
165
166<p>8-bit unsigned integer (default),</p>
167</td>
8414a40c
VZ
168<tr valign="top" align="left">
169<td width="19%"></td>
80ed523f 170<td width="10%">
8414a40c 171
80ed523f 172<p><b>short</b></p>
8414a40c 173</td>
80ed523f 174<td width="70%">
8414a40c
VZ
175
176<p>16-bit unsigned integer,</p>
177</td>
8414a40c
VZ
178<tr valign="top" align="left">
179<td width="19%"></td>
80ed523f 180<td width="10%">
8414a40c 181
80ed523f 182<p><b>long</b></p>
8414a40c 183</td>
80ed523f 184<td width="70%">
8414a40c
VZ
185
186<p>32-bit unsigned integer,</p>
187</td>
8414a40c
VZ
188<tr valign="top" align="left">
189<td width="19%"></td>
80ed523f 190<td width="10%">
8414a40c 191
80ed523f 192<p><b>sbyte</b></p>
8414a40c 193</td>
80ed523f 194<td width="70%">
8414a40c
VZ
195
196<p>8-bit signed integer,</p>
197</td>
8414a40c
VZ
198<tr valign="top" align="left">
199<td width="19%"></td>
80ed523f 200<td width="10%">
8414a40c 201
80ed523f 202<p><b>sshort</b></p>
8414a40c 203</td>
80ed523f 204<td width="70%">
8414a40c
VZ
205
206<p>16-bit signed integer,</p>
207</td>
8414a40c
VZ
208<tr valign="top" align="left">
209<td width="19%"></td>
80ed523f 210<td width="10%">
8414a40c 211
80ed523f 212<p><b>slong</b></p>
8414a40c 213</td>
80ed523f 214<td width="70%">
8414a40c
VZ
215
216<p>32-bit signed integer,</p>
217</td>
8414a40c
VZ
218<tr valign="top" align="left">
219<td width="19%"></td>
80ed523f 220<td width="10%">
8414a40c 221
80ed523f 222<p><b>float</b></p>
8414a40c 223</td>
80ed523f 224<td width="70%">
8414a40c
VZ
225
226<p>32-bit IEEE floating point,</p>
227</td>
8414a40c
VZ
228<tr valign="top" align="left">
229<td width="19%"></td>
80ed523f 230<td width="10%">
8414a40c 231
80ed523f 232<p><b>double</b></p>
8414a40c 233</td>
80ed523f 234<td width="70%">
8414a40c 235
80ed523f 236<p>64-bit IEEE floating point.</p>
8414a40c
VZ
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%">
80ed523f 245<p><b>&minus;i</b> <i>config</i></p></td>
8414a40c
VZ
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
80ed523f 254<i>config</i> may be:</p></td>
8414a40c
VZ
255</table>
256<!-- TABS -->
257<table width="100%" border=0 rules="none" frame="void"
80ed523f 258 cols="3" cellspacing="0" cellpadding="0">
8414a40c
VZ
259<tr valign="top" align="left">
260<td width="19%"></td>
80ed523f 261<td width="8%">
8414a40c 262
80ed523f 263<p><b>pixel</b></p>
8414a40c 264</td>
80ed523f 265<td width="71%">
8414a40c
VZ
266
267<p>pixel interleaved data (default),</p>
268</td>
8414a40c
VZ
269<tr valign="top" align="left">
270<td width="19%"></td>
80ed523f 271<td width="8%">
8414a40c 272
80ed523f 273<p><b>band</b></p>
8414a40c 274</td>
80ed523f 275<td width="71%">
8414a40c
VZ
276
277<p>band interleaved data.</p>
278</td>
8414a40c
VZ
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%">
80ed523f 286<p><b>&minus;p</b> <i>photo</i></p></td>
8414a40c
VZ
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
80ed523f 295image, where <i>photo</i> may be:</p></td>
8414a40c
VZ
296</table>
297<!-- TABS -->
298<table width="100%" border=0 rules="none" frame="void"
80ed523f 299 cols="3" cellspacing="0" cellpadding="0">
8414a40c
VZ
300<tr valign="top" align="left">
301<td width="19%"></td>
80ed523f 302<td width="15%">
8414a40c 303
80ed523f 304<p><b>miniswhite</b></p>
8414a40c 305</td>
80ed523f
VZ
306<td width="65%">
307
308<p>white color represented with 0 value,</p>
8414a40c 309</td>
80ed523f
VZ
310<tr valign="top" align="left">
311<td width="19%"></td>
312<td width="15%">
8414a40c 313
80ed523f 314<p><b>minisblack</b></p>
8414a40c 315</td>
80ed523f
VZ
316<td width="65%">
317
318<p>black color represented with 0 value (default),</p>
8414a40c
VZ
319</td>
320<tr valign="top" align="left">
321<td width="19%"></td>
80ed523f 322<td width="15%">
8414a40c 323
80ed523f 324<p><b>rgb</b></p>
8414a40c 325</td>
80ed523f
VZ
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>
8414a40c 335</td>
80ed523f 336<td width="65%">
8414a40c
VZ
337
338<p>image has CMYK (separated) color model,</p>
339</td>
8414a40c
VZ
340<tr valign="top" align="left">
341<td width="19%"></td>
80ed523f 342<td width="15%">
8414a40c 343
80ed523f 344<p><b>ycbcr</b></p>
8414a40c 345</td>
80ed523f 346<td width="65%">
8414a40c
VZ
347
348<p>image has YCbCr color model,</p>
349</td>
8414a40c
VZ
350<tr valign="top" align="left">
351<td width="19%"></td>
80ed523f 352<td width="15%">
8414a40c 353
80ed523f 354<p><b>cielab</b></p>
8414a40c 355</td>
80ed523f 356<td width="65%">
8414a40c
VZ
357
358<p>image has CIE L*a*b color model,</p>
359</td>
8414a40c
VZ
360<tr valign="top" align="left">
361<td width="19%"></td>
80ed523f 362<td width="15%">
8414a40c 363
80ed523f 364<p><b>icclab</b></p>
8414a40c 365</td>
80ed523f 366<td width="65%">
8414a40c
VZ
367
368<p>image has ICC L*a*b color model,</p>
369</td>
8414a40c
VZ
370<tr valign="top" align="left">
371<td width="19%"></td>
80ed523f 372<td width="15%">
8414a40c 373
80ed523f 374<p><b>itulab</b></p>
8414a40c 375</td>
80ed523f 376<td width="65%">
8414a40c 377
80ed523f 378<p>image has ITU L*a*b color model.</p>
8414a40c
VZ
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
80ed523f 433data: <b>&minus;c none</b> for no compression, <b>&minus;c
8414a40c 434packbits</b> for the PackBits compression algorithm (the
80ed523f
VZ
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>
8414a40c
VZ
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%">
80ed523f 449<p><b>&minus;r</b> <i>number</i></p></td>
8414a40c
VZ
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>