1<!-- Creator : groff version 1.18.1 --> 2<!-- CreationDate: Sat Feb 24 18:37:19 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 − 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>−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>−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>−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>−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>−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>−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>−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>−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>−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>−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>−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>−c none</b> for no compression, <b>−c 434packbits</b> for the PackBits compression algorithm (the 435default), <b>−c jpeg</b> for the baseline JPEG 436compression algorithm, <b>−c zip</b> for the Deflate 437compression algorithm, and <b>−c lzw</b> for 438Lempel-Ziv & 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>−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’t guess the 483header size, number of bands and data type, so it should be 484specified manually. If you don’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.simplesystems.org/libtiff/</b></p> 506</td> 507</table> 508<hr> 509</body> 510</html> 511