From 22f703cab05b7cd368f4de9e03991b7664dc5022 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Mon, 1 Sep 2014 13:56:46 +0200 Subject: Initial import of argyll version 1.5.1-8 --- tiff/html/man/tiffcrop.1.html | 851 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 851 insertions(+) create mode 100644 tiff/html/man/tiffcrop.1.html (limited to 'tiff/html/man/tiffcrop.1.html') diff --git a/tiff/html/man/tiffcrop.1.html b/tiff/html/man/tiffcrop.1.html new file mode 100644 index 0000000..4c25c29 --- /dev/null +++ b/tiff/html/man/tiffcrop.1.html @@ -0,0 +1,851 @@ + + + + + + +TIFFCROP + + + +

TIFFCROP

+NAME
+SYNOPSIS
+DESCRIPTION
+OPTIONS
+EXAMPLES
+SEE ALSO
+ +

+ +

NAME

+ + + + + +

tiffcrop − copy, convert, crop, extract, or process +a TIFF file

+ +

SYNOPSIS

+ + + + + +

tiffcrop [ options ] src1.tif ... +srcN.tif dst.tif

+ +

DESCRIPTION

+ + + + + +

tiffcrop combines one or more files created +according to the Tag Image File Format, Revision 6.0 into a +single TIFF file. The output file may be +compressed using a different algorithm than the input files. +tiffcrop is most often used to extract portions of an +image for processing with bar code recognizer or OCR +software when that software cannot restrict the region of +interest to a specific portion of the image or to improve +efficiency when the regions of interest must be rotated. It +can also be used to subdivide all or part of a processed +image into smaller sections.

+ +

Functions are applied to the input image in the following +order:

+ + + + + +

cropping, fixed area extraction, zones, inversion, mirroring, rotation.
+

+ + + + + + +

Functions are applied to the output image in the +following order:

+ + + + + +

output resolution, output margins, rows and columns +or page size divisions, orientation options, strip, +tile, byte order, and compression options.

+ + + + + +

By default, tiffcrop will copy all the understood +tags in a TIFF directory of an input file to +the associated directory in the output file. Options can be +used to force the resultant image to be written as strips or +tiles of data, respectively.

+ +

tiffcrop can be used to reorganize the storage +characteristics of data in a file, and to reorganize, +extract, rotate, and otherwise process the image data as +specified at the same time whereas tiffcp does not alter the +image data itself.

+ +

OPTIONS

+ + + + + +

−N odd|even|#,#-#,#|last

+ + + + + +

Specify one or more series or range(s) of images within +file to process. The words odd or even may be +used to specify all odd or even numbered images. The word +last may be used in place of a number in the sequence +to indicate the final image in the file without knowing how +many images there are. Ranges of images may be specified +with a dash and multiple sets can be indicated by joining +them in a comma-separated list. eg. use −N +1,5-7,last to process the 1st, 5th through 7th, and +final image in the file.

+ + + + + +

−E top|bottom|left|right

+ + + + + +

Specify the top, bottom, left, or right edge as the +reference from which to calcuate the width and length of +crop regions or sequence of postions for zones. May be +abbreviated to first letter.

+ + + + + +

−U in|cm|px

+ + + + + +

Specify the type of units to apply to dimensions for +margins and crop regions for input and output images. Inches +or centimeters are converted to pixels using the resolution +unit specified in the TIFF file (which defaults to inches if +not specified in the IFD).

+ + + + + +

−m #,#,#,#

+ + + + + +

Specify margins to be removed from the input image. The +order must be top, left, bottom, right with only commas +separating the elements of the list. Margins are scaled +according to the current units and removed before any other +extractions are computed. Captial M was in use.

+ + + + + + + + + + + + + + +

	+ + −X # +		+ + Set the horizontal (X-axis) dimension of a region to +extract relative to the specified origin reference. If the +origin is the top or bottom edge, the X axis value will be +assumed to start at the left edge. +	+
	+ + −Y # +		+ + Set the vertical (Y-axis) dimension of a region to +extract relative to the specified origin reference. If the +origin is the left or right edge, the Y axis value will be +assumed to start at the top. +	+

+ + + + + +

−Z #:#,#:#

+ + + + + +

Specify zones of the image designated as position X of Y +equal sized portions measured from the reference edge, eg +1:3 would be first third of the image starting from the +reference edge minus any margins specified for the confining +edges. Multiple zones can be specified as a comma separated +list but they must reference the same edge. To extract the +top quarter and the bottom third of an image you would use +−Z 1:4,3:3.

+ + + + + +

−F horiz|vert

+ + + + + +

Flip, ie mirror, the image or extracted region +horizontally or vertically.

+ + + + + +

−R 90|180|270

+ + + + + +

Rotate the image or extracted region 90, 180, or 270 +degrees clockwise.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + −I +	+ + Invert the colorspace values for grayscale and bilevel +images. This would be used to correct negative images that +have incorrect PHOTMETRIC INTERPRETATION tags. No support +for color images. +	+
+ + −H # +	+ + Set the horizontal resolution of output images to # +expressed in the current units. +	+
+ + −V # +	+ + Set the vertical resolution of the output images to # +expressed in the current units. +	+
+ + −J # +	+ + Set the horizontal margin of an output page size to # +expressed in the current units. +	+
+ + −K # +	+ + Set the vertical margin of an output page size to # +expressed in the current units. +	+

+ + + + + +

−O portrait|landscape|auto

+ + + + + +

Set the output orientation of the pages or sections. Auto +will use the arrangement that requires the fewest pages.

+ + + + + +

−S cols:rows

+ + + + + +

