Blame html/man/tiffcp.1.html

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

TIFFCP

Packit Service 2594b8
NAME
Packit Service 2594b8
SYNOPSIS
Packit Service 2594b8
DESCRIPTION
Packit Service 2594b8
OPTIONS
Packit Service 2594b8
EXAMPLES
Packit Service 2594b8
SEE ALSO
Packit Service 2594b8
Packit Service 2594b8

Packit Service 2594b8
Packit Service 2594b8

NAME

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

tiffcp − copy (and possibly convert) a

Packit Service 2594b8
<small>TIFF</small> file

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

SYNOPSIS

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
dst.tif

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

DESCRIPTION

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

tiffcp combines one or more files created

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

Packit Service 2594b8
Packit Service 2594b8

By default, tiffcp will copy all the understood

Packit Service 2594b8
tags in a <small>TIFF</small> directory of an input file to
Packit Service 2594b8
the associated directory in the output file.

Packit Service 2594b8
Packit Service 2594b8

tiffcp can be used to reorganize the storage

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

OPTIONS

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="5" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−a

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Append to an existing output file instead of overwriting it.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−b

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

subtract the following monochrome image from all others

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−B

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−C

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Suppress the use of ‘‘strip

Packit Service 2594b8
chopping’’ when reading images that have a
Packit Service 2594b8
single strip/tile of uncompressed data.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−c

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Specify the compression to use for data written to the

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
algorithms can only be used with bilevel data.

Packit Service 2594b8
Packit Service 2594b8

Group 3 compression can be specified together with

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

Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="5" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−f

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Specify the bit fill order to use in writing output

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−i

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Ignore non-fatal read errors and continue processing of

Packit Service 2594b8
the input file.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−l

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−L

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be written with Little-Endian byte

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−M

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Suppress the use of memory-mapped files when reading

Packit Service 2594b8
images.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−o

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Set initial directory offset.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−p

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Specify the planar configuration to use in writing image

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−r

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−s

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force the output file to be written with data organized

Packit Service 2594b8
in strips (rather than tiles).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−t

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force the output file to be written with data organized

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−w

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−x

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force the output file to be written with PAGENUMBER value

Packit Service 2594b8
in sequence.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−8

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Write BigTIFF instead of classic TIFF format.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−,=character

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

substitute character for ‘,’ in

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

EXAMPLES

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

The following concatenates two files and writes the

Packit Service 2594b8
result using <small>LZW</small> encoding:

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
tiffcp −c lzw a.tif b.tif result.tif
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
single strip of G4-encoded data the following might be
Packit Service 2594b8
used:

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
tiffcp −c g4 −r 10000 g3.tif g4.tif
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
rows in the source file.)

Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
tiffcp album.tif,0,2 result.tif
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

A trailing comma denotes remaining images in sequence.

Packit Service 2594b8
The following command will copy all image with except the
Packit Service 2594b8
first one:

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
tiffcp album.tif,1, result.tif
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Given file ‘‘CCD.tif’’ whose

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

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

If the file above were named

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

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

SEE ALSO

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
tiffmedian(1), tiffsplit(1),
Packit Service 2594b8
libtiff(3TIFF)

Packit Service 2594b8
Packit Service 2594b8

Libtiff library home page:

Packit Service 2594b8
http://www.simplesystems.org/libtiff/

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Packit Service 2594b8
</body>
Packit Service 2594b8
</html>