Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for tiffcp (opensolaris section 1)

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)