tiffcp.1.html 15 KB

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