From c0b89ac5bfb90835ef01573267020e42d4fe070c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Sun, 23 Aug 2015 12:17:05 +0200 Subject: Imported Upstream version 1.8.0 --- tiff/html/man/tiffcrop.1.html | 851 ------------------------------------------ 1 file changed, 851 deletions(-) delete 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 deleted file mode 100644 index 4c25c29..0000000 --- a/tiff/html/man/tiffcrop.1.html +++ /dev/null @@ -1,851 +0,0 @@ - - - - - - -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.

- -