src/tiff/html/man/tiffcp.1.html

   1 <!-- Creator     : groff version 1.18.1 -->
   2 <!-- CreationDate: Mon Mar 13 18:03:13 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>TIFFCP</title>
   8 </head>
   9 <body>
  10
  11 <h1 align=center>TIFFCP</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="#EXAMPLES">EXAMPLES</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>tiffcp &minus; copy (and possibly convert) a
  29 <small>TIFF</small> file</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>tiffcp</b> [ <i>options</i> ] <i>src1.tif ... srcN.tif
  41 dst.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>tiffcp</i> combines one or more files created
  53 according to the Tag Image File Format, Revision 6.0 into a
  54 single <small>TIFF</small> file. Because the output file may
  55 be compressed using a different algorithm than the input
  56 files, <i>tiffcp</i> is most often used to convert between
  57 different compression schemes.</p>
  58 <!-- INDENTATION -->
  59 <p>By default, <i>tiffcp</i> will copy all the understood
  60 tags in a <small>TIFF</small> directory of an input file to
  61 the associated directory in the output file.</p>
  62 <!-- INDENTATION -->
  63 <p><i>tiffcp</i> can be used to reorganize the storage
  64 characteristics of data in a file, but it is explicitly
  65 intended to not alter or convert the image data content in
  66 any way.</p>
  67 </td>
  68 </table>
  69 <a name="OPTIONS"></a>
  70 <h2>OPTIONS</h2>
  71 <!-- INDENTATION -->
  72 <table width="100%" border=0 rules="none" frame="void"
  73        cols="2" cellspacing="0" cellpadding="0">
  74 <tr valign="top" align="left">
  75 <td width="8%"></td>
  76 <td width="91%">
  77 <p><b>&minus;b image</b></p></td>
  78 </table>
  79 <!-- INDENTATION -->
  80 <table width="100%" border=0 rules="none" frame="void"
  81        cols="2" cellspacing="0" cellpadding="0">
  82 <tr valign="top" align="left">
  83 <td width="19%"></td>
  84 <td width="80%">
  85 <p>subtract the following monochrome image from all others
  86 processed. This can be used to remove a noise bias from a
  87 set of images. This bias image is typically an image of
  88 noise the camera saw with its shutter closed.</p>
  89 </td>
  90 </table>
  91 <!-- TABS -->
  92 <table width="100%" border=0 rules="none" frame="void"
  93        cols="5" cellspacing="0" cellpadding="0">
  94 <tr valign="top" align="left">
  95 <td width="10%"></td>
  96 <td width="3%">
  97
  98 <p><b>&minus;B</b></p>
  99 </td>
 100 <td width="5%"></td>
 101 <td width="80%">
 102
 103 <p>Force output to be written with Big-Endian byte order.
 104 This option only has an effect when the output file is
 105 created or overwritten and not when it is appended to.</p>
 106 </td>
 107 <td width="0%">
 108 </td>
 109 <tr valign="top" align="left">
 110 <td width="10%"></td>
 111 <td width="3%">
 112
 113 <p><b>&minus;C</b></p>
 114 </td>
 115 <td width="5%"></td>
 116 <td width="80%">
 117
 118 <p>Suppress the use of &lsquo;&lsquo;strip
 119 chopping&rsquo;&rsquo; when reading images that have a
 120 single strip/tile of uncompressed data.</p>
 121 </td>
 122 <td width="0%">
 123 </td>
 124 <tr valign="top" align="left">
 125 <td width="10%"></td>
 126 <td width="3%">
 127
 128 <p><b>&minus;c</b></p>
 129 </td>
 130 <td width="5%"></td>
 131 <td width="80%">
 132
 133 <p>Specify the compression to use for data written to the
 134 output file: <b>none</b> for no compression, <b>packbits</b>
 135 for PackBits compression, <b>lzw</b> for Lempel-Ziv &amp;
 136 Welch compression, <b>jpeg</b> for baseline JPEG
 137 compression, <b>zip</b> for Deflate compression, <b>g3</b>
 138 for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT
 139 Group 4 (T.6) compression. By default <i>tiffcp</i> will
 140 compress data according to the value of the
 141 <i>Compression</i> tag found in the source file.</p>
 142 </td>
 143 <td width="0%">
 144 </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="17%"></td>
 151 <td width="82%">
 152 <p>The <small>CCITT</small> Group 3 and Group 4 compression
 153 algorithms can only be used with bilevel data.</p>
 154 <!-- INDENTATION -->
 155 <p>Group 3 compression can be specified together with
 156 several T.4-specific options: <b>1d</b> for 1-dimensional
 157 encoding, <b>2d</b> for 2-dimensional encoding, and
 158 <b>fill</b> to force each encoded scanline to be zero-filled
 159 so that the terminating EOL code lies on a byte boundary.
 160 Group 3-specific options are specified by appending a
 161 &lsquo;&lsquo;:&rsquo;&rsquo;-separated list to the
 162 &lsquo;&lsquo;g3&rsquo;&rsquo; option; e.g. <b>&minus;c
 163 g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL
 164 codes.</p>
 165 <!-- INDENTATION -->
 166 <p><small>LZW</small> compression can be specified together
 167 with a <i>predictor</i> value. A predictor value of 2 causes
 168 each scanline of the output image to undergo horizontal
 169 differencing before it is encoded; a value of 1 forces each
 170 scanline to be encoded without differencing. LZW-specific
 171 options are specified by appending a
 172 &lsquo;&lsquo;:&rsquo;&rsquo;-separated list to the
 173 &lsquo;&lsquo;lzw&rsquo;&rsquo; option; e.g. <b>&minus;c
 174 lzw:2</b> for <small>LZW</small> compression with horizontal
 175 differencing.</p>
 176 </td>
 177 </table>
 178 <!-- TABS -->
 179 <table width="100%" border=0 rules="none" frame="void"
 180        cols="5" cellspacing="0" cellpadding="0">
 181 <tr valign="top" align="left">
 182 <td width="10%"></td>
 183 <td width="3%">
 184
 185 <p><b>&minus;f</b></p>
 186 </td>
 187 <td width="5%"></td>
 188 <td width="80%">
 189
 190 <p>Specify the bit fill order to use in writing output
 191 data. By default, <i>tiffcp</i> will create a new file with
 192 the same fill order as the original. Specifying <b>&minus;f
 193 lsb2msb</b> will force data to be written with the FillOrder
 194 tag set to <small>LSB2MSB,</small> while <b>&minus;f
 195 msb2lsb</b> will force data to be written with the FillOrder
 196 tag set to <small>MSB2LSB.</small></p>
 197 </td>
 198 <td width="0%">
 199 </td>
 200 <tr valign="top" align="left">
 201 <td width="10%"></td>
 202 <td width="3%">
 203
 204 <p><b>&minus;l</b></p>
 205 </td>
 206 <td width="5%"></td>
 207 <td width="80%">
 208
 209 <p>Specify the length of a tile (in pixels). <i>tiffcp</i>
 210 attempts to set the tile dimensions so that no more than 8
 211 kilobytes of data appear in a tile.</p>
 212 </td>
 213 <td width="0%">
 214 </td>
 215 <tr valign="top" align="left">
 216 <td width="10%"></td>
 217 <td width="3%">
 218
 219 <p><b>&minus;L</b></p>
 220 </td>
 221 <td width="5%"></td>
 222 <td width="80%">
 223
 224 <p>Force output to be written with Little-Endian byte
 225 order. This option only has an effect when the output file
 226 is created or overwritten and not when it is appended
 227 to.</p>
 228 </td>
 229 <td width="0%">
 230 </td>
 231 <tr valign="top" align="left">
 232 <td width="10%"></td>
 233 <td width="3%">
 234
 235 <p><b>&minus;M</b></p>
 236 </td>
 237 <td width="5%"></td>
 238 <td width="80%">
 239
 240 <p>Suppress the use of memory-mapped files when reading
 241 images.</p>
 242 </td>
 243 <td width="0%">
 244 </td>
 245 <tr valign="top" align="left">
 246 <td width="10%"></td>
 247 <td width="3%">
 248
 249 <p><b>&minus;p</b></p>
 250 </td>
 251 <td width="5%"></td>
 252 <td width="80%">
 253
 254 <p>Specify the planar configuration to use in writing image
 255 data that has one 8-bit sample per pixel. By default,
 256 <i>tiffcp</i> will create a new file with the same planar
 257 configuration as the original. Specifying <b>&minus;p
 258 contig</b> will force data to be written with multi-sample
 259 data packed together, while <b>&minus;p separate</b> will
 260 force samples to be written in separate planes.</p>
 261 </td>
 262 <td width="0%">
 263 </td>
 264 <tr valign="top" align="left">
 265 <td width="10%"></td>
 266 <td width="3%">
 267
 268 <p><b>&minus;r</b></p>
 269 </td>
 270 <td width="5%"></td>
 271 <td width="80%">
 272
 273 <p>Specify the number of rows (scanlines) in each strip of
 274 data written to the output file. By default (or when value
 275 <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
 277 strip. If you specify special value <b>-1</b> it will
 278 results in infinite number of the rows per strip. The entire
 279 image will be the one strip in that case.</p>
 280 </td>
 281 <td width="0%">
 282 </td>
 283 <tr valign="top" align="left">
 284 <td width="10%"></td>
 285 <td width="3%">
 286
 287 <p><b>&minus;s</b></p>
 288 </td>
 289 <td width="5%"></td>
 290 <td width="80%">
 291
 292 <p>Force the output file to be written with data organized
 293 in strips (rather than tiles).</p>
 294 </td>
 295 <td width="0%">
 296 </td>
 297 <tr valign="top" align="left">
 298 <td width="10%"></td>
 299 <td width="3%">
 300
 301 <p><b>&minus;t</b></p>
 302 </td>
 303 <td width="5%"></td>
 304 <td width="80%">
 305
 306 <p>Force the output file to be written with data organized
 307 in tiles (rather than strips). options can be used to force
 308 the resultant image to be written as strips or tiles of
 309 data, respectively.</p>
 310 </td>
 311 <td width="0%">
 312 </td>
 313 <tr valign="top" align="left">
 314 <td width="10%"></td>
 315 <td width="3%">
 316
 317 <p><b>&minus;w</b></p>
 318 </td>
 319 <td width="5%"></td>
 320 <td width="80%">
 321
 322 <p>Specify the width of a tile (in pixels). <i>tiffcp</i>
 323 attempts to set the tile dimensions so that no more than 8
 324 kilobytes of data appear in a tile. <i>tiffcp</i> attempts
 325 to set the tile dimensions so that no more than 8 kilobytes
 326 of data appear in a tile.</p>
 327 </td>
 328 <td width="0%">
 329 </td>
 330 </table>
 331 <!-- INDENTATION -->
 332 <table width="100%" border=0 rules="none" frame="void"
 333        cols="2" cellspacing="0" cellpadding="0">
 334 <tr valign="top" align="left">
 335 <td width="8%"></td>
 336 <td width="91%">
 337 <p><b>&minus;,={character}</b></p></td>
 338 </table>
 339 <!-- INDENTATION -->
 340 <table width="100%" border=0 rules="none" frame="void"
 341        cols="2" cellspacing="0" cellpadding="0">
 342 <tr valign="top" align="left">
 343 <td width="19%"></td>
 344 <td width="80%">
 345 <p>substitute {character} for &rsquo;,&rsquo; in parsing
 346 image directory indices in files. This is necessary if
 347 filenames contain commas. Note that &rsquo;,=&rsquo; with
 348 whitespace immediately following will disable the special
 349 meaning of the &rsquo;,&rsquo; entirely. See examples.</p>
 350 </td>
 351 </table>
 352 <a name="EXAMPLES"></a>
 353 <h2>EXAMPLES</h2>
 354 <!-- INDENTATION -->
 355 <table width="100%" border=0 rules="none" frame="void"
 356        cols="2" cellspacing="0" cellpadding="0">
 357 <tr valign="top" align="left">
 358 <td width="8%"></td>
 359 <td width="91%">
 360 <p>The following concatenates two files and writes the
 361 result using <small>LZW</small> encoding:</p></td>
 362 </table>
 363 <!-- INDENTATION -->
 364 <table width="100%" border=0 rules="none" frame="void"
 365        cols="2" cellspacing="0" cellpadding="0">
 366 <tr valign="top" align="left">
 367 <td width="17%"></td>
 368 <td width="82%">
 369 <pre>tiffcp -c lzw a.tif b.tif result.tif
 370 </pre>
 371 </td>
 372 </table>
 373 <!-- INDENTATION -->
 374
 375 <table width="100%" border=0 rules="none" frame="void"
 376        cols="2" cellspacing="0" cellpadding="0">
 377 <tr valign="top" align="left">
 378 <td width="8%"></td>
 379 <td width="91%">
 380 <p>To convert a G3 1d-encoded <small>TIFF</small> to a
 381 single strip of G4-encoded data the following might be
 382 used:</p></td>
 383 </table>
 384 <!-- INDENTATION -->
 385 <table width="100%" border=0 rules="none" frame="void"
 386        cols="2" cellspacing="0" cellpadding="0">
 387 <tr valign="top" align="left">
 388 <td width="17%"></td>
 389 <td width="82%">
 390 <pre>tiffcp -c g4 -r 10000 g3.tif g4.tif
 391 </pre>
 392 </td>
 393 </table>
 394 <!-- INDENTATION -->
 395
 396 <table width="100%" border=0 rules="none" frame="void"
 397        cols="2" cellspacing="0" cellpadding="0">
 398 <tr valign="top" align="left">
 399 <td width="8%"></td>
 400 <td width="91%">
 401 <p>(1000 is just a number that is larger than the number of
 402 rows in the source file.)</p>
 403 <!-- INDENTATION -->
 404 <p>To extract a selected set of images from a multi-image
 405 TIFF file, the file name may be immediately followed by a
 406 &rsquo;,&rsquo; separated list of image directory indices.
 407 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
 409 &quot;result.tif&quot;:</p></td>
 410 </table>
 411 <!-- INDENTATION -->
 412 <table width="100%" border=0 rules="none" frame="void"
 413        cols="2" cellspacing="0" cellpadding="0">
 414 <tr valign="top" align="left">
 415 <td width="17%"></td>
 416 <td width="82%">
 417 <pre>tiffcp album.tif,0,2 result.tif
 418 </pre>
 419 </td>
 420 </table>
 421 <!-- INDENTATION -->
 422
 423 <table width="100%" border=0 rules="none" frame="void"
 424        cols="2" cellspacing="0" cellpadding="0">
 425 <tr valign="top" align="left">
 426 <td width="8%"></td>
 427 <td width="91%">
 428 <p>Given file &quot;CCD.tif&quot; whose first image is a
 429 noise bias followed by images which include that bias,
 430 subtract the noise from all those images following it (while
 431 decompressing) with the command:</p></td>
 432 </table>
 433 <!-- INDENTATION -->
 434 <table width="100%" border=0 rules="none" frame="void"
 435        cols="2" cellspacing="0" cellpadding="0">
 436 <tr valign="top" align="left">
 437 <td width="17%"></td>
 438 <td width="82%">
 439 <pre>tiffcp -c none -b CCD.tif CCD.tif,1, result.tif
 440 </pre>
 441 </td>
 442 </table>
 443 <!-- INDENTATION -->
 444
 445 <table width="100%" border=0 rules="none" frame="void"
 446        cols="2" cellspacing="0" cellpadding="0">
 447 <tr valign="top" align="left">
 448 <td width="8%"></td>
 449 <td width="91%">
 450 <p>If the file above were named &quot;CCD,X.tif&quot;, the
 451 &quot;-,=&quot; option would be required to correctly parse
 452 this filename with image numbers, as follows:</p></td>
 453 </table>
 454 <!-- INDENTATION -->
 455 <table width="100%" border=0 rules="none" frame="void"
 456        cols="2" cellspacing="0" cellpadding="0">
 457 <tr valign="top" align="left">
 458 <td width="17%"></td>
 459 <td width="82%">
 460 <pre>tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
 461
 462 </pre>
 463 </td>
 464 </table>
 465 <a name="SEE ALSO"></a>
 466 <h2>SEE ALSO</h2>
 467 <!-- INDENTATION -->
 468
 469 <table width="100%" border=0 rules="none" frame="void"
 470        cols="2" cellspacing="0" cellpadding="0">
 471 <tr valign="top" align="left">
 472 <td width="8%"></td>
 473 <td width="91%">
 474 <p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1),
 475 <b>tiffmedian</b>(1), <b>tiffsplit</b>(1),
 476 <b>libtiff</b>(3TIFF)</p>
 477 <!-- INDENTATION -->
 478 <p>Libtiff library home page:
 479 <b>http://www.remotesensing.org/libtiff/</b></p>
 480 </td>
 481 </table>
 482 <hr>
 483 </body>
 484 </html>