]> git.saurik.com Git - wxWidgets.git/blob - src/tiff/html/man/tiffcp.1.html
Merged libtiff 4.0.3 changes into the trunk.
[wxWidgets.git] / src / tiff / html / man / tiffcp.1.html
1 <!-- Creator : groff version 1.18.1 -->
2 <!-- CreationDate: Sat Feb 24 18:37:20 2007 -->
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
41 dst.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
53 according to the Tag Image File Format, Revision 6.0 into a
54 single <small>TIFF</small> file. Because the output file may
55 be compressed using a different algorithm than the input
56 files, <i>tiffcp</i> is most often used to convert between
57 different compression schemes.</p>
58 <!-- INDENTATION -->
59 <p>By default, <i>tiffcp</i> will copy all the understood
60 tags in a <small>TIFF</small> directory of an input file to
61 the associated directory in the output file.</p>
62 <!-- INDENTATION -->
63 <p><i>tiffcp</i> can be used to reorganize the storage
64 characteristics of data in a file, but it is explicitly
65 intended to not alter or convert the image data content in
66 any 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</b> <i>image</i></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
86 processed. This can be used to remove a noise bias from a
87 set of images. This bias image is typically an image of
88 noise 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.
104 This option only has an effect when the output file is
105 created 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
119 chopping&rsquo;&rsquo; when reading images that have a
120 single 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
134 output file: <b>none</b> for no compression, <b>packbits</b>
135 for PackBits compression, <b>lzw</b> for Lempel-Ziv &amp;
136 Welch compression, <b>jpeg</b> for baseline JPEG
137 compression, <b>zip</b> for Deflate compression, <b>g3</b>
138 for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT
139 Group 4 (T.6) compression. By default <i>tiffcp</i> will
140 compress 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
153 algorithms can only be used with bilevel data.</p>
154 <!-- INDENTATION -->
155 <p>Group 3 compression can be specified together with
156 several T.4-specific options: <b>1d</b> for 1-dimensional
157 encoding, <b>2d</b> for 2-dimensional encoding, and
158 <b>fill</b> to force each encoded scanline to be zero-filled
159 so that the terminating EOL code lies on a byte boundary.
160 Group 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
163 g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL
164 codes.</p>
165 <!-- INDENTATION -->
166 <p><small>LZW</small> compression can be specified together
167 with a <i>predictor</i> value. A predictor value of 2 causes
168 each scanline of the output image to undergo horizontal
169 differencing before it is encoded; a value of 1 forces each
170 scanline to be encoded without differencing. LZW-specific
171 options 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
174 lzw:2</b> for <small>LZW</small> compression with horizontal
175 differencing.</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
191 data. By default, <i>tiffcp</i> will create a new file with
192 the same fill order as the original. Specifying <b>&minus;f
193 lsb2msb</b> will force data to be written with the FillOrder
194 tag set to <small>LSB2MSB,</small> while <b>&minus;f
195 msb2lsb</b> will force data to be written with the FillOrder
196 tag 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;i</b></p>
205 </td>
206 <td width="5%"></td>
207 <td width="80%">
208
209 <p>Ignore non-fatal read errors and continue processing of
210 the input file.</p>
211 </td>
212 <td width="0%">
213 </td>
214 <tr valign="top" align="left">
215 <td width="10%"></td>
216 <td width="3%">
217
218 <p><b>&minus;l</b></p>
219 </td>
220 <td width="5%"></td>
221 <td width="80%">
222
223 <p>Specify the length of a tile (in pixels). <i>tiffcp</i>
224 attempts to set the tile dimensions so that no more than 8
225 kilobytes of data appear in a tile.</p>
226 </td>
227 <td width="0%">
228 </td>
229 <tr valign="top" align="left">
230 <td width="10%"></td>
231 <td width="3%">
232
233 <p><b>&minus;L</b></p>
234 </td>
235 <td width="5%"></td>
236 <td width="80%">
237
238 <p>Force output to be written with Little-Endian byte
239 order. This option only has an effect when the output file
240 is created or overwritten and not when it is appended
241 to.</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;M</b></p>
250 </td>
251 <td width="5%"></td>
252 <td width="80%">
253
254 <p>Suppress the use of memory-mapped files when reading
255 images.</p>
256 </td>
257 <td width="0%">
258 </td>
259 <tr valign="top" align="left">
260 <td width="10%"></td>
261 <td width="3%">
262
263 <p><b>&minus;p</b></p>
264 </td>
265 <td width="5%"></td>
266 <td width="80%">
267
268 <p>Specify the planar configuration to use in writing image
269 data that has one 8-bit sample per pixel. By default,
270 <i>tiffcp</i> will create a new file with the same planar
271 configuration as the original. Specifying <b>&minus;p
272 contig</b> will force data to be written with multi-sample
273 data packed together, while <b>&minus;p separate</b> will
274 force samples to be written in separate planes.</p>
275 </td>
276 <td width="0%">
277 </td>
278 <tr valign="top" align="left">
279 <td width="10%"></td>
280 <td width="3%">
281
282 <p><b>&minus;r</b></p>
283 </td>
284 <td width="5%"></td>
285 <td width="80%">
286
287 <p>Specify the number of rows (scanlines) in each strip of
288 data written to the output file. By default (or when value
289 <b>0</b> is specified), <i>tiffcp</i> attempts to set the
290 rows/strip that no more than 8 kilobytes of data appear in a
291 strip. If you specify special value <b>&minus;1</b> it will
292 results in infinite number of the rows per strip. The entire
293 image will be the one strip in that case.</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;s</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
307 in strips (rather than tiles).</p>
308 </td>
309 <td width="0%">
310 </td>
311 <tr valign="top" align="left">
312 <td width="10%"></td>
313 <td width="3%">
314
315 <p><b>&minus;t</b></p>
316 </td>
317 <td width="5%"></td>
318 <td width="80%">
319
320 <p>Force the output file to be written with data organized
321 in tiles (rather than strips). options can be used to force
322 the resultant image to be written as strips or tiles of
323 data, respectively.</p>
324 </td>
325 <td width="0%">
326 </td>
327 <tr valign="top" align="left">
328 <td width="10%"></td>
329 <td width="3%">
330
331 <p><b>&minus;w</b></p>
332 </td>
333 <td width="5%"></td>
334 <td width="80%">
335
336 <p>Specify the width of a tile (in pixels). <i>tiffcp</i>
337 attempts to set the tile dimensions so that no more than 8
338 kilobytes of data appear in a tile. <i>tiffcp</i> attempts
339 to set the tile dimensions so that no more than 8 kilobytes
340 of data appear in a tile.</p>
341 </td>
342 <td width="0%">
343 </td>
344 <tr valign="top" align="left">
345 <td width="10%"></td>
346 <td width="3%">
347
348 <p><b>&minus;x</b></p>
349 </td>
350 <td width="5%"></td>
351 <td width="80%">
352
353 <p>Force the output file to be written with PAGENUMBER value
354 in sequence.</p>
355 </td>
356 <td width="0%">
357 </td>
358 </table>
359 <!-- INDENTATION -->
360 <table width="100%" border=0 rules="none" frame="void"
361 cols="2" cellspacing="0" cellpadding="0">
362 <tr valign="top" align="left">
363 <td width="8%"></td>
364 <td width="91%">
365 <p><b>&minus;,=</b><i>character</i></p></td>
366 </table>
367 <!-- INDENTATION -->
368 <table width="100%" border=0 rules="none" frame="void"
369 cols="2" cellspacing="0" cellpadding="0">
370 <tr valign="top" align="left">
371 <td width="19%"></td>
372 <td width="80%">
373 <p>substitute <i>character</i> for &lsquo;,&rsquo; in
374 parsing image directory indices in files. This is necessary
375 if filenames contain commas. Note that <b>&minus;,=</b> with
376 whitespace immediately following will disable the special
377 meaning of the &lsquo;,&rsquo; entirely. See examples.</p>
378 </td>
379 </table>
380 <a name="EXAMPLES"></a>
381 <h2>EXAMPLES</h2>
382 <!-- INDENTATION -->
383 <table width="100%" border=0 rules="none" frame="void"
384 cols="2" cellspacing="0" cellpadding="0">
385 <tr valign="top" align="left">
386 <td width="8%"></td>
387 <td width="91%">
388 <p>The following concatenates two files and writes the
389 result using <small>LZW</small> encoding:</p></td>
390 </table>
391 <!-- INDENTATION -->
392 <table width="100%" border=0 rules="none" frame="void"
393 cols="2" cellspacing="0" cellpadding="0">
394 <tr valign="top" align="left">
395 <td width="17%"></td>
396 <td width="82%">
397 <pre>tiffcp &minus;c lzw a.tif b.tif result.tif
398 </pre>
399 </td>
400 </table>
401 <!-- INDENTATION -->
402
403 <table width="100%" border=0 rules="none" frame="void"
404 cols="2" cellspacing="0" cellpadding="0">
405 <tr valign="top" align="left">
406 <td width="8%"></td>
407 <td width="91%">
408 <p>To convert a G3 1d-encoded <small>TIFF</small> to a
409 single strip of G4-encoded data the following might be
410 used:</p></td>
411 </table>
412 <!-- INDENTATION -->
413 <table width="100%" border=0 rules="none" frame="void"
414 cols="2" cellspacing="0" cellpadding="0">
415 <tr valign="top" align="left">
416 <td width="17%"></td>
417 <td width="82%">
418 <pre>tiffcp &minus;c g4 &minus;r 10000 g3.tif g4.tif
419 </pre>
420 </td>
421 </table>
422 <!-- INDENTATION -->
423
424 <table width="100%" border=0 rules="none" frame="void"
425 cols="2" cellspacing="0" cellpadding="0">
426 <tr valign="top" align="left">
427 <td width="8%"></td>
428 <td width="91%">
429 <p>(1000 is just a number that is larger than the number of
430 rows in the source file.)</p>
431 <!-- INDENTATION -->
432 <p>To extract a selected set of images from a multi-image
433 TIFF file, the file name may be immediately followed by a
434 &lsquo;,&rsquo; separated list of image directory indices.
435 The first image is always in directory 0. Thus, to copy the
436 1st and 3rd images of image file
437 &lsquo;&lsquo;album.tif&rsquo;&rsquo; to
438 &lsquo;&lsquo;result.tif&rsquo;&rsquo;:</p></td>
439 </table>
440 <!-- INDENTATION -->
441 <table width="100%" border=0 rules="none" frame="void"
442 cols="2" cellspacing="0" cellpadding="0">
443 <tr valign="top" align="left">
444 <td width="17%"></td>
445 <td width="82%">
446 <pre>tiffcp album.tif,0,2 result.tif
447 </pre>
448 </td>
449 </table>
450 <!-- INDENTATION -->
451
452 <table width="100%" border=0 rules="none" frame="void"
453 cols="2" cellspacing="0" cellpadding="0">
454 <tr valign="top" align="left">
455 <td width="8%"></td>
456 <td width="91%">
457 <p>A trailing comma denotes remaining images in sequence.
458 The following command will copy all image with except the
459 first one:</p></td>
460 </table>
461 <!-- INDENTATION -->
462 <table width="100%" border=0 rules="none" frame="void"
463 cols="2" cellspacing="0" cellpadding="0">
464 <tr valign="top" align="left">
465 <td width="17%"></td>
466 <td width="82%">
467 <pre>tiffcp album.tif,1, result.tif
468 </pre>
469 </td>
470 </table>
471 <!-- INDENTATION -->
472
473 <table width="100%" border=0 rules="none" frame="void"
474 cols="2" cellspacing="0" cellpadding="0">
475 <tr valign="top" align="left">
476 <td width="8%"></td>
477 <td width="91%">
478 <p>Given file &lsquo;&lsquo;CCD.tif&rsquo;&rsquo; whose
479 first image is a noise bias followed by images which include
480 that bias, subtract the noise from all those images
481 following it (while decompressing) with the
482 command:</p></td>
483 </table>
484 <!-- INDENTATION -->
485 <table width="100%" border=0 rules="none" frame="void"
486 cols="2" cellspacing="0" cellpadding="0">
487 <tr valign="top" align="left">
488 <td width="17%"></td>
489 <td width="82%">
490 <pre>tiffcp &minus;c none &minus;b CCD.tif CCD.tif,1, result.tif
491 </pre>
492 </td>
493 </table>
494 <!-- INDENTATION -->
495
496 <table width="100%" border=0 rules="none" frame="void"
497 cols="2" cellspacing="0" cellpadding="0">
498 <tr valign="top" align="left">
499 <td width="8%"></td>
500 <td width="91%">
501 <p>If the file above were named
502 &lsquo;&lsquo;CCD,X.tif&rsquo;&rsquo;, the <b>&minus;,=</b>
503 option would be required to correctly parse this filename
504 with image numbers, as follows:</p></td>
505 </table>
506 <!-- INDENTATION -->
507 <table width="100%" border=0 rules="none" frame="void"
508 cols="2" cellspacing="0" cellpadding="0">
509 <tr valign="top" align="left">
510 <td width="17%"></td>
511 <td width="82%">
512 <pre>tiffcp &minus;c none &minus;,=% &minus;b CCD,X.tif CCD,X%1%.tif result.tif
513
514 </pre>
515 </td>
516 </table>
517 <a name="SEE ALSO"></a>
518 <h2>SEE ALSO</h2>
519 <!-- INDENTATION -->
520
521 <table width="100%" border=0 rules="none" frame="void"
522 cols="2" cellspacing="0" cellpadding="0">
523 <tr valign="top" align="left">
524 <td width="8%"></td>
525 <td width="91%">
526 <p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1),
527 <b>tiffmedian</b>(1), <b>tiffsplit</b>(1),
528 <b>libtiff</b>(3TIFF)</p>
529 <!-- INDENTATION -->
530 <p>Libtiff library home page:
531 <b>http://www.remotesensing.org/libtiff/</b></p>
532 </td>
533 </table>
534 <hr>
535 </body>
536 </html>