Blame html/man/tiffcp.1.html

Packit 994f1a
Packit 994f1a
Packit 994f1a
<html>
Packit 994f1a
<head>
Packit 994f1a
<meta name="generator" content="groff -Thtml, see www.gnu.org">
Packit 994f1a
<meta name="Content-Style" content="text/css">
Packit 994f1a
<title>TIFFCP</title>
Packit 994f1a
</head>
Packit 994f1a
<body>
Packit 994f1a
Packit 994f1a

TIFFCP

Packit 994f1a
NAME
Packit 994f1a
SYNOPSIS
Packit 994f1a
DESCRIPTION
Packit 994f1a
OPTIONS
Packit 994f1a
EXAMPLES
Packit 994f1a
SEE ALSO
Packit 994f1a
Packit 994f1a

Packit 994f1a
Packit 994f1a

NAME

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

tiffcp − copy (and possibly convert) a

Packit 994f1a
<small>TIFF</small> file

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

SYNOPSIS

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

tiffcp [ options ] src1.tif ... srcN.tif

Packit 994f1a
dst.tif

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

DESCRIPTION

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

tiffcp combines one or more files created

Packit 994f1a
according to the Tag Image File Format, Revision 6.0 into a
Packit 994f1a
single <small>TIFF</small> file. Because the output file may
Packit 994f1a
be compressed using a different algorithm than the input
Packit 994f1a
files, tiffcp is most often used to convert between
Packit 994f1a
different compression schemes.

Packit 994f1a
Packit 994f1a

By default, tiffcp will copy all the understood

Packit 994f1a
tags in a <small>TIFF</small> directory of an input file to
Packit 994f1a
the associated directory in the output file.

Packit 994f1a
Packit 994f1a

tiffcp can be used to reorganize the storage

Packit 994f1a
characteristics of data in a file, but it is explicitly
Packit 994f1a
intended to not alter or convert the image data content in
Packit 994f1a
any way.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

OPTIONS

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−b image

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

subtract the following monochrome image from all others

Packit 994f1a
processed. This can be used to remove a noise bias from a
Packit 994f1a
set of images. This bias image is typically an image of
Packit 994f1a
noise the camera saw with its shutter closed.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="5" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−B

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be written with Big-Endian byte order.

Packit 994f1a
This option only has an effect when the output file is
Packit 994f1a
created or overwritten and not when it is appended to.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−C

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Suppress the use of ‘‘strip

Packit 994f1a
chopping’’ when reading images that have a
Packit 994f1a
single strip/tile of uncompressed data.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−c

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the compression to use for data written to the

Packit 994f1a
output file: none for no compression, packbits
Packit 994f1a
for PackBits compression, lzw for Lempel-Ziv &
Packit 994f1a
Welch compression, jpeg for baseline JPEG
Packit 994f1a
compression, zip for Deflate compression, g3
Packit 994f1a
for CCITT Group 3 (T.4) compression, and g4 for CCITT
Packit 994f1a
Group 4 (T.6) compression. By default tiffcp will
Packit 994f1a
compress data according to the value of the
Packit 994f1a
Compression tag found in the source file.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

The <small>CCITT</small> Group 3 and Group 4 compression

Packit 994f1a
algorithms can only be used with bilevel data.

Packit 994f1a
Packit 994f1a

Group 3 compression can be specified together with

Packit 994f1a
several T.4-specific options: 1d for 1-dimensional
Packit 994f1a
encoding, 2d for 2-dimensional encoding, and
Packit 994f1a
fill to force each encoded scanline to be zero-filled
Packit 994f1a
so that the terminating EOL code lies on a byte boundary.
Packit 994f1a
Group 3-specific options are specified by appending a
Packit 994f1a
‘‘:’’-separated list to the
Packit 994f1a
‘‘g3’’ option; e.g. −c
Packit 994f1a
g3:2d:fill to get 2D-encoded data with byte-aligned EOL
Packit 994f1a
codes.

Packit 994f1a
Packit 994f1a

<small>LZW</small> compression can be specified together

Packit 994f1a
with a predictor value. A predictor value of 2 causes
Packit 994f1a
each scanline of the output image to undergo horizontal
Packit 994f1a
differencing before it is encoded; a value of 1 forces each
Packit 994f1a
scanline to be encoded without differencing. LZW-specific
Packit 994f1a
options are specified by appending a
Packit 994f1a
‘‘:’’-separated list to the
Packit 994f1a
‘‘lzw’’ option; e.g. −c
Packit 994f1a
lzw:2 for <small>LZW</small> compression with horizontal
Packit 994f1a
differencing.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="5" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−f

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the bit fill order to use in writing output

Packit 994f1a
data. By default, tiffcp will create a new file with
Packit 994f1a
the same fill order as the original. Specifying −f
Packit 994f1a
lsb2msb will force data to be written with the FillOrder
Packit 994f1a
tag set to <small>LSB2MSB,</small> while −f
Packit 994f1a
msb2lsb will force data to be written with the FillOrder
Packit 994f1a
tag set to <small>MSB2LSB.</small>

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−i

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Ignore non-fatal read errors and continue processing of

