tiffcp(1) 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 algorithm 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 effect when the output file is created or
overwritten. 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 algorithm.
-c g4 CCITT Group 4 compression algorithm.
-c jpeg Baseline JPEG compression algorithm.
-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
the original. Specify -f lsb2msb to force data to be written with the FillOrder tag set to LSB2MSB. 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.
-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 configuration 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.
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 several T.4-specific options:
1d 1-dimensional encoding
2d 2-dimensional encoding
fill Force each encoded scanline to be zero-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 Encoding
example% 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
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 attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWTiff |
+-----------------------------+-----------------------------+
|Interface stability |Uncommitted |
+-----------------------------+-----------------------------+
SEE ALSO
pal2rgb(1), tiffinfo(1), tiffcmp(1), tiffmedian(1), tiffsplit(1), libtiff(3)
NOTES
Updated by Breda McColgan, Sun Microsystems Inc., 2004.
SunOS 5.11 26 Mar 2004 tiffcp(1)