src/tiff/html/man/raw2tiff.1.html

   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
  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>=<i>32773),</i> and with each
  57 strip no more than 8 kilobytes. These characteristics can
  58 overridden, or explicitly specified with the options
  59 described 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).
  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 &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>
  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 &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>
 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 &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>
 153 may 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
 328 image, where <b>photo</b> may be:<i><br>
 329 miniswhite</i> white color represented with 0 value,<i><br>
 330 minisblack</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
 476 data: <b>&minus;c none</b> for no compression, <b>-c
 477 packbits</b> for the PackBits compression algorithm (the
 478 default), <b>-c jpeg</b> for the baseline JPEG compression
 479 algorithm, <b>-c zip</b> for the Deflate compression
 480 algorithm, and <b>&minus;c lzw</b> for Lempel-Ziv &amp;
 481 Welch.</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
 501 default the number of rows/strip is selected so that each
 502 strip 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
 514 one or both of these parameters are not specified. If you
 515 omit one of those parameters, the complementary one will be
 516 calculated based on the file size (taking into account
 517 header size, number of bands and data type). If you omit
 518 both parameters, the statistical approach will be used.
 519 Utility will compute correlation coefficient between two
 520 lines at the image center using several appropriate line
 521 sizes and the highest absolute value of the coefficient will
 522 indicate the right line size. That is why you should be
 523 cautious with the very large images, because guessing
 524 process may take a while (depending on your system
 525 performance). Of course, the utility can&rsquo;t guess the
 526 header size, number of bands and data type, so it should be
 527 specified manually. If you don&rsquo;t know anything about
 528 your image, just try with the several combinations of those
 529 options.</p>
 530 <!-- INDENTATION -->
 531 <p>There is no magic, it is just a mathematical statistics,
 532 so it can be wrong in some cases. But for most ordinary
 533 images 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>