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

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