]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/tiff/html/man/tiffcp.1.html
fix bug with adding entries to a root group containing only subgroups (as shown by...
[wxWidgets.git] / src / tiff / html / man / tiffcp.1.html
... / ...
CommitLineData
1<!-- Creator : groff version 1.18.1 -->
2<!-- CreationDate: Mon Mar 13 18:03:13 2006 -->
3<html>
4<head>
5<meta name="generator" content="groff -Thtml, see www.gnu.org">
6<meta name="Content-Style" content="text/css">
7<title>TIFFCP</title>
8</head>
9<body>
10
11<h1 align=center>TIFFCP</h1>
12<a href="#NAME">NAME</a><br>
13<a href="#SYNOPSIS">SYNOPSIS</a><br>
14<a href="#DESCRIPTION">DESCRIPTION</a><br>
15<a href="#OPTIONS">OPTIONS</a><br>
16<a href="#EXAMPLES">EXAMPLES</a><br>
17<a href="#SEE ALSO">SEE ALSO</a><br>
18
19<hr>
20<a name="NAME"></a>
21<h2>NAME</h2>
22<!-- INDENTATION -->
23<table width="100%" border=0 rules="none" frame="void"
24 cols="2" cellspacing="0" cellpadding="0">
25<tr valign="top" align="left">
26<td width="8%"></td>
27<td width="91%">
28<p>tiffcp &minus; copy (and possibly convert) a
29<small>TIFF</small> file</p>
30</td>
31</table>
32<a name="SYNOPSIS"></a>
33<h2>SYNOPSIS</h2>
34<!-- INDENTATION -->
35<table width="100%" border=0 rules="none" frame="void"
36 cols="2" cellspacing="0" cellpadding="0">
37<tr valign="top" align="left">
38<td width="8%"></td>
39<td width="91%">
40<p><b>tiffcp</b> [ <i>options</i> ] <i>src1.tif ... srcN.tif
41dst.tif</i></p>
42</td>
43</table>
44<a name="DESCRIPTION"></a>
45<h2>DESCRIPTION</h2>
46<!-- INDENTATION -->
47<table width="100%" border=0 rules="none" frame="void"
48 cols="2" cellspacing="0" cellpadding="0">
49<tr valign="top" align="left">
50<td width="8%"></td>
51<td width="91%">
52<p><i>tiffcp</i> combines one or more files created
53according to the Tag Image File Format, Revision 6.0 into a
54single <small>TIFF</small> file. Because the output file may
55be compressed using a different algorithm than the input
56files, <i>tiffcp</i> is most often used to convert between
57different compression schemes.</p>
58<!-- INDENTATION -->
59<p>By default, <i>tiffcp</i> will copy all the understood
60tags in a <small>TIFF</small> directory of an input file to
61the associated directory in the output file.</p>
62<!-- INDENTATION -->
63<p><i>tiffcp</i> can be used to reorganize the storage
64characteristics of data in a file, but it is explicitly
65intended to not alter or convert the image data content in
66any way.</p>
67</td>
68</table>
69<a name="OPTIONS"></a>
70<h2>OPTIONS</h2>
71<!-- INDENTATION -->
72<table width="100%" border=0 rules="none" frame="void"
73 cols="2" cellspacing="0" cellpadding="0">
74<tr valign="top" align="left">
75<td width="8%"></td>
76<td width="91%">
77<p><b>&minus;b image</b></p></td>
78</table>
79<!-- INDENTATION -->
80<table width="100%" border=0 rules="none" frame="void"
81 cols="2" cellspacing="0" cellpadding="0">
82<tr valign="top" align="left">
83<td width="19%"></td>
84<td width="80%">
85<p>subtract the following monochrome image from all others
86processed. This can be used to remove a noise bias from a
87set of images. This bias image is typically an image of
88noise the camera saw with its shutter closed.</p>
89</td>
90</table>
91<!-- TABS -->
92<table width="100%" border=0 rules="none" frame="void"
93 cols="5" cellspacing="0" cellpadding="0">
94<tr valign="top" align="left">
95<td width="10%"></td>
96<td width="3%">
97
98<p><b>&minus;B</b></p>
99</td>
100<td width="5%"></td>
101<td width="80%">
102
103<p>Force output to be written with Big-Endian byte order.
104This option only has an effect when the output file is
105created or overwritten and not when it is appended to.</p>
106</td>
107<td width="0%">
108</td>
109<tr valign="top" align="left">
110<td width="10%"></td>
111<td width="3%">
112
113<p><b>&minus;C</b></p>
114</td>
115<td width="5%"></td>
116<td width="80%">
117
118<p>Suppress the use of &lsquo;&lsquo;strip
119chopping&rsquo;&rsquo; when reading images that have a
120single strip/tile of uncompressed data.</p>
121</td>
122<td width="0%">
123</td>
124<tr valign="top" align="left">
125<td width="10%"></td>
126<td width="3%">
127
128<p><b>&minus;c</b></p>
129</td>
130<td width="5%"></td>
131<td width="80%">
132
133<p>Specify the compression to use for data written to the
134output file: <b>none</b> for no compression, <b>packbits</b>
135for PackBits compression, <b>lzw</b> for Lempel-Ziv &amp;
136Welch compression, <b>jpeg</b> for baseline JPEG
137compression, <b>zip</b> for Deflate compression, <b>g3</b>
138for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT
139Group 4 (T.6) compression. By default <i>tiffcp</i> will
140compress data according to the value of the
141<i>Compression</i> tag found in the source file.</p>
142</td>
143<td width="0%">
144</td>
145</table>
146<!-- INDENTATION -->
147<table width="100%" border=0 rules="none" frame="void"
148 cols="2" cellspacing="0" cellpadding="0">
149<tr valign="top" align="left">
150<td width="17%"></td>
151<td width="82%">
152<p>The <small>CCITT</small> Group 3 and Group 4 compression
153algorithms can only be used with bilevel data.</p>
154<!-- INDENTATION -->
155<p>Group 3 compression can be specified together with
156several T.4-specific options: <b>1d</b> for 1-dimensional
157encoding, <b>2d</b> for 2-dimensional encoding, and
158<b>fill</b> to force each encoded scanline to be zero-filled
159so that the terminating EOL code lies on a byte boundary.
160Group 3-specific options are specified by appending a
161&lsquo;&lsquo;:&rsquo;&rsquo;-separated list to the
162&lsquo;&lsquo;g3&rsquo;&rsquo; option; e.g. <b>&minus;c
163g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL
164codes.</p>
165<!-- INDENTATION -->
166<p><small>LZW</small> compression can be specified together
167with a <i>predictor</i> value. A predictor value of 2 causes
168each scanline of the output image to undergo horizontal
169differencing before it is encoded; a value of 1 forces each
170scanline to be encoded without differencing. LZW-specific
171options are specified by appending a
172&lsquo;&lsquo;:&rsquo;&rsquo;-separated list to the
173&lsquo;&lsquo;lzw&rsquo;&rsquo; option; e.g. <b>&minus;c
174lzw:2</b> for <small>LZW</small> compression with horizontal
175differencing.</p>
176</td>
177</table>
178<!-- TABS -->
179<table width="100%" border=0 rules="none" frame="void"
180 cols="5" cellspacing="0" cellpadding="0">
181<tr valign="top" align="left">
182<td width="10%"></td>
183<td width="3%">
184
185<p><b>&minus;f</b></p>
186</td>
187<td width="5%"></td>
188<td width="80%">
189
190<p>Specify the bit fill order to use in writing output
191data. By default, <i>tiffcp</i> will create a new file with
192the same fill order as the original. Specifying <b>&minus;f
193lsb2msb</b> will force data to be written with the FillOrder
194tag set to <small>LSB2MSB,</small> while <b>&minus;f
195msb2lsb</b> will force data to be written with the FillOrder
196tag set to <small>MSB2LSB.</small></p>
197</td>
198<td width="0%">
199</td>
200<tr valign="top" align="left">
201<td width="10%"></td>
202<td width="3%">
203
204<p><b>&minus;l</b></p>
205</td>
206<td width="5%"></td>
207<td width="80%">
208
209<p>Specify the length of a tile (in pixels). <i>tiffcp</i>
210attempts to set the tile dimensions so that no more than 8
211kilobytes of data appear in a tile.</p>
212</td>
213<td width="0%">
214</td>
215<tr valign="top" align="left">
216<td width="10%"></td>
217<td width="3%">
218
219<p><b>&minus;L</b></p>
220</td>
221<td width="5%"></td>
222<td width="80%">
223
224<p>Force output to be written with Little-Endian byte
225order. This option only has an effect when the output file
226is created or overwritten and not when it is appended
227to.</p>
228</td>
229<td width="0%">
230</td>
231<tr valign="top" align="left">
232<td width="10%"></td>
233<td width="3%">
234
235<p><b>&minus;M</b></p>
236</td>
237<td width="5%"></td>
238<td width="80%">
239
240<p>Suppress the use of memory-mapped files when reading
241images.</p>
242</td>
243<td width="0%">
244</td>
245<tr valign="top" align="left">
246<td width="10%"></td>
247<td width="3%">
248
249<p><b>&minus;p</b></p>
250</td>
251<td width="5%"></td>
252<td width="80%">
253
254<p>Specify the planar configuration to use in writing image
255data that has one 8-bit sample per pixel. By default,
256<i>tiffcp</i> will create a new file with the same planar
257configuration as the original. Specifying <b>&minus;p
258contig</b> will force data to be written with multi-sample
259data packed together, while <b>&minus;p separate</b> will
260force samples to be written in separate planes.</p>
261</td>
262<td width="0%">
263</td>
264<tr valign="top" align="left">
265<td width="10%"></td>
266<td width="3%">
267
268<p><b>&minus;r</b></p>
269</td>
270<td width="5%"></td>
271<td width="80%">
272
273<p>Specify the number of rows (scanlines) in each strip of
274data written to the output file. By default (or when value
275<b>0</b> is specified), <i>tiffcp</i> attempts to set the
276rows/strip that no more than 8 kilobytes of data appear in a
277strip. If you specify special value <b>-1</b> it will
278results in infinite number of the rows per strip. The entire
279image will be the one strip in that case.</p>
280</td>
281<td width="0%">
282</td>
283<tr valign="top" align="left">
284<td width="10%"></td>
285<td width="3%">
286
287<p><b>&minus;s</b></p>
288</td>
289<td width="5%"></td>
290<td width="80%">
291
292<p>Force the output file to be written with data organized
293in strips (rather than tiles).</p>
294</td>
295<td width="0%">
296</td>
297<tr valign="top" align="left">
298<td width="10%"></td>
299<td width="3%">
300
301<p><b>&minus;t</b></p>
302</td>
303<td width="5%"></td>
304<td width="80%">
305
306<p>Force the output file to be written with data organized
307in tiles (rather than strips). options can be used to force
308the resultant image to be written as strips or tiles of
309data, respectively.</p>
310</td>
311<td width="0%">
312</td>
313<tr valign="top" align="left">
314<td width="10%"></td>
315<td width="3%">
316
317<p><b>&minus;w</b></p>
318</td>
319<td width="5%"></td>
320<td width="80%">
321
322<p>Specify the width of a tile (in pixels). <i>tiffcp</i>
323attempts to set the tile dimensions so that no more than 8
324kilobytes of data appear in a tile. <i>tiffcp</i> attempts
325to set the tile dimensions so that no more than 8 kilobytes
326of data appear in a tile.</p>
327</td>
328<td width="0%">
329</td>
330</table>
331<!-- INDENTATION -->
332<table width="100%" border=0 rules="none" frame="void"
333 cols="2" cellspacing="0" cellpadding="0">
334<tr valign="top" align="left">
335<td width="8%"></td>
336<td width="91%">
337<p><b>&minus;,={character}</b></p></td>
338</table>
339<!-- INDENTATION -->
340<table width="100%" border=0 rules="none" frame="void"
341 cols="2" cellspacing="0" cellpadding="0">
342<tr valign="top" align="left">
343<td width="19%"></td>
344<td width="80%">
345<p>substitute {character} for &rsquo;,&rsquo; in parsing
346image directory indices in files. This is necessary if
347filenames contain commas. Note that &rsquo;,=&rsquo; with
348whitespace immediately following will disable the special
349meaning of the &rsquo;,&rsquo; entirely. See examples.</p>
350</td>
351</table>
352<a name="EXAMPLES"></a>
353<h2>EXAMPLES</h2>
354<!-- INDENTATION -->
355<table width="100%" border=0 rules="none" frame="void"
356 cols="2" cellspacing="0" cellpadding="0">
357<tr valign="top" align="left">
358<td width="8%"></td>
359<td width="91%">
360<p>The following concatenates two files and writes the
361result using <small>LZW</small> encoding:</p></td>
362</table>
363<!-- INDENTATION -->
364<table width="100%" border=0 rules="none" frame="void"
365 cols="2" cellspacing="0" cellpadding="0">
366<tr valign="top" align="left">
367<td width="17%"></td>
368<td width="82%">
369<pre>tiffcp -c lzw a.tif b.tif result.tif
370</pre>
371</td>
372</table>
373<!-- INDENTATION -->
374
375<table width="100%" border=0 rules="none" frame="void"
376 cols="2" cellspacing="0" cellpadding="0">
377<tr valign="top" align="left">
378<td width="8%"></td>
379<td width="91%">
380<p>To convert a G3 1d-encoded <small>TIFF</small> to a
381single strip of G4-encoded data the following might be
382used:</p></td>
383</table>
384<!-- INDENTATION -->
385<table width="100%" border=0 rules="none" frame="void"
386 cols="2" cellspacing="0" cellpadding="0">
387<tr valign="top" align="left">
388<td width="17%"></td>
389<td width="82%">
390<pre>tiffcp -c g4 -r 10000 g3.tif g4.tif
391</pre>
392</td>
393</table>
394<!-- INDENTATION -->
395
396<table width="100%" border=0 rules="none" frame="void"
397 cols="2" cellspacing="0" cellpadding="0">
398<tr valign="top" align="left">
399<td width="8%"></td>
400<td width="91%">
401<p>(1000 is just a number that is larger than the number of
402rows in the source file.)</p>
403<!-- INDENTATION -->
404<p>To extract a selected set of images from a multi-image
405TIFF file, the file name may be immediately followed by a
406&rsquo;,&rsquo; separated list of image directory indices.
407The first image is always in directory 0. Thus, to copy the
4081st and 3rd images of image file &quot;album.tif&quot; to
409&quot;result.tif&quot;:</p></td>
410</table>
411<!-- INDENTATION -->
412<table width="100%" border=0 rules="none" frame="void"
413 cols="2" cellspacing="0" cellpadding="0">
414<tr valign="top" align="left">
415<td width="17%"></td>
416<td width="82%">
417<pre>tiffcp album.tif,0,2 result.tif
418</pre>
419</td>
420</table>
421<!-- INDENTATION -->
422
423<table width="100%" border=0 rules="none" frame="void"
424 cols="2" cellspacing="0" cellpadding="0">
425<tr valign="top" align="left">
426<td width="8%"></td>
427<td width="91%">
428<p>Given file &quot;CCD.tif&quot; whose first image is a
429noise bias followed by images which include that bias,
430subtract the noise from all those images following it (while
431decompressing) with the command:</p></td>
432</table>
433<!-- INDENTATION -->
434<table width="100%" border=0 rules="none" frame="void"
435 cols="2" cellspacing="0" cellpadding="0">
436<tr valign="top" align="left">
437<td width="17%"></td>
438<td width="82%">
439<pre>tiffcp -c none -b CCD.tif CCD.tif,1, result.tif
440</pre>
441</td>
442</table>
443<!-- INDENTATION -->
444
445<table width="100%" border=0 rules="none" frame="void"
446 cols="2" cellspacing="0" cellpadding="0">
447<tr valign="top" align="left">
448<td width="8%"></td>
449<td width="91%">
450<p>If the file above were named &quot;CCD,X.tif&quot;, the
451&quot;-,=&quot; option would be required to correctly parse
452this filename with image numbers, as follows:</p></td>
453</table>
454<!-- INDENTATION -->
455<table width="100%" border=0 rules="none" frame="void"
456 cols="2" cellspacing="0" cellpadding="0">
457<tr valign="top" align="left">
458<td width="17%"></td>
459<td width="82%">
460<pre>tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
461
462</pre>
463</td>
464</table>
465<a name="SEE ALSO"></a>
466<h2>SEE ALSO</h2>
467<!-- INDENTATION -->
468
469<table width="100%" border=0 rules="none" frame="void"
470 cols="2" cellspacing="0" cellpadding="0">
471<tr valign="top" align="left">
472<td width="8%"></td>
473<td width="91%">
474<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1),
475<b>tiffmedian</b>(1), <b>tiffsplit</b>(1),
476<b>libtiff</b>(3TIFF)</p>
477<!-- INDENTATION -->
478<p>Libtiff library home page:
479<b>http://www.remotesensing.org/libtiff/</b></p>
480</td>
481</table>
482<hr>
483</body>
484</html>