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