diff --git a/html/man/tiffcp.1.html b/html/man/tiffcp.1.html index 19f2cf88..3d6b3e17 100644 --- a/html/man/tiffcp.1.html +++ b/html/man/tiffcp.1.html @@ -15,122 +15,111 @@ SEE ALSO
- - + +

NAME

- -

- - - -
-

tiffcp − copy (and possibly convert) a -TIFF file

-

- -

SYNOPSIS

- -

- - - -
-

tiffcp [ options ] src1.tif ... srcN.tif -dst.tif

-

- -

DESCRIPTION

- -

- - - -
-

tiffcp combines one or more files created -according to the Tag Image File Format, Revision 6.0 into a -single TIFF file. Because the output file may -be compressed using a different algorithm than the input -files, tiffcp is most often used to convert between -different compression schemes.

- -

By default, tiffcp will copy all the understood -tags in a TIFF directory of an input file to -the associated directory in the output file.

- -

tiffcp can be used to reorganize the storage -characteristics of data in a file, but it is explicitly -intended to not alter or convert the image data content in -any way.

-

- -

OPTIONS

- -

- - - -
-

−b image

- - -
-

subtract the following monochrome image from all others +

 +tiffcp - copy (and possibly convert) a TIFF file
+ +

SYNOPSIS

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

DESCRIPTION

+ + + +
+tiffcp combines one or more files created according +to the Tag Image File Format, Revision 6.0 into a single +TIFF file. Because the output file may be +compressed using a different algorithm than the input files, +tiffcp is most often used to convert between +different compression schemes.
+ + + +
+By default, tiffcp will copy all the understood tags +in a TIFF directory of an input file to the +associated directory in the output file.
+ + + +
+tiffcp can be used to reorganize the storage +characteristics of data in a file, but it is explicitly +intended to not alter or convert the image data content in +any way.
+ +

OPTIONS

+ + + +
+-b image
+ + + + -
+subtract the following monochrome image from all others processed. This can be used to remove a noise bias from a set of images. This bias image is typlically an image of -noise the camera saw with its shutter closed.

-
- -

+noise the camera saw with its shutter closed.
+ + - -
+ +-B
-

−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.

- - - + - -
+ +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
-

−c

- - - + + +
+Suppress the use of ``strip chopping'' when reading images +that have a single strip/tile of uncompressed +data.
-

Specify the compression to use for data written to the + + +
+-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 @@ -138,341 +127,296 @@ compression, zip for Deflate compression, g3 for CCITT Group 3 (T.4) compression, and g4 for CCITT Group 4 (T.6) compression. By default tiffcp will compress data according to the value of the -Compression tag found in the source file.

-		 -

- -

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 +

 +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 +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.

-

- -

+options are specified by appending a ``:''-separated list to +the ``lzw'' option; e.g. -c lzw:2 for +LZW compression with horizontal +differencing.
+ + - -
+ +-f
-

−f

- - - - -

Specify the bit fill order to use in writing output -data. By default, tiffcp 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.

- - - + - -
+ +Specify the bit fill order to use in writing output data. By +default, tiffcp 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.
-

−l

- - - + + +
+-l
-

Specify the length of a tile (in pixels). tiffcp + + + - +kilobytes of data appear in a tile.
+Specify the length of a tile (in pixels). tiffcp attempts to set the tile dimensions so that no more than 8 -kilobytes of data appear in a tile.

-		 -
+ + - -
+ +-L
-

−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.

- - - + - -
+ +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.

- - - + - -
+ +-M
-

−p

- - - + + +
+Suppress the use of memory-mapped files when reading +images.
-

Specify the planar configuration to use in writing image + + +
+-p
+ + + + - +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.
+Specify the planar configuration to use in writing image data that has one 8-bit sample per pixel. By default, tiffcp 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
-

−r

- - - - -

Specify the number of rows (scanlines) in each strip of -data written to the output file. By default, tiffcp -attempts to set the rows/strip that no more than 8 kilobytes -of data appear in a strip.

- - - + - -
+ +Specify the number of rows (scanlines) in each strip of data +written to the output file. By default (or when value +0 is specified), tiffcp attempts to set the +rows/strip that no more than 8 kilobytes of data appear in a +strip. If you specify 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).

- - - + - -
+ +-s
-

−t

- - - - -

Force the output file to be written wtih data organized -in tiles (rather than strips). options can be used to force -the resultant image to be written as strips or tiles of -data, respectively.

- - - + - -
+ +Force the output file to be written with data organized in +strips (rather than tiles).
-

−w

- - - + + +
+-t
-

Specify the width of a tile (in pixels). tiffcp + + +
+Force the output file to be written wtih data organized in +tiles (rather than strips). options can be used to force the +resultant image to be written as strips or tiles of data, +respectively.
+ + + +
+-w
+ + + + - -
+Specify the width of a tile (in pixels). tiffcp attempts to set the tile dimensions so that no more than 8 kilobytes of data appear in a tile. tiffcp attempts to set the tile dimensions so that no more than 8 kilobytes -of data appear in a tile.

-		 -

- -

- - - -
-

−,={character}

- +of data appear in a tile. + - - -
-

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.

-
+ +-,={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:

- + - -
+ +The following concatenates two files and writes the result +using LZW encoding:
+ + + + -
tiffcp -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:

- - -
+ +To convert a G3 1d-encoded TIFF to a single +strip of G4-encoded data the following might be +used:
+ + + + -
tiffcp -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, the file name may be immediately followed by a -’,’ separated list of image directory indices. -The first image is always in directory 0. Thus, to copy the -1st and 3rd images of image file "album.tif" to -"result.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, the file name may be immediately followed by a ',' +separated list of image directory indices. The first image +is always in directory 0. Thus, to copy the 1st and 3rd +images of image file "album.tif" to +"result.tif":
+ + + + -
tiffcp album.tif,0,2 result.tif
-
-
- + -

- - - -
-

Given file "CCD.tif" whose first image is a -noise bias followed by images which include that bias, -subtract the noise from all those images following it (while -decompressing) with the command:

- - -
+ +Given file "CCD.tif" whose first image is a noise +bias followed by images which include that bias, subtract +the noise from all those images following it (while +decompressing) with the command:
+ + + + -
tiffcp -c none -b CCD.tif CCD.tif,1, result.tif
-
-
- + -

- - - -
-

If the file above were named "CCD,X.tif", the -"-,=" option would be required to correctly parse -this filename with image numbers, as follows:

- - -
-
tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
+
 +If the file above were named "CCD,X.tif", the +"-,=" option would be required to correctly parse +this filename with image numbers, as follows:
- - - + + +
+
tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
+

SEE ALSO

- - - -
-

pal2rgb(1), tiffinfo(1), tiffcmp(1), +

 +pal2rgb(1), tiffinfo(1), tiffcmp(1), tiffmedian(1), tiffsplit(1), -libtiff(3)

-
+libtiff(3)