1 .\" $Id: tiffcp.1,v 1.12 2010-12-23 13:38:47 dron Exp $
3 .\" Copyright (c) 1988-1997 Sam Leffler
4 .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
6 .\" Permission to use, copy, modify, distribute, and sell this software and
7 .\" its documentation for any purpose is hereby granted without fee, provided
8 .\" that (i) the above copyright notices and this permission notice appear in
9 .\" all copies of the software and related documentation, and (ii) the names of
10 .\" Sam Leffler and Silicon Graphics may not be used in any advertising or
11 .\" publicity relating to the software without the specific, prior written
12 .\" permission of Sam Leffler and Silicon Graphics.
14 .\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
15 .\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
16 .\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
18 .\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
19 .\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
20 .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
21 .\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
22 .\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
26 .TH TIFFCP 1 "February 24, 2007" "libtiff"
28 tiffcp \- copy (and possibly convert) a
36 .I "src1.tif ... srcN.tif dst.tif"
39 combines one or more files created according
40 to the Tag Image File Format, Revision 6.0
44 Because the output file may be compressed using a different
45 algorithm than the input files,
47 is most often used to convert between different compression
52 will copy all the understood tags in a
55 file to the associated directory in the output file.
58 can be used to reorganize the storage characteristics of data
59 in a file, but it is explicitly intended to not alter or convert
60 the image data content in any way.
64 subtract the following monochrome image from all others
65 processed. This can be used to remove a noise bias
66 from a set of images. This bias image is typically an
67 image of noise the camera saw with its shutter closed.
70 Force output to be written with Big-Endian byte order.
71 This option only has an effect when the output file is created or
72 overwritten and not when it is appended to.
75 Suppress the use of ``strip chopping'' when reading images
76 that have a single strip/tile of uncompressed data.
79 Specify the compression to use for data written to the output file:
83 for PackBits compression,
85 for Lempel-Ziv & Welch compression,
87 for Deflate compression,
89 for LZMA2 compression,
91 for baseline JPEG compression,
93 for CCITT Group 3 (T.4) compression,
96 for CCITT Group 4 (T.6) compression.
99 will compress data according to the value of the
101 tag found in the source file.
105 Group 3 and Group 4 compression algorithms can only
106 be used with bilevel data.
108 Group 3 compression can be specified together with several
109 T.4-specific options:
111 for 1-dimensional encoding,
113 for 2-dimensional encoding,
116 to force each encoded scanline to be zero-filled so that the
117 terminating EOL code lies on a byte boundary.
118 Group 3-specific options are specified by appending a ``:''-separated
119 list to the ``g3'' option; e.g.
121 to get 2D-encoded data with byte-aligned EOL codes.
126 compression can be specified together with a
128 value. A predictor value of 2 causes each scanline of the output image to
129 undergo horizontal differencing before it is encoded; a value of 1 forces each
130 scanline to be encoded without differencing. A value 3 is for floating point
131 predictor which you can use if the encoded data are in floating point format.
132 LZW-specific options are specified by appending a ``:''-separated list to the
137 compression with horizontal differencing.
142 encoders support various compression levels (or encoder presets) set as
143 character ``p'' and a preset number. ``p1'' is the fastest one with the worst
144 compression ratio and ``p9'' is the slowest but with the best possible ratio;
149 encoding with maximum compression level and floating point predictor.
152 Specify the bit fill order to use in writing output data.
155 will create a new file with the same fill order as the original.
158 will force data to be written with the FillOrder tag set to
162 will force data to be written with the FillOrder tag set to
166 Ignore non-fatal read errors and continue processing of the input file.
169 Specify the length of a tile (in pixels).
171 attempts to set the tile dimensions so
172 that no more than 8 kilobytes of data appear in a tile.
175 Force output to be written with Little-Endian byte order.
176 This option only has an effect when the output file is created or
177 overwritten and not when it is appended to.
180 Suppress the use of memory-mapped files when reading images.
183 Specify the planar configuration to use in writing image data
184 that has one 8-bit sample per pixel.
187 will create a new file with the same planar configuration as
191 will force data to be written with multi-sample data packed
194 will force samples to be written in separate planes.
197 Specify the number of rows (scanlines) in each strip of data
198 written to the output file.
199 By default (or when value
203 attempts to set the rows/strip
204 that no more than 8 kilobytes of data appear in a strip. If you specify
207 it will results in infinite number of the rows per strip. The entire image
208 will be the one strip in that case.
211 Force the output file to be written with data organized in strips
215 Force the output file to be written with data organized in tiles (rather than
216 strips). options can be used to force the resultant image to be written as
217 strips or tiles of data, respectively.
220 Specify the width of a tile (in pixels).
222 attempts to set the tile dimensions so that no more than 8 kilobytes of data
225 attempts to set the tile dimensions so that no more than 8 kilobytes of data
229 Force the output file to be written with PAGENUMBER value in sequence.
234 for `,' in parsing image directory indices
235 in files. This is necessary if filenames contain commas.
238 with whitespace immediately following will disable
239 the special meaning of the `,' entirely. See examples.
241 The following concatenates two files and writes the result using
246 tiffcp \-c lzw a.tif b.tif result.tif
250 To convert a G3 1d-encoded
252 to a single strip of G4-encoded data the following might be used:
255 tiffcp \-c g4 \-r 10000 g3.tif g4.tif
258 (1000 is just a number that is larger than the number of rows in
261 To extract a selected set of images from a multi-image TIFF file, the file
262 name may be immediately followed by a `,' separated list of image directory
263 indices. The first image is always in directory 0. Thus, to copy the 1st and
264 3rd images of image file ``album.tif'' to ``result.tif'':
267 tiffcp album.tif,0,2 result.tif
271 A trailing comma denotes remaining images in sequence. The following command
272 will copy all image with except the first one:
275 tiffcp album.tif,1, result.tif
279 Given file ``CCD.tif'' whose first image is a noise bias
280 followed by images which include that bias,
281 subtract the noise from all those images following it
282 (while decompressing) with the command:
285 tiffcp \-c none \-b CCD.tif CCD.tif,1, result.tif
289 If the file above were named ``CCD,X.tif'', the
292 be required to correctly parse this filename with image numbers,
296 tiffcp \-c none \-,=% \-b CCD,X.tif CCD,X%1%.tif result.tif
305 Libtiff library home page:
306 .BR http://www.remotesensing.org/libtiff/
projects / supertux.git / blob