TIFFCP(1) TIFFCP(1)
NAME
tiffcp - copy (and possibly convert) a TIFF file
SYNOPSIS
tiffcp [ options ] src1.tif ... srcN.tif dst.tif
DESCRIPTION
tiffcp combines one or more files created according to the Tag Image File Format,
Revision 6.0 into a single TIFF file. Because the output file may be compressed
using a different algorithm than the input files, tiffcp is most often used to con-
vert between different compression schemes.
By default, tiffcp will copy all 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
it is explicitly intended to not alter or convert the image data content in any
way.
OPTIONS
-b image
subtract the following monochrome image from all others processed. This can
be used to remove a noise bias from a set of images. This bias image is
typlically an image of noise the camera saw with its shutter closed.
-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 and not when it is
appended to.
-C Suppress the use of ‘‘strip chopping’’ when reading images that have a sin-
gle strip/tile of uncompressed data.
-c Specify the compression to use for data written to the output file: none for
no compression, packbits for PackBits compression, lzw for Lempel-Ziv &
Welch compression, jpeg for baseline JPEG compression, zip for Deflate com-
pression, g3 for CCITT Group 3 (T.4) compression, and g4 for CCITT Group 4
(T.6) compression. By default tiffcp will compress data according to the
value of the Compression tag found in the source file.
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 for 1-dimensional encoding, 2d for 2-dimensional encoding, and
fill to force each encoded scanline to be zero-filled so that the terminat-
ing EOL code lies on a byte boundary. Group 3-specific options are speci-
fied by appending a ‘‘:’’-separated list to the ‘‘g3’’ option; e.g. -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 predic-
tor value of 2 causes each scanline of the output image to undergo horizon-
tal differencing before it is encoded; a value of 1 forces each scanline to
be encoded without differencing. LZW-specific options are specified by
appending a ‘‘:’’-separated list to the ‘‘lzw’’ option; e.g. -c lzw:2 for
LZW compression with horizontal differencing.
-f Specify the bit fill order to use in writing output data. By default,
tiffcp will create a new file with the same fill order as the original.
Specifying -f lsb2msb will force data to be written with the FillOrder tag
set to LSB2MSB, while -f msb2lsb will force data to be written with the Fil-
lOrder 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 and not when it
is appended to.
-M Suppress the use of memory-mapped files when reading images.
-p Specify the planar configuration to use in writing image data that has one
8-bit sample per pixel. By default, tiffcp will create a new file with the
same planar configuration as the original. Specifying -p contig will force
data to be written with multi-sample data packed together, while -p separate
will force samples to be written in separate planes.
-r Specify the number of rows (scanlines) in each strip of data written to the
output file. By default (or when value 0 is specified), tiffcp attempts to
set the rows/strip that no more than 8 kilobytes of data appear in a strip.
If you specify special value -1 it will results in infinite number of the
rows per strip. The entire image will be the one strip in that case.
-s Force the output file to be written with data organized in strips (rather
than tiles).
-t Force the output file to be written wtih data organized in tiles (rather
than strips). options can be used to force the resultant image to be writ-
ten as strips or tiles of data, respectively.
-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.
tiffcp attempts to set the tile dimensions so that no more than 8 kilobytes
of data appear in a tile.
-,={character}
substitute {character} for ’,’ in parsing image directory indices in files.
This is necessary if filenames contain commas. Note that ’,=’ with whites-
pace immediately following will disable the special meaning of the ’,’
entirely. See examples.
EXAMPLES
The following concatenates two files and writes the result using LZW encoding:
tiffcp -c lzw a.tif b.tif result.tif
To convert a G3 1d-encoded TIFF to a single strip of G4-encoded data the following
might be used:
tiffcp -c g4 -r 10000 g3.tif g4.tif
(1000 is just a number that is larger than the number of rows in the source file.)
To extract a selected set of images from a multi-image TIFF file, the file name may
be immediately followed by a ’,’ separated list of image directory indices. The
first image is always in directory 0. Thus, to copy the 1st and 3rd images of
image file "album.tif" to "result.tif":
tiffcp album.tif,0,2 result.tif
Given file "CCD.tif" whose first image is a noise bias followed by images which
include that bias, subtract the noise from all those images following it (while
decompressing) with the command:
tiffcp -c none -b CCD.tif CCD.tif,1, result.tif
If the file above were named "CCD,X.tif", the "-,=" option would be required to
correctly parse this filename with image numbers, as follows:
tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
SEE ALSO
pal2rgb(1), tiffinfo(1), tiffcmp(1), tiffmedian(1), tiffsplit(1), libtiff(3)
February 18, 2001 TIFFCP(1)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 12:55 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)