src/3rdparty/libtiff/html/man/tiffcp.1.html
changeset 30 5dc02b23752f
parent 0 1918ee327afb
equal deleted inserted replaced
29:b72c6db6890b 30:5dc02b23752f
     1 <!-- Creator     : groff version 1.18.1 -->
     1 <!-- Creator     : groff version 1.18.1 -->
     2 <!-- CreationDate: Mon Mar 13 18:03:13 2006 -->
     2 <!-- CreationDate: Fri Jul 13 17:43:19 2007 -->
     3 <html>
     3 <html>
     4 <head>
     4 <head>
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
     6 <meta name="Content-Style" content="text/css">
     6 <meta name="Content-Style" content="text/css">
     7 <title>TIFFCP</title>
     7 <title>TIFFCP</title>
    72 <table width="100%" border=0 rules="none" frame="void"
    72 <table width="100%" border=0 rules="none" frame="void"
    73        cols="2" cellspacing="0" cellpadding="0">
    73        cols="2" cellspacing="0" cellpadding="0">
    74 <tr valign="top" align="left">
    74 <tr valign="top" align="left">
    75 <td width="8%"></td>
    75 <td width="8%"></td>
    76 <td width="91%">
    76 <td width="91%">
    77 <p><b>&minus;b image</b></p></td>
    77 <p><b>&minus;b</b> <i>image</i></p></td>
    78 </table>
    78 </table>
    79 <!-- INDENTATION -->
    79 <!-- INDENTATION -->
    80 <table width="100%" border=0 rules="none" frame="void"
    80 <table width="100%" border=0 rules="none" frame="void"
    81        cols="2" cellspacing="0" cellpadding="0">
    81        cols="2" cellspacing="0" cellpadding="0">
    82 <tr valign="top" align="left">
    82 <tr valign="top" align="left">
   199 </td>
   199 </td>
   200 <tr valign="top" align="left">
   200 <tr valign="top" align="left">
   201 <td width="10%"></td>
   201 <td width="10%"></td>
   202 <td width="3%">
   202 <td width="3%">
   203 
   203 
       
   204 <p><b>&minus;i</b></p>
       
   205 </td>
       
   206 <td width="5%"></td>
       
   207 <td width="80%">
       
   208 
       
   209 <p>Ignore non-fatal read errors and continue processing of
       
   210 the input file.</p>
       
   211 </td>
       
   212 <td width="0%">
       
   213 </td>
       
   214 <tr valign="top" align="left">
       
   215 <td width="10%"></td>
       
   216 <td width="3%">
       
   217 
   204 <p><b>&minus;l</b></p>
   218 <p><b>&minus;l</b></p>
   205 </td>
   219 </td>
   206 <td width="5%"></td>
   220 <td width="5%"></td>
   207 <td width="80%">
   221 <td width="80%">
   208 
   222 
   272 
   286 
   273 <p>Specify the number of rows (scanlines) in each strip of
   287 <p>Specify the number of rows (scanlines) in each strip of
   274 data written to the output file. By default (or when value
   288 data written to the output file. By default (or when value
   275 <b>0</b> is specified), <i>tiffcp</i> attempts to set the
   289 <b>0</b> is specified), <i>tiffcp</i> attempts to set the
   276 rows/strip that no more than 8 kilobytes of data appear in a
   290 rows/strip that no more than 8 kilobytes of data appear in a
   277 strip. If you specify special value <b>-1</b> it will
   291 strip. If you specify special value <b>&minus;1</b> it will
   278 results in infinite number of the rows per strip. The entire
   292 results in infinite number of the rows per strip. The entire
   279 image will be the one strip in that case.</p>
   293 image will be the one strip in that case.</p>
   280 </td>
   294 </td>
   281 <td width="0%">
   295 <td width="0%">
   282 </td>
   296 </td>
   332 <table width="100%" border=0 rules="none" frame="void"
   346 <table width="100%" border=0 rules="none" frame="void"
   333        cols="2" cellspacing="0" cellpadding="0">
   347        cols="2" cellspacing="0" cellpadding="0">
   334 <tr valign="top" align="left">
   348 <tr valign="top" align="left">
   335 <td width="8%"></td>
   349 <td width="8%"></td>
   336 <td width="91%">
   350 <td width="91%">
   337 <p><b>&minus;,={character}</b></p></td>
   351 <p><b>&minus;,=</b><i>character</i></p></td>
   338 </table>
   352 </table>
   339 <!-- INDENTATION -->
   353 <!-- INDENTATION -->
   340 <table width="100%" border=0 rules="none" frame="void"
   354 <table width="100%" border=0 rules="none" frame="void"
   341        cols="2" cellspacing="0" cellpadding="0">
   355        cols="2" cellspacing="0" cellpadding="0">
   342 <tr valign="top" align="left">
   356 <tr valign="top" align="left">
   343 <td width="19%"></td>
   357 <td width="19%"></td>
   344 <td width="80%">
   358 <td width="80%">
   345 <p>substitute {character} for &rsquo;,&rsquo; in parsing
   359 <p>substitute <i>character</i> for &lsquo;,&rsquo; in
   346 image directory indices in files. This is necessary if
   360 parsing image directory indices in files. This is necessary
   347 filenames contain commas. Note that &rsquo;,=&rsquo; with
   361 if filenames contain commas. Note that <b>&minus;,=</b> with
   348 whitespace immediately following will disable the special
   362 whitespace immediately following will disable the special
   349 meaning of the &rsquo;,&rsquo; entirely. See examples.</p>
   363 meaning of the &lsquo;,&rsquo; entirely. See examples.</p>
   350 </td>
   364 </td>
   351 </table>
   365 </table>
   352 <a name="EXAMPLES"></a>
   366 <a name="EXAMPLES"></a>
   353 <h2>EXAMPLES</h2>
   367 <h2>EXAMPLES</h2>
   354 <!-- INDENTATION -->
   368 <!-- INDENTATION -->
   364 <table width="100%" border=0 rules="none" frame="void"
   378 <table width="100%" border=0 rules="none" frame="void"
   365        cols="2" cellspacing="0" cellpadding="0">
   379        cols="2" cellspacing="0" cellpadding="0">
   366 <tr valign="top" align="left">
   380 <tr valign="top" align="left">
   367 <td width="17%"></td>
   381 <td width="17%"></td>
   368 <td width="82%">
   382 <td width="82%">
   369 <pre>tiffcp -c lzw a.tif b.tif result.tif
   383 <pre>tiffcp &minus;c lzw a.tif b.tif result.tif
   370 </pre>
   384 </pre>
   371 </td>
   385 </td>
   372 </table>
   386 </table>
   373 <!-- INDENTATION -->
   387 <!-- INDENTATION -->
   374 
   388 
   385 <table width="100%" border=0 rules="none" frame="void"
   399 <table width="100%" border=0 rules="none" frame="void"
   386        cols="2" cellspacing="0" cellpadding="0">
   400        cols="2" cellspacing="0" cellpadding="0">
   387 <tr valign="top" align="left">
   401 <tr valign="top" align="left">
   388 <td width="17%"></td>
   402 <td width="17%"></td>
   389 <td width="82%">
   403 <td width="82%">
   390 <pre>tiffcp -c g4 -r 10000 g3.tif g4.tif
   404 <pre>tiffcp &minus;c g4 &minus;r 10000 g3.tif g4.tif
   391 </pre>
   405 </pre>
   392 </td>
   406 </td>
   393 </table>
   407 </table>
   394 <!-- INDENTATION -->
   408 <!-- INDENTATION -->
   395 
   409 
   401 <p>(1000 is just a number that is larger than the number of
   415 <p>(1000 is just a number that is larger than the number of
   402 rows in the source file.)</p>
   416 rows in the source file.)</p>
   403 <!-- INDENTATION -->
   417 <!-- INDENTATION -->
   404 <p>To extract a selected set of images from a multi-image
   418 <p>To extract a selected set of images from a multi-image
   405 TIFF file, the file name may be immediately followed by a
   419 TIFF file, the file name may be immediately followed by a
   406 &rsquo;,&rsquo; separated list of image directory indices.
   420 &lsquo;,&rsquo; separated list of image directory indices.
   407 The first image is always in directory 0. Thus, to copy the
   421 The first image is always in directory 0. Thus, to copy the
   408 1st and 3rd images of image file &quot;album.tif&quot; to
   422 1st and 3rd images of image file
   409 &quot;result.tif&quot;:</p></td>
   423 &lsquo;&lsquo;album.tif&rsquo;&rsquo; to
       
   424 &lsquo;&lsquo;result.tif&rsquo;&rsquo;:</p></td>
   410 </table>
   425 </table>
   411 <!-- INDENTATION -->
   426 <!-- INDENTATION -->
   412 <table width="100%" border=0 rules="none" frame="void"
   427 <table width="100%" border=0 rules="none" frame="void"
   413        cols="2" cellspacing="0" cellpadding="0">
   428        cols="2" cellspacing="0" cellpadding="0">
   414 <tr valign="top" align="left">
   429 <tr valign="top" align="left">
   423 <table width="100%" border=0 rules="none" frame="void"
   438 <table width="100%" border=0 rules="none" frame="void"
   424        cols="2" cellspacing="0" cellpadding="0">
   439        cols="2" cellspacing="0" cellpadding="0">
   425 <tr valign="top" align="left">
   440 <tr valign="top" align="left">
   426 <td width="8%"></td>
   441 <td width="8%"></td>
   427 <td width="91%">
   442 <td width="91%">
   428 <p>Given file &quot;CCD.tif&quot; whose first image is a
   443 <p>A trailing comma denotes remaining images in sequence.
   429 noise bias followed by images which include that bias,
   444 The following command will copy all image with except the
   430 subtract the noise from all those images following it (while
   445 first one:</p></td>
   431 decompressing) with the command:</p></td>
   446 </table>
   432 </table>
   447 <!-- INDENTATION -->
   433 <!-- INDENTATION -->
   448 <table width="100%" border=0 rules="none" frame="void"
   434 <table width="100%" border=0 rules="none" frame="void"
   449        cols="2" cellspacing="0" cellpadding="0">
   435        cols="2" cellspacing="0" cellpadding="0">
   450 <tr valign="top" align="left">
   436 <tr valign="top" align="left">
   451 <td width="17%"></td>
   437 <td width="17%"></td>
   452 <td width="82%">
   438 <td width="82%">
   453 <pre>tiffcp album.tif,1, result.tif
   439 <pre>tiffcp -c none -b CCD.tif CCD.tif,1, result.tif
       
   440 </pre>
   454 </pre>
   441 </td>
   455 </td>
   442 </table>
   456 </table>
   443 <!-- INDENTATION -->
   457 <!-- INDENTATION -->
   444 
   458 
   445 <table width="100%" border=0 rules="none" frame="void"
   459 <table width="100%" border=0 rules="none" frame="void"
   446        cols="2" cellspacing="0" cellpadding="0">
   460        cols="2" cellspacing="0" cellpadding="0">
   447 <tr valign="top" align="left">
   461 <tr valign="top" align="left">
   448 <td width="8%"></td>
   462 <td width="8%"></td>
   449 <td width="91%">
   463 <td width="91%">
   450 <p>If the file above were named &quot;CCD,X.tif&quot;, the
   464 <p>Given file &lsquo;&lsquo;CCD.tif&rsquo;&rsquo; whose
   451 &quot;-,=&quot; option would be required to correctly parse
   465 first image is a noise bias followed by images which include
   452 this filename with image numbers, as follows:</p></td>
   466 that bias, subtract the noise from all those images
   453 </table>
   467 following it (while decompressing) with the
   454 <!-- INDENTATION -->
   468 command:</p></td>
   455 <table width="100%" border=0 rules="none" frame="void"
   469 </table>
   456        cols="2" cellspacing="0" cellpadding="0">
   470 <!-- INDENTATION -->
   457 <tr valign="top" align="left">
   471 <table width="100%" border=0 rules="none" frame="void"
   458 <td width="17%"></td>
   472        cols="2" cellspacing="0" cellpadding="0">
   459 <td width="82%">
   473 <tr valign="top" align="left">
   460 <pre>tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
   474 <td width="17%"></td>
       
   475 <td width="82%">
       
   476 <pre>tiffcp &minus;c none &minus;b CCD.tif CCD.tif,1, result.tif
       
   477 </pre>
       
   478 </td>
       
   479 </table>
       
   480 <!-- INDENTATION -->
       
   481 
       
   482 <table width="100%" border=0 rules="none" frame="void"
       
   483        cols="2" cellspacing="0" cellpadding="0">
       
   484 <tr valign="top" align="left">
       
   485 <td width="8%"></td>
       
   486 <td width="91%">
       
   487 <p>If the file above were named
       
   488 &lsquo;&lsquo;CCD,X.tif&rsquo;&rsquo;, the <b>&minus;,=</b>
       
   489 option would be required to correctly parse this filename
       
   490 with image numbers, as follows:</p></td>
       
   491 </table>
       
   492 <!-- INDENTATION -->
       
   493 <table width="100%" border=0 rules="none" frame="void"
       
   494        cols="2" cellspacing="0" cellpadding="0">
       
   495 <tr valign="top" align="left">
       
   496 <td width="17%"></td>
       
   497 <td width="82%">
       
   498 <pre>tiffcp &minus;c none &minus;,=% &minus;b CCD,X.tif CCD,X%1%.tif result.tif
   461 
   499 
   462 </pre>
   500 </pre>
   463 </td>
   501 </td>
   464 </table>
   502 </table>
   465 <a name="SEE ALSO"></a>
   503 <a name="SEE ALSO"></a>