Blame html/man/tiffcp.1.html

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

TIFFCP

Packit 7838c8
NAME
Packit 7838c8
SYNOPSIS
Packit 7838c8
DESCRIPTION
Packit 7838c8
OPTIONS
Packit 7838c8
EXAMPLES
Packit 7838c8
SEE ALSO
Packit 7838c8
Packit 7838c8

Packit 7838c8
Packit 7838c8

NAME

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

tiffcp − copy (and possibly convert) a

Packit 7838c8
<small>TIFF</small> file

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

SYNOPSIS

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

Packit 7838c8
dst.tif

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

DESCRIPTION

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

tiffcp combines one or more files created

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

Packit 7838c8
Packit 7838c8

By default, tiffcp will copy all the understood

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

Packit 7838c8
Packit 7838c8

tiffcp can be used to reorganize the storage

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

OPTIONS

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="5" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−a

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Append to an existing output file instead of overwriting it.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−b

Packit 7838c8
Packit 7838c8
Packit 7838c8

subtract the following monochrome image from all others

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−B

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−C

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Suppress the use of ‘‘strip

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−c

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the compression to use for data written to the

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

Packit 7838c8
algorithms can only be used with bilevel data.

Packit 7838c8
Packit 7838c8

Group 3 compression can be specified together with

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

Packit 7838c8
Packit 7838c8

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

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="5" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−f

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the bit fill order to use in writing output

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−i

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Ignore non-fatal read errors and continue processing of

Packit 7838c8
the input file.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−l

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−L

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be written with Little-Endian byte

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−M

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Suppress the use of memory-mapped files when reading

Packit 7838c8
images.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−o

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Set initial directory offset.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−p

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the planar configuration to use in writing image

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−r

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−s

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force the output file to be written with data organized

Packit 7838c8
in strips (rather than tiles).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−t

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force the output file to be written with data organized

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−w

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−x

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force the output file to be written with PAGENUMBER value

Packit 7838c8
in sequence.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−8

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Write BigTIFF instead of classic TIFF format.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−,=character

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

substitute character for ‘,’ in

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

EXAMPLES

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

The following concatenates two files and writes the

Packit 7838c8
result using <small>LZW</small> encoding:

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

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

Packit 7838c8
single strip of G4-encoded data the following might be
Packit 7838c8
used:

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

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

Packit 7838c8
rows in the source file.)

Packit 7838c8
Packit 7838c8

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

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

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
tiffcp album.tif,0,2 result.tif
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

A trailing comma denotes remaining images in sequence.

Packit 7838c8
The following command will copy all image with except the
Packit 7838c8
first one:

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

Given file ‘‘CCD.tif’’ whose

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

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

If the file above were named

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

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

SEE ALSO

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

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

Packit 7838c8
tiffmedian(1), tiffsplit(1),
Packit 7838c8
libtiff(3TIFF)

Packit 7838c8
Packit 7838c8

Libtiff library home page:

Packit 7838c8
http://www.simplesystems.org/libtiff/

Packit 7838c8
Packit 7838c8
Packit 7838c8

Packit 7838c8
</body>
Packit 7838c8
</html>