Packit 994f1a
the input file.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−l

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the length of a tile (in pixels). tiffcp

Packit 994f1a
attempts to set the tile dimensions so that no more than 8
Packit 994f1a
kilobytes of data appear in a tile.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−L

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be written with Little-Endian byte

Packit 994f1a
order. This option only has an effect when the output file
Packit 994f1a
is created or overwritten and not when it is appended
Packit 994f1a
to.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−M

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Suppress the use of memory-mapped files when reading

Packit 994f1a
images.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−p

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the planar configuration to use in writing image

Packit 994f1a
data that has one 8-bit sample per pixel. By default,
Packit 994f1a
tiffcp will create a new file with the same planar
Packit 994f1a
configuration as the original. Specifying −p
Packit 994f1a
contig will force data to be written with multi-sample
Packit 994f1a
data packed together, while −p separate will
Packit 994f1a
force samples to be written in separate planes.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−r

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the number of rows (scanlines) in each strip of

Packit 994f1a
data written to the output file. By default (or when value
Packit 994f1a
0 is specified), tiffcp attempts to set the
Packit 994f1a
rows/strip that no more than 8 kilobytes of data appear in a
Packit 994f1a
strip. If you specify special value −1 it will
Packit 994f1a
results in infinite number of the rows per strip. The entire
Packit 994f1a
image will be the one strip in that case.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−s

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force the output file to be written with data organized

Packit 994f1a
in strips (rather than tiles).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−t

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force the output file to be written with data organized

Packit 994f1a
in tiles (rather than strips). options can be used to force
Packit 994f1a
the resultant image to be written as strips or tiles of
Packit 994f1a
data, respectively.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−w

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the width of a tile (in pixels). tiffcp

Packit 994f1a
attempts to set the tile dimensions so that no more than 8
Packit 994f1a
kilobytes of data appear in a tile. tiffcp attempts
Packit 994f1a
to set the tile dimensions so that no more than 8 kilobytes
Packit 994f1a
of data appear in a tile.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−x

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force the output file to be written with PAGENUMBER value

Packit 994f1a
in sequence.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−,=character

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

substitute character for ‘,’ in

Packit 994f1a
parsing image directory indices in files. This is necessary
Packit 994f1a
if filenames contain commas. Note that −,= with
Packit 994f1a
whitespace immediately following will disable the special
Packit 994f1a
meaning of the ‘,’ entirely. See examples.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

EXAMPLES

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

The following concatenates two files and writes the

Packit 994f1a
result using <small>LZW</small> encoding:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
tiffcp −c lzw a.tif b.tif result.tif
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

To convert a G3 1d-encoded <small>TIFF</small> to a

Packit 994f1a
single strip of G4-encoded data the following might be
Packit 994f1a
used:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
tiffcp −c g4 −r 10000 g3.tif g4.tif
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

(1000 is just a number that is larger than the number of

Packit 994f1a
rows in the source file.)

Packit 994f1a
Packit 994f1a

To extract a selected set of images from a multi-image

Packit 994f1a
TIFF file, the file name may be immediately followed by a
Packit 994f1a
‘,’ separated list of image directory indices.
Packit 994f1a
The first image is always in directory 0. Thus, to copy the
Packit 994f1a
1st and 3rd images of image file
Packit 994f1a
‘‘album.tif’’ to
Packit 994f1a
‘‘result.tif’’:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
tiffcp album.tif,0,2 result.tif
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

A trailing comma denotes remaining images in sequence.

Packit 994f1a
The following command will copy all image with except the
Packit 994f1a
first one:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
tiffcp album.tif,1, result.tif
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Given file ‘‘CCD.tif’’ whose

Packit 994f1a
first image is a noise bias followed by images which include
Packit 994f1a
that bias, subtract the noise from all those images
Packit 994f1a
following it (while decompressing) with the
Packit 994f1a
command:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
tiffcp −c none −b CCD.tif CCD.tif,1, result.tif
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

If the file above were named

Packit 994f1a
‘‘CCD,X.tif’’, the −,=
Packit 994f1a
option would be required to correctly parse this filename
Packit 994f1a
with image numbers, as follows:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
tiffcp −c none −,=% −b CCD,X.tif CCD,X%1%.tif result.tif
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

SEE ALSO

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

pal2rgb(1), tiffinfo(1), tiffcmp(1),

Packit 994f1a
tiffmedian(1), tiffsplit(1),
Packit 994f1a
libtiff(3TIFF)

Packit 994f1a
Packit 994f1a

Libtiff library home page:

Packit 994f1a
http://www.remotesensing.org/libtiff/

Packit 994f1a
Packit 994f1a
Packit 994f1a

Packit 994f1a
</body>
Packit 994f1a
</html>