User Commands tiffcp(1)
NAME
tiffcp - copy, and possibly convert, a TIFF file
SYNOPSIS
tiffcp [options] src1.tif... srcN.tif dest.tif
DESCRIPTION
tiffcp combines one or more files created according to the
Tag Image File Format, Revision 6.0 into a single TIFF file.The output file might be compressed using a different algo-
rithm than the input files. Therefore. tiffcp is most often
used to convert between different compression schemes.By default, tiffcp copies all of the understood tags in a
TIFF directory of an input file, to the associated directory in the output file.tiffcp can be used to reorganize the storage characteristics
of data in a file, but is explicitly intended to not alter or convert the image data content in any way. OPTIONS The following options are supported:-B Force output to be written with Big-Endian
byte order. This option only has an effectwhen the output file is created or overwrit-
ten. This option has no effect when you append to the output file.-C Suppress the use of "strip chopping" when
reading images that have a single strip or tile of uncompressed data.-c Specify a compression scheme to use when
writing image data:-c g3 CCITT Group 3
compression algo-
rithm.-c g4 CCITT Group 4
compression algo-
rithm.SunOS 5.11 Last change: 26 Mar 2004 1
User Commands tiffcp(1)
-c jpeg Baseline JPEG
compression algo-
rithm.-c lzw Lempel-Ziv and Welch
algorithm.-c none No compression.
-c packbits PackBits compression
algorithm.-c zip Deflate compression
algorithm.By default, tiffcp compresses data according
to the value of the Compression tag found in the source file.-f Specify the bit fill order to use to write
output data. By default, tiffcp creates a
new file with the same fill order as theoriginal. Specify -f lsb2msb to force data
to be written with the FillOrder tag set toLSB2MSB. Specify -f msb2lsb to force data to
be written with the FillOrder tag set to MSB2LSB.-l Specify the length of a tile in pixels.
tiffcp attempts to set the tile dimensions
so that no more than 8 kilobytes of data appear in a tile.-L Force output to be written with Little-
Endian byte order. This option only has an effect when the output file is created or overwritten. This option has no effect when you append to the output file.SunOS 5.11 Last change: 26 Mar 2004 2
User Commands tiffcp(1)
-M Suppress the use of memory-mapped files when
reading images.-p Explicitly select the planar configuration
used to write image data that has one 8-bit
sample per pixel. By default, tiffcp creates
a new file with the same planar configura-
tion as the original.-p contig Samples are packed
contiguously.-p separate Samples are stored
separately.-r Write data with a specified number of rows
per strip. By default, the number of rows per strip is selected so that each strip is approximately 8 kilobytes.-s Force the output file to be written with
data organized in strips instead of tiles.-t Force the output file to be written with
data organized in tiles instead of strips.-w Specify the width of a tile in pixels.
tiffcp attempts to set the tile dimensions
so that no more than 8 kilobytes of data appear in a tile. OPERANDS The following operands are supported: src.tif The name of the source file.SunOS 5.11 Last change: 26 Mar 2004 3
User Commands tiffcp(1)
dest.tif The name of the destination file.EXTENDED DESCRIPTION
The CCITT Group 3 and Group 4 compression algorithms can only be used with bilevel data. Group 3 compression can be specified together with severalT.4-specific options:
1d 1-dimensional encoding
2d 2-dimensional encoding
fill Force each encoded scanline to bezero-filled so that the terminating
EOL code lies on a byte boundary.Group 3-specific options are specified by appending a
colon-separated list to the g3 option. For example, specify
-c g3:2d:fill to get 2D-encoded data with byte-aligned EOL
codes. LZW compression can be specified together with a predictor value. A predictor value of 2 causes each scanline of the output image to undergo horizontal differencing before being encoded. A predictor value of 1 forces each scanline to be encoded without differencing.LZW-specific options are specified by appending a colon-
separated list to the lzw option. For example, specify -c
lzw:2 for LZW compression with horizontal differencing.EXAMPLES
Example 1: Concatenating Two Files and Writing the Result Using LZW Encodingexample% tiffcp -c lzw a.tif b.tif result.tif
Example 2: Converting a G3 1d-Encoded TIFF to a Single Strip
of G4-Encoded Data
example% tiffcp -c g4 -r 10000 g3.tif g4.tif
SunOS 5.11 Last change: 26 Mar 2004 4
User Commands tiffcp(1)
In this example, 1000 is a number that is larger than the number of rows in the source file.ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | image/library/libtiff ||_____________________________|_____________________________|
| Interface stability | Uncommitted ||_____________________________|_____________________________|
SEE ALSO
pal2rgb(1), tiffinfo(1), tiffcmp(1), tiffmedian(1), tiffs-
plit(1), libtiff(3) NOTES Updated by Breda McColgan, Sun Microsystems Inc., 2004.SunOS 5.11 Last change: 26 Mar 2004 5