src/3rdparty/libtiff/html/man/raw2tiff.1.html
changeset 0 1918ee327afb
equal deleted inserted replaced
-1:000000000000 0:1918ee327afb
       
     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>