|
1 <!-- Creator : groff version 1.18.1 --> |
|
2 <!-- CreationDate: Fri Jul 13 17:43:19 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>TIFFCROP</title> |
|
8 </head> |
|
9 <body> |
|
10 |
|
11 <h1 align=center>TIFFCROP</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>tiffcrop − copy, convert, crop, extract, or process |
|
29 a <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>tiffcrop</b> [ <i>options</i> ] <i>src1.tif ... |
|
41 srcN.tif 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>tiffcrop</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. The output file may be |
|
55 compressed using a different algorithm than the input files. |
|
56 <i>tiffcrop</i> is most often used to extract portions of an |
|
57 image for processing with bar code recognizer or OCR |
|
58 software when that software cannot restrict the region of |
|
59 interest to a specific portion of the image or to improve |
|
60 efficiency when the regions of interest must be rotated. It |
|
61 can also be used to subdivide all or part of a processed |
|
62 image into smaller sections.</p> |
|
63 <!-- INDENTATION --> |
|
64 <p>Functions are applied to the input image in the following |
|
65 order:</p></td> |
|
66 </table> |
|
67 <!-- INDENTATION --> |
|
68 <table width="100%" border=0 rules="none" frame="void" |
|
69 cols="2" cellspacing="0" cellpadding="0"> |
|
70 <tr valign="top" align="left"> |
|
71 <td width="17%"></td> |
|
72 <td width="82%"> |
|
73 <pre>cropping, fixed area extraction, zones, inversion, mirroring, rotation. |
|
74 </pre> |
|
75 </td> |
|
76 </table> |
|
77 <!-- INDENTATION --> |
|
78 |
|
79 <table width="100%" border=0 rules="none" frame="void" |
|
80 cols="2" cellspacing="0" cellpadding="0"> |
|
81 <tr valign="top" align="left"> |
|
82 <td width="8%"></td> |
|
83 <td width="91%"> |
|
84 <p>Functions are applied to the output image in the |
|
85 following order:</p></td> |
|
86 </table> |
|
87 <!-- INDENTATION --> |
|
88 <table width="100%" border=0 rules="none" frame="void" |
|
89 cols="2" cellspacing="0" cellpadding="0"> |
|
90 <tr valign="top" align="left"> |
|
91 <td width="17%"></td> |
|
92 <td width="82%"> |
|
93 <p>output resolution, output margins, rows and columns |
|
94 <b>or</b> page size divisions, orientation options, strip, |
|
95 tile, byte order, and compression options.</p></td> |
|
96 </table> |
|
97 <!-- INDENTATION --> |
|
98 <table width="100%" border=0 rules="none" frame="void" |
|
99 cols="2" cellspacing="0" cellpadding="0"> |
|
100 <tr valign="top" align="left"> |
|
101 <td width="8%"></td> |
|
102 <td width="91%"> |
|
103 <p>By default, <i>tiffcrop</i> will copy all the understood |
|
104 tags in a <small>TIFF</small> directory of an input file to |
|
105 the associated directory in the output file. Options can be |
|
106 used to force the resultant image to be written as strips or |
|
107 tiles of data, respectively.</p> |
|
108 <!-- INDENTATION --> |
|
109 <p><i>tiffcrop</i> can be used to reorganize the storage |
|
110 characteristics of data in a file, and to reorganize, |
|
111 extract, rotate, and otherwise process the image data as |
|
112 specified at the same time whereas tiffcp does not alter the |
|
113 image data itself.</p> |
|
114 </td> |
|
115 </table> |
|
116 <a name="OPTIONS"></a> |
|
117 <h2>OPTIONS</h2> |
|
118 <!-- INDENTATION --> |
|
119 <table width="100%" border=0 rules="none" frame="void" |
|
120 cols="2" cellspacing="0" cellpadding="0"> |
|
121 <tr valign="top" align="left"> |
|
122 <td width="8%"></td> |
|
123 <td width="91%"> |
|
124 <p><b>−N odd|even|#,#-#,#|last</b></p></td> |
|
125 </table> |
|
126 <!-- INDENTATION --> |
|
127 <table width="100%" border=0 rules="none" frame="void" |
|
128 cols="2" cellspacing="0" cellpadding="0"> |
|
129 <tr valign="top" align="left"> |
|
130 <td width="19%"></td> |
|
131 <td width="80%"> |
|
132 <p>Specify one or more series or range(s) of images within |
|
133 file to process. The words <b>odd</b> or <b>even</b> may be |
|
134 used to specify all odd or even numbered images. The word |
|
135 <b>last</b> may be used in place of a number in the sequence |
|
136 to indicate the final image in the file without knowing how |
|
137 many images there are. Ranges of images may be specified |
|
138 with a dash and multiple sets can be indicated by joining |
|
139 them in a comma-separated list. eg. use <b>−N |
|
140 1,5-7,last</b> to process the 1st, 5th through 7th, and |
|
141 final image in the file.</p> |
|
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="8%"></td> |
|
149 <td width="91%"> |
|
150 <p><b>−E top|bottom|left|right</b></p></td> |
|
151 </table> |
|
152 <!-- INDENTATION --> |
|
153 <table width="100%" border=0 rules="none" frame="void" |
|
154 cols="2" cellspacing="0" cellpadding="0"> |
|
155 <tr valign="top" align="left"> |
|
156 <td width="19%"></td> |
|
157 <td width="80%"> |
|
158 <p>Specify the top, bottom, left, or right edge as the |
|
159 reference from which to calcuate the width and length of |
|
160 crop regions or sequence of postions for zones. May be |
|
161 abbreviated to first letter.</p> |
|
162 </td> |
|
163 </table> |
|
164 <!-- INDENTATION --> |
|
165 <table width="100%" border=0 rules="none" frame="void" |
|
166 cols="2" cellspacing="0" cellpadding="0"> |
|
167 <tr valign="top" align="left"> |
|
168 <td width="8%"></td> |
|
169 <td width="91%"> |
|
170 <p><b>−U in|cm|px</b></p></td> |
|
171 </table> |
|
172 <!-- INDENTATION --> |
|
173 <table width="100%" border=0 rules="none" frame="void" |
|
174 cols="2" cellspacing="0" cellpadding="0"> |
|
175 <tr valign="top" align="left"> |
|
176 <td width="19%"></td> |
|
177 <td width="80%"> |
|
178 <p>Specify the type of units to apply to dimensions for |
|
179 margins and crop regions for input and output images. Inches |
|
180 or centimeters are converted to pixels using the resolution |
|
181 unit specified in the TIFF file (which defaults to inches if |
|
182 not specified in the IFD).</p> |
|
183 </td> |
|
184 </table> |
|
185 <!-- INDENTATION --> |
|
186 <table width="100%" border=0 rules="none" frame="void" |
|
187 cols="2" cellspacing="0" cellpadding="0"> |
|
188 <tr valign="top" align="left"> |
|
189 <td width="8%"></td> |
|
190 <td width="91%"> |
|
191 <p><b>−m #,#,#,#</b></p></td> |
|
192 </table> |
|
193 <!-- INDENTATION --> |
|
194 <table width="100%" border=0 rules="none" frame="void" |
|
195 cols="2" cellspacing="0" cellpadding="0"> |
|
196 <tr valign="top" align="left"> |
|
197 <td width="19%"></td> |
|
198 <td width="80%"> |
|
199 <p>Specify margins to be removed from the input image. The |
|
200 order must be top, left, bottom, right with only commas |
|
201 separating the elements of the list. Margins are scaled |
|
202 according to the current units and removed before any other |
|
203 extractions are computed. Captial M was in use.</p> |
|
204 </td> |
|
205 </table> |
|
206 <!-- TABS --> |
|
207 <table width="100%" border=0 rules="none" frame="void" |
|
208 cols="5" cellspacing="0" cellpadding="0"> |
|
209 <tr valign="top" align="left"> |
|
210 <td width="10%"></td> |
|
211 <td width="6%"> |
|
212 |
|
213 <p><b>−X #</b></p> |
|
214 </td> |
|
215 <td width="2%"></td> |
|
216 <td width="80%"> |
|
217 |
|
218 <p>Set the horizontal (X-axis) dimension of a region to |
|
219 extract relative to the specified origin reference. If the |
|
220 origin is the top or bottom edge, the X axis value will be |
|
221 assumed to start at the left edge.</p> |
|
222 </td> |
|
223 <td width="0%"> |
|
224 </td> |
|
225 <tr valign="top" align="left"> |
|
226 <td width="10%"></td> |
|
227 <td width="6%"> |
|
228 |
|
229 <p><b>−Y #</b></p> |
|
230 </td> |
|
231 <td width="2%"></td> |
|
232 <td width="80%"> |
|
233 |
|
234 <p>Set the vertical (Y-axis) dimension of a region to |
|
235 extract relative to the specified origin reference. If the |
|
236 origin is the left or right edge, the Y axis value will be |
|
237 assumed to start at the top.</p> |
|
238 </td> |
|
239 <td width="0%"> |
|
240 </td> |
|
241 </table> |
|
242 <!-- INDENTATION --> |
|
243 <table width="100%" border=0 rules="none" frame="void" |
|
244 cols="2" cellspacing="0" cellpadding="0"> |
|
245 <tr valign="top" align="left"> |
|
246 <td width="8%"></td> |
|
247 <td width="91%"> |
|
248 <p><b>−Z #:#,#:#</b></p></td> |
|
249 </table> |
|
250 <!-- INDENTATION --> |
|
251 <table width="100%" border=0 rules="none" frame="void" |
|
252 cols="2" cellspacing="0" cellpadding="0"> |
|
253 <tr valign="top" align="left"> |
|
254 <td width="19%"></td> |
|
255 <td width="80%"> |
|
256 <p>Specify zones of the image designated as position X of Y |
|
257 equal sized portions measured from the reference edge, eg |
|
258 1:3 would be first third of the image starting from the |
|
259 reference edge minus any margins specified for the confining |
|
260 edges. Multiple zones can be specified as a comma separated |
|
261 list but they must reference the same edge. To extract the |
|
262 top quarter and the bottom third of an image you would use |
|
263 <b>−Z 1:4,3:3.</b></p> |
|
264 </td> |
|
265 </table> |
|
266 <!-- INDENTATION --> |
|
267 <table width="100%" border=0 rules="none" frame="void" |
|
268 cols="2" cellspacing="0" cellpadding="0"> |
|
269 <tr valign="top" align="left"> |
|
270 <td width="8%"></td> |
|
271 <td width="91%"> |
|
272 <p><b>−F horiz|vert</b></p></td> |
|
273 </table> |
|
274 <!-- INDENTATION --> |
|
275 <table width="100%" border=0 rules="none" frame="void" |
|
276 cols="2" cellspacing="0" cellpadding="0"> |
|
277 <tr valign="top" align="left"> |
|
278 <td width="19%"></td> |
|
279 <td width="80%"> |
|
280 <p>Flip, ie mirror, the image or extracted region |
|
281 horizontally or vertically.</p> |
|
282 </td> |
|
283 </table> |
|
284 <!-- INDENTATION --> |
|
285 <table width="100%" border=0 rules="none" frame="void" |
|
286 cols="2" cellspacing="0" cellpadding="0"> |
|
287 <tr valign="top" align="left"> |
|
288 <td width="8%"></td> |
|
289 <td width="91%"> |
|
290 <p><b>−R 90|180|270</b></p></td> |
|
291 </table> |
|
292 <!-- INDENTATION --> |
|
293 <table width="100%" border=0 rules="none" frame="void" |
|
294 cols="2" cellspacing="0" cellpadding="0"> |
|
295 <tr valign="top" align="left"> |
|
296 <td width="19%"></td> |
|
297 <td width="80%"> |
|
298 <p>Rotate the image or extracted region 90, 180, or 270 |
|
299 degrees clockwise.</p> |
|
300 </td> |
|
301 </table> |
|
302 <!-- TABS --> |
|
303 <table width="100%" border=0 rules="none" frame="void" |
|
304 cols="5" cellspacing="0" cellpadding="0"> |
|
305 <tr valign="top" align="left"> |
|
306 <td width="10%"></td> |
|
307 <td width="6%"> |
|
308 |
|
309 <p><b>−I</b></p> |
|
310 </td> |
|
311 <td width="2%"></td> |
|
312 <td width="80%"> |
|
313 |
|
314 <p>Invert the colorspace values for grayscale and bilevel |
|
315 images. This would be used to correct negative images that |
|
316 have incorrect PHOTMETRIC INTERPRETATION tags. No support |
|
317 for color images.</p> |
|
318 </td> |
|
319 <td width="0%"> |
|
320 </td> |
|
321 <tr valign="top" align="left"> |
|
322 <td width="10%"></td> |
|
323 <td width="6%"> |
|
324 |
|
325 <p><b>−H #</b></p> |
|
326 </td> |
|
327 <td width="2%"></td> |
|
328 <td width="80%"> |
|
329 |
|
330 <p>Set the horizontal resolution of output images to # |
|
331 expressed in the current units.</p> |
|
332 </td> |
|
333 <td width="0%"> |
|
334 </td> |
|
335 <tr valign="top" align="left"> |
|
336 <td width="10%"></td> |
|
337 <td width="6%"> |
|
338 |
|
339 <p><b>−V #</b></p> |
|
340 </td> |
|
341 <td width="2%"></td> |
|
342 <td width="80%"> |
|
343 |
|
344 <p>Set the vertical resolution of the output images to # |
|
345 expressed in the current units.</p> |
|
346 </td> |
|
347 <td width="0%"> |
|
348 </td> |
|
349 <tr valign="top" align="left"> |
|
350 <td width="10%"></td> |
|
351 <td width="6%"> |
|
352 |
|
353 <p><b>−J #</b></p> |
|
354 </td> |
|
355 <td width="2%"></td> |
|
356 <td width="80%"> |
|
357 |
|
358 <p>Set the horizontal margin of an output page size to # |
|
359 expressed in the current units.</p> |
|
360 </td> |
|
361 <td width="0%"> |
|
362 </td> |
|
363 <tr valign="top" align="left"> |
|
364 <td width="10%"></td> |
|
365 <td width="6%"> |
|
366 |
|
367 <p><b>−K #</b></p> |
|
368 </td> |
|
369 <td width="2%"></td> |
|
370 <td width="80%"> |
|
371 |
|
372 <p>Set the vertical margin of an output page size to # |
|
373 expressed in the current units.</p> |
|
374 </td> |
|
375 <td width="0%"> |
|
376 </td> |
|
377 </table> |
|
378 <!-- INDENTATION --> |
|
379 <table width="100%" border=0 rules="none" frame="void" |
|
380 cols="2" cellspacing="0" cellpadding="0"> |
|
381 <tr valign="top" align="left"> |
|
382 <td width="8%"></td> |
|
383 <td width="91%"> |
|
384 <p><b>−O portrait|landscape|auto</b></p></td> |
|
385 </table> |
|
386 <!-- INDENTATION --> |
|
387 <table width="100%" border=0 rules="none" frame="void" |
|
388 cols="2" cellspacing="0" cellpadding="0"> |
|
389 <tr valign="top" align="left"> |
|
390 <td width="19%"></td> |
|
391 <td width="80%"> |
|
392 <p>Set the output orientation of the pages or sections. Auto |
|
393 will use the arrangement that requires the fewest pages.</p> |
|
394 </td> |
|
395 </table> |
|
396 <!-- INDENTATION --> |
|
397 <table width="100%" border=0 rules="none" frame="void" |
|
398 cols="2" cellspacing="0" cellpadding="0"> |
|
399 <tr valign="top" align="left"> |
|
400 <td width="8%"></td> |
|
401 <td width="91%"> |
|
402 <p><b>−S cols:rows</b></p></td> |
|
403 </table> |
|
404 <!-- INDENTATION --> |
|
405 <table width="100%" border=0 rules="none" frame="void" |
|
406 cols="2" cellspacing="0" cellpadding="0"> |
|
407 <tr valign="top" align="left"> |
|
408 <td width="19%"></td> |
|
409 <td width="80%"> |
|
410 <p>Divide each image into cols across and rows down equal |
|
411 sections.</p> |
|
412 </td> |
|
413 </table> |
|
414 <!-- INDENTATION --> |
|
415 <table width="100%" border=0 rules="none" frame="void" |
|
416 cols="2" cellspacing="0" cellpadding="0"> |
|
417 <tr valign="top" align="left"> |
|
418 <td width="8%"></td> |
|
419 <td width="91%"> |
|
420 <p><b>−P page</b></p></td> |
|
421 </table> |
|
422 <!-- INDENTATION --> |
|
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="19%"></td> |
|
427 <td width="80%"> |
|
428 <p>Format the output images to fit on page size paper. Use |
|
429 -P list to show the supported page sizes and dimensions.</p> |
|
430 </td> |
|
431 </table> |
|
432 <!-- TABS --> |
|
433 <table width="100%" border=0 rules="none" frame="void" |
|
434 cols="5" cellspacing="0" cellpadding="0"> |
|
435 <tr valign="top" align="left"> |
|
436 <td width="10%"></td> |
|
437 <td width="3%"> |
|
438 |
|
439 <p><b>−B</b></p> |
|
440 </td> |
|
441 <td width="5%"></td> |
|
442 <td width="80%"> |
|
443 |
|
444 <p>Force output to be written with Big-Endian byte order. |
|
445 This option only has an effect when the output file is |
|
446 created or overwritten and not when it is appended to.</p> |
|
447 </td> |
|
448 <td width="0%"> |
|
449 </td> |
|
450 <tr valign="top" align="left"> |
|
451 <td width="10%"></td> |
|
452 <td width="3%"> |
|
453 |
|
454 <p><b>−C</b></p> |
|
455 </td> |
|
456 <td width="5%"></td> |
|
457 <td width="80%"> |
|
458 |
|
459 <p>Suppress the use of ‘‘strip |
|
460 chopping’’ when reading images that have a |
|
461 single strip/tile of uncompressed data.</p> |
|
462 </td> |
|
463 <td width="0%"> |
|
464 </td> |
|
465 <tr valign="top" align="left"> |
|
466 <td width="10%"></td> |
|
467 <td width="3%"> |
|
468 |
|
469 <p><b>−c</b></p> |
|
470 </td> |
|
471 <td width="5%"></td> |
|
472 <td width="80%"> |
|
473 |
|
474 <p>Specify the compression to use for data written to the |
|
475 output file: <b>none</b> for no compression, <b>packbits</b> |
|
476 for PackBits compression, <b>lzw</b> for Lempel-Ziv & |
|
477 Welch compression, <b>jpeg</b> for baseline JPEG |
|
478 compression, <b>zip</b> for Deflate compression, <b>g3</b> |
|
479 for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT |
|
480 Group 4 (T.6) compression. By default <i>tiffcrop</i> will |
|
481 compress data according to the value of the |
|
482 <i>Compression</i> tag found in the source file.</p> |
|
483 </td> |
|
484 <td width="0%"> |
|
485 </td> |
|
486 </table> |
|
487 <!-- INDENTATION --> |
|
488 <table width="100%" border=0 rules="none" frame="void" |
|
489 cols="2" cellspacing="0" cellpadding="0"> |
|
490 <tr valign="top" align="left"> |
|
491 <td width="17%"></td> |
|
492 <td width="82%"> |
|
493 <p>The <small>CCITT</small> Group 3 and Group 4 compression |
|
494 algorithms can only be used with bilevel data.</p> |
|
495 <!-- INDENTATION --> |
|
496 <p>Group 3 compression can be specified together with |
|
497 several T.4-specific options: <b>1d</b> for 1-dimensional |
|
498 encoding, <b>2d</b> for 2-dimensional encoding, and |
|
499 <b>fill</b> to force each encoded scanline to be zero-filled |
|
500 so that the terminating EOL code lies on a byte boundary. |
|
501 Group 3-specific options are specified by appending a |
|
502 ‘‘:’’-separated list to the |
|
503 ‘‘g3’’ option; e.g. <b>−c |
|
504 g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL |
|
505 codes.</p> |
|
506 <!-- INDENTATION --> |
|
507 <p><small>LZW</small> compression can be specified together |
|
508 with a <i>predictor</i> value. A predictor value of 2 causes |
|
509 each scanline of the output image to undergo horizontal |
|
510 differencing before it is encoded; a value of 1 forces each |
|
511 scanline to be encoded without differencing. LZW-specific |
|
512 options are specified by appending a |
|
513 ‘‘:’’-separated list to the |
|
514 ‘‘lzw’’ option; e.g. <b>−c |
|
515 lzw:2</b> for <small>LZW</small> compression with horizontal |
|
516 differencing.</p> |
|
517 </td> |
|
518 </table> |
|
519 <!-- TABS --> |
|
520 <table width="100%" border=0 rules="none" frame="void" |
|
521 cols="5" cellspacing="0" cellpadding="0"> |
|
522 <tr valign="top" align="left"> |
|
523 <td width="10%"></td> |
|
524 <td width="3%"> |
|
525 |
|
526 <p><b>−f</b></p> |
|
527 </td> |
|
528 <td width="5%"></td> |
|
529 <td width="80%"> |
|
530 |
|
531 <p>Specify the bit fill order to use in writing output |
|
532 data. By default, <i>tiffcrop</i> will create a new file |
|
533 with the same fill order as the original. Specifying |
|
534 <b>−f lsb2msb</b> will force data to be written with |
|
535 the FillOrder tag set to <small>LSB2MSB,</small> while |
|
536 <b>−f msb2lsb</b> will force data to be written with |
|
537 the FillOrder tag set to <small>MSB2LSB.</small></p> |
|
538 </td> |
|
539 <td width="0%"> |
|
540 </td> |
|
541 <tr valign="top" align="left"> |
|
542 <td width="10%"></td> |
|
543 <td width="3%"> |
|
544 |
|
545 <p><b>−i</b></p> |
|
546 </td> |
|
547 <td width="5%"></td> |
|
548 <td width="80%"> |
|
549 |
|
550 <p>Ignore non-fatal read errors and continue processing of |
|
551 the input file.</p> |
|
552 </td> |
|
553 <td width="0%"> |
|
554 </td> |
|
555 <tr valign="top" align="left"> |
|
556 <td width="10%"></td> |
|
557 <td width="3%"> |
|
558 |
|
559 <p><b>−l</b></p> |
|
560 </td> |
|
561 <td width="5%"></td> |
|
562 <td width="80%"> |
|
563 |
|
564 <p>Specify the length of a tile (in pixels). |
|
565 <i>tiffcrop</i> attempts to set the tile dimensions so that |
|
566 no more than 8 kilobytes of data appear in a tile.</p> |
|
567 </td> |
|
568 <td width="0%"> |
|
569 </td> |
|
570 <tr valign="top" align="left"> |
|
571 <td width="10%"></td> |
|
572 <td width="3%"> |
|
573 |
|
574 <p><b>−L</b></p> |
|
575 </td> |
|
576 <td width="5%"></td> |
|
577 <td width="80%"> |
|
578 |
|
579 <p>Force output to be written with Little-Endian byte |
|
580 order. This option only has an effect when the output file |
|
581 is created or overwritten and not when it is appended |
|
582 to.</p> |
|
583 </td> |
|
584 <td width="0%"> |
|
585 </td> |
|
586 <tr valign="top" align="left"> |
|
587 <td width="10%"></td> |
|
588 <td width="3%"> |
|
589 |
|
590 <p><b>−M</b></p> |
|
591 </td> |
|
592 <td width="5%"></td> |
|
593 <td width="80%"> |
|
594 |
|
595 <p>Suppress the use of memory-mapped files when reading |
|
596 images.</p> |
|
597 </td> |
|
598 <td width="0%"> |
|
599 </td> |
|
600 <tr valign="top" align="left"> |
|
601 <td width="10%"></td> |
|
602 <td width="3%"> |
|
603 |
|
604 <p><b>−p</b></p> |
|
605 </td> |
|
606 <td width="5%"></td> |
|
607 <td width="80%"> |
|
608 |
|
609 <p>Specify the planar configuration to use in writing image |
|
610 data that has more than one 8-bit sample per pixel. By |
|
611 default, <i>tiffcrop</i> will create a new file with the |
|
612 same planar configuration as the original. Specifying |
|
613 <b>−p contig</b> will force data to be written with |
|
614 multi-sample data packed together, while <b>−p |
|
615 separate</b> will force samples to be written in separate |
|
616 planes.</p> |
|
617 </td> |
|
618 <td width="0%"> |
|
619 </td> |
|
620 <tr valign="top" align="left"> |
|
621 <td width="10%"></td> |
|
622 <td width="3%"> |
|
623 |
|
624 <p><b>−r</b></p> |
|
625 </td> |
|
626 <td width="5%"></td> |
|
627 <td width="80%"> |
|
628 |
|
629 <p>Specify the number of rows (scanlines) in each strip of |
|
630 data written to the output file. By default (or when value |
|
631 <b>0</b> is specified), <i>tiffcrop</i> attempts to set the |
|
632 rows/strip that no more than 8 kilobytes of data appear in a |
|
633 strip. If you specify the special value <b>-1</b> it will |
|
634 results in infinite number of the rows per strip. The entire |
|
635 image will be the one strip in that case.</p> |
|
636 </td> |
|
637 <td width="0%"> |
|
638 </td> |
|
639 <tr valign="top" align="left"> |
|
640 <td width="10%"></td> |
|
641 <td width="3%"> |
|
642 |
|
643 <p><b>−s</b></p> |
|
644 </td> |
|
645 <td width="5%"></td> |
|
646 <td width="80%"> |
|
647 |
|
648 <p>Force the output file to be written with data organized |
|
649 in strips (rather than tiles).</p> |
|
650 </td> |
|
651 <td width="0%"> |
|
652 </td> |
|
653 <tr valign="top" align="left"> |
|
654 <td width="10%"></td> |
|
655 <td width="3%"> |
|
656 |
|
657 <p><b>−t</b></p> |
|
658 </td> |
|
659 <td width="5%"></td> |
|
660 <td width="80%"> |
|
661 |
|
662 <p>Force the output file to be written with data organized |
|
663 in tiles (rather than strips).</p> |
|
664 </td> |
|
665 <td width="0%"> |
|
666 </td> |
|
667 <tr valign="top" align="left"> |
|
668 <td width="10%"></td> |
|
669 <td width="3%"> |
|
670 |
|
671 <p><b>−w</b></p> |
|
672 </td> |
|
673 <td width="5%"></td> |
|
674 <td width="80%"> |
|
675 |
|
676 <p>Specify the width of a tile (in pixels). <i>tiffcrop</i> |
|
677 attempts to set the tile dimensions so that no more than 8 |
|
678 kilobytes of data appear in a tile. <i>tiffcrop</i> attempts |
|
679 to set the tile dimensions so that no more than 8 kilobytes |
|
680 of data appear in a tile.</p> |
|
681 </td> |
|
682 <td width="0%"> |
|
683 </td> |
|
684 </table> |
|
685 <!-- INDENTATION --> |
|
686 <table width="100%" border=0 rules="none" frame="void" |
|
687 cols="2" cellspacing="0" cellpadding="0"> |
|
688 <tr valign="top" align="left"> |
|
689 <td width="8%"></td> |
|
690 <td width="91%"> |
|
691 <p><b>−,={character}</b></p></td> |
|
692 </table> |
|
693 <!-- INDENTATION --> |
|
694 <table width="100%" border=0 rules="none" frame="void" |
|
695 cols="2" cellspacing="0" cellpadding="0"> |
|
696 <tr valign="top" align="left"> |
|
697 <td width="19%"></td> |
|
698 <td width="80%"> |
|
699 <p>substitute {character} for ’,’ in parsing |
|
700 image directory indices in files. This is necessary if |
|
701 filenames contain commas. Note that ’,=’ with |
|
702 whitespace immediately following will disable the special |
|
703 meaning of the ’,’ entirely. See examples.</p> |
|
704 </td> |
|
705 </table> |
|
706 <a name="EXAMPLES"></a> |
|
707 <h2>EXAMPLES</h2> |
|
708 <!-- INDENTATION --> |
|
709 <table width="100%" border=0 rules="none" frame="void" |
|
710 cols="2" cellspacing="0" cellpadding="0"> |
|
711 <tr valign="top" align="left"> |
|
712 <td width="8%"></td> |
|
713 <td width="91%"> |
|
714 <p>The following concatenates two files and writes the |
|
715 result using <small>LZW</small> encoding:</p></td> |
|
716 </table> |
|
717 <!-- INDENTATION --> |
|
718 <table width="100%" border=0 rules="none" frame="void" |
|
719 cols="2" cellspacing="0" cellpadding="0"> |
|
720 <tr valign="top" align="left"> |
|
721 <td width="17%"></td> |
|
722 <td width="82%"> |
|
723 <pre>tiffcrop -c lzw a.tif b.tif result.tif |
|
724 </pre> |
|
725 </td> |
|
726 </table> |
|
727 <!-- INDENTATION --> |
|
728 |
|
729 <table width="100%" border=0 rules="none" frame="void" |
|
730 cols="2" cellspacing="0" cellpadding="0"> |
|
731 <tr valign="top" align="left"> |
|
732 <td width="8%"></td> |
|
733 <td width="91%"> |
|
734 <p>To convert a G3 1d-encoded <small>TIFF</small> to a |
|
735 single strip of G4-encoded data the following might be |
|
736 used:</p></td> |
|
737 </table> |
|
738 <!-- INDENTATION --> |
|
739 <table width="100%" border=0 rules="none" frame="void" |
|
740 cols="2" cellspacing="0" cellpadding="0"> |
|
741 <tr valign="top" align="left"> |
|
742 <td width="17%"></td> |
|
743 <td width="82%"> |
|
744 <pre>tiffcrop -c g4 -r 10000 g3.tif g4.tif |
|
745 </pre> |
|
746 </td> |
|
747 </table> |
|
748 <!-- INDENTATION --> |
|
749 |
|
750 <table width="100%" border=0 rules="none" frame="void" |
|
751 cols="2" cellspacing="0" cellpadding="0"> |
|
752 <tr valign="top" align="left"> |
|
753 <td width="8%"></td> |
|
754 <td width="91%"> |
|
755 <p>(1000 is just a number that is larger than the number of |
|
756 rows in the source file.)</p> |
|
757 <!-- INDENTATION --> |
|
758 <p>To extract a selected set of images from a multi-image |
|
759 TIFF file use the -N option described above. Thus, to copy |
|
760 the 1st and 3rd images of image file "album.tif" |
|
761 to "result.tif":</p></td> |
|
762 </table> |
|
763 <!-- INDENTATION --> |
|
764 <table width="100%" border=0 rules="none" frame="void" |
|
765 cols="2" cellspacing="0" cellpadding="0"> |
|
766 <tr valign="top" align="left"> |
|
767 <td width="17%"></td> |
|
768 <td width="82%"> |
|
769 <pre>tiffcrop -N 1,3 album.tif result.tif |
|
770 </pre> |
|
771 </td> |
|
772 </table> |
|
773 <!-- INDENTATION --> |
|
774 |
|
775 <table width="100%" border=0 rules="none" frame="void" |
|
776 cols="2" cellspacing="0" cellpadding="0"> |
|
777 <tr valign="top" align="left"> |
|
778 <td width="8%"></td> |
|
779 <td width="91%"> |
|
780 <p>Invert a bilevel image scan of a microfilmed document and |
|
781 crop off margins of 0.25 inches on the left and right, 0.5 |
|
782 inch on the top, nad 0.75 inch on the bottom. From the |
|
783 remaining portion of the image, select the second and third |
|
784 quarters, ie, one half of the area left from the center to |
|
785 each margin.</p></td> |
|
786 </table> |
|
787 <!-- INDENTATION --> |
|
788 <table width="100%" border=0 rules="none" frame="void" |
|
789 cols="2" cellspacing="0" cellpadding="0"> |
|
790 <tr valign="top" align="left"> |
|
791 <td width="17%"></td> |
|
792 <td width="82%"> |
|
793 <pre>tiffcrop -U in -m 0.5,0.25,0.75,0.25 -E left -Z 2:4,3:4 -I MicrofilmNegative.tif MicrofilmPostiveCenter.tif |
|
794 </pre> |
|
795 </td> |
|
796 </table> |
|
797 <!-- INDENTATION --> |
|
798 |
|
799 <table width="100%" border=0 rules="none" frame="void" |
|
800 cols="2" cellspacing="0" cellpadding="0"> |
|
801 <tr valign="top" align="left"> |
|
802 <td width="8%"></td> |
|
803 <td width="91%"> |
|
804 <p>Extract only the final image of a large Architectural E |
|
805 sized multipage TIFF file and rotate it 90 degrees clockwise |
|
806 while reformatting the output to fit on tabloid sized sheets |
|
807 with one quarter of an inch on each side:</p></td> |
|
808 </table> |
|
809 <!-- INDENTATION --> |
|
810 <table width="100%" border=0 rules="none" frame="void" |
|
811 cols="2" cellspacing="0" cellpadding="0"> |
|
812 <tr valign="top" align="left"> |
|
813 <td width="17%"></td> |
|
814 <td width="82%"> |
|
815 <pre>tiffcrop -N last -R 90 -O auto -P tabloid -U in -J 0.25 -K 0.25 -H 300 -V 300 Big-PlatMap.tif BigPlatMap-Tabloid.tif |
|
816 </pre> |
|
817 </td> |
|
818 </table> |
|
819 <!-- INDENTATION --> |
|
820 |
|
821 <table width="100%" border=0 rules="none" frame="void" |
|
822 cols="2" cellspacing="0" cellpadding="0"> |
|
823 <tr valign="top" align="left"> |
|
824 <td width="8%"></td> |
|
825 <td width="91%"> |
|
826 <p>The output images will have a specified resolution of 300 |
|
827 dpi in both directions. The orientation of each page will be |
|
828 determined by whichever choice requires the fewest pages. To |
|
829 specify a specific orientation, use the portrait or |
|
830 landscape option.</p> |
|
831 </td> |
|
832 </table> |
|
833 <a name="SEE ALSO"></a> |
|
834 <h2>SEE ALSO</h2> |
|
835 <!-- INDENTATION --> |
|
836 <table width="100%" border=0 rules="none" frame="void" |
|
837 cols="2" cellspacing="0" cellpadding="0"> |
|
838 <tr valign="top" align="left"> |
|
839 <td width="8%"></td> |
|
840 <td width="91%"> |
|
841 <p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1), |
|
842 <b>tiffcp</b>(1), <b>tiffmedian</b>(1), <b>tiffsplit</b>(1), |
|
843 <b>libtiff</b>(3TIFF)</p> |
|
844 <!-- INDENTATION --> |
|
845 <p>Libtiff library home page: |
|
846 <b>http://www.remotesensing.org/libtiff/</b></p> |
|
847 </td> |
|
848 </table> |
|
849 <hr> |
|
850 </body> |
|
851 </html> |