User Commands tiffcp(1)
NAME
tiffcp - copy, and possibly convert, a TIF 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 TIF 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
TIF 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 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 CIT Group 3
compression algo-
rithm.
-c g4 CIT 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 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.
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 CIT 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 TIF 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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWTiff
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
|
