source-git / libtiff

Clone
Source Code
GIT

Blame html/man/tiffcp.1.html

c8 c8s master
  1.   c8
  2.   html
  3.   man
  4.   tiffcp.1.html
Blob History Raw
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>

Powered by Pagure 5.14.1

SSH Hostkey/Fingerprint | Documentation