Divide each image into cols across and rows down equal +sections.

+ + + + + +

−P page

+ + + + + +

Format the output images to fit on page size paper. Use +-P list to show the supported page sizes and dimensions.

+ + + + + + + + + + + + + + + + + + + + +

+ + −B +	+ + Force output to be written with Big-Endian byte order. +This option only has an effect when the output file is +created or overwritten and not when it is appended to. +	+
+ + −C +	+ + Suppress the use of ‘‘strip +chopping’’ when reading images that have a +single strip/tile of uncompressed data. +	+
+ + −c +	+ + Specify the compression to use for data written to the +output file: none for no compression, packbits +for PackBits compression, lzw for Lempel-Ziv & +Welch compression, jpeg for baseline JPEG +compression, zip for Deflate compression, g3 +for CCITT Group 3 (T.4) compression, and g4 for CCITT +Group 4 (T.6) compression. By default tiffcrop will +compress data according to the value of the +Compression tag found in the source file. +	+

+ + + + + +

The CCITT Group 3 and Group 4 compression +algorithms can only be used with bilevel data.

+ +

Group 3 compression can be specified together with +several T.4-specific options: 1d for 1-dimensional +encoding, 2d for 2-dimensional encoding, and +fill to force each encoded scanline to be zero-filled +so that the terminating EOL code lies on a byte boundary. +Group 3-specific options are specified by appending a +‘‘:’’-separated list to the +‘‘g3’’ option; e.g. −c +g3:2d:fill to get 2D-encoded data with byte-aligned EOL +codes.

+ +

LZW compression can be specified together +with a predictor value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. −c +lzw:2 for LZW compression with horizontal +differencing.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + −f +	+ + Specify the bit fill order to use in writing output +data. By default, tiffcrop will create a new file +with the same fill order as the original. Specifying +−f lsb2msb will force data to be written with +the FillOrder tag set to LSB2MSB, while +−f msb2lsb will force data to be written with +the FillOrder tag set to MSB2LSB. +	+
+ + −i +	+ + Ignore non-fatal read errors and continue processing of +the input file. +	+
+ + −l +	+ + Specify the length of a tile (in pixels). +tiffcrop attempts to set the tile dimensions so that +no more than 8 kilobytes of data appear in a tile. +	+
+ + −L +	+ + Force output to be written with Little-Endian byte +order. This option only has an effect when the output file +is created or overwritten and not when it is appended +to. +	+
+ + −M +	+ + Suppress the use of memory-mapped files when reading +images. +	+
+ + −p +	+ + Specify the planar configuration to use in writing image +data that has more than one 8-bit sample per pixel. By +default, tiffcrop will create a new file with the +same planar configuration as the original. Specifying +−p contig will force data to be written with +multi-sample data packed together, while −p +separate will force samples to be written in separate +planes. +	+
+ + −r +	+ + Specify the number of rows (scanlines) in each strip of +data written to the output file. By default (or when value +0 is specified), tiffcrop attempts to set the +rows/strip that no more than 8 kilobytes of data appear in a +strip. If you specify the special value -1 it will +results in infinite number of the rows per strip. The entire +image will be the one strip in that case. +	+
+ + −s +	+ + Force the output file to be written with data organized +in strips (rather than tiles). +	+
+ + −t +	+ + Force the output file to be written with data organized +in tiles (rather than strips). +	+
+ + −w +	+ + Specify the width of a tile (in pixels). tiffcrop +attempts to set the tile dimensions so that no more than 8 +kilobytes of data appear in a tile. tiffcrop attempts +to set the tile dimensions so that no more than 8 kilobytes +of data appear in a tile. +	+

+ + + + + +

−,={character}

+ + + + + +

substitute {character} for ’,’ in parsing +image directory indices in files. This is necessary if +filenames contain commas. Note that ’,=’ with +whitespace immediately following will disable the special +meaning of the ’,’ entirely. See examples.

+ +

EXAMPLES

+ + + + + +

The following concatenates two files and writes the +result using LZW encoding:

+ + + + + +

tiffcrop -c lzw a.tif b.tif result.tif
+

+ + + + + + +

To convert a G3 1d-encoded TIFF to a +single strip of G4-encoded data the following might be +used:

+ + + + + +

tiffcrop -c g4 -r 10000 g3.tif g4.tif
+

+ + + + + + +

(1000 is just a number that is larger than the number of +rows in the source file.)

+ +

To extract a selected set of images from a multi-image +TIFF file use the -N option described above. Thus, to copy +the 1st and 3rd images of image file "album.tif" +to "result.tif":

+ + + + + +

tiffcrop -N 1,3 album.tif result.tif
+

+ + + + + + +

Invert a bilevel image scan of a microfilmed document and +crop off margins of 0.25 inches on the left and right, 0.5 +inch on the top, nad 0.75 inch on the bottom. From the +remaining portion of the image, select the second and third +quarters, ie, one half of the area left from the center to +each margin.

+ + + + + +

tiffcrop -U in -m 0.5,0.25,0.75,0.25 -E left -Z 2:4,3:4 -I MicrofilmNegative.tif MicrofilmPostiveCenter.tif
+

+ + + + + + +

Extract only the final image of a large Architectural E +sized multipage TIFF file and rotate it 90 degrees clockwise +while reformatting the output to fit on tabloid sized sheets +with one quarter of an inch on each side:

+ + + + + +

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
+

+ + + + + + +

The output images will have a specified resolution of 300 +dpi in both directions. The orientation of each page will be +determined by whichever choice requires the fewest pages. To +specify a specific orientation, use the portrait or +landscape option.

+ +