summaryrefslogtreecommitdiff
path: root/tiff/man/tiffcp.1
diff options
context:
space:
mode:
Diffstat (limited to 'tiff/man/tiffcp.1')
-rwxr-xr-xtiff/man/tiffcp.1317
1 files changed, 0 insertions, 317 deletions
diff --git a/tiff/man/tiffcp.1 b/tiff/man/tiffcp.1
deleted file mode 100755
index 0ed12dc..0000000
--- a/tiff/man/tiffcp.1
+++ /dev/null
@@ -1,317 +0,0 @@
-.\" $Id: tiffcp.1,v 1.13 2013-03-06 03:35:09 tgl Exp $
-.\"
-.\" Copyright (c) 1988-1997 Sam Leffler
-.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
-.\"
-.\" Permission to use, copy, modify, distribute, and sell this software and
-.\" its documentation for any purpose is hereby granted without fee, provided
-.\" that (i) the above copyright notices and this permission notice appear in
-.\" all copies of the software and related documentation, and (ii) the names of
-.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
-.\" publicity relating to the software without the specific, prior written
-.\" permission of Sam Leffler and Silicon Graphics.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
-.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
-.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
-.\"
-.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
-.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
-.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
-.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
-.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
-.\" OF THIS SOFTWARE.
-.\"
-.if n .po 0
-.TH TIFFCP 1 "February 24, 2007" "libtiff"
-.SH NAME
-tiffcp \- copy (and possibly convert) a
-.SM TIFF
-file
-.SH SYNOPSIS
-.B tiffcp
-[
-.I options
-]
-.I "src1.tif ... srcN.tif dst.tif"
-.SH DESCRIPTION
-.I tiffcp
-combines one or more files created according
-to the Tag Image File Format, Revision 6.0
-into a single
-.SM TIFF
-file.
-Because the output file may be compressed using a different
-algorithm than the input files,
-.I tiffcp
-is most often used to convert between different compression
-schemes.
-.PP
-By default,
-.I tiffcp
-will copy all the understood tags in a
-.SM TIFF
-directory of an input
-file to the associated directory in the output file.
-.PP
-.I 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.
-.SH OPTIONS
-.TP
-.B \-a
-Append to an existing output file instead of overwriting it.
-.TP
-.BI \-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 typically an
-image of noise the camera saw with its shutter closed.
-.TP
-.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.
-.TP
-.B \-C
-Suppress the use of ``strip chopping'' when reading images
-that have a single strip/tile of uncompressed data.
-.TP
-.B \-c
-Specify the compression to use for data written to the output file:
-.B none
-for no compression,
-.B packbits
-for PackBits compression,
-.B lzw
-for Lempel-Ziv & Welch compression,
-.B zip
-for Deflate compression,
-.B lzma
-for LZMA2 compression,
-.B jpeg
-for baseline JPEG compression,
-.B g3
-for CCITT Group 3 (T.4) compression,
-.B g4
-for CCITT Group 4 (T.6) compression,
-or
-.B sgilog
-for SGILOG compression.
-By default
-.I tiffcp
-will compress data according to the value of the
-.I Compression
-tag found in the source file.
-.IP
-The
-.SM CCITT
-Group 3 and Group 4 compression algorithms can only
-be used with bilevel data.
-.IP
-Group 3 compression can be specified together with several
-T.4-specific options:
-.B 1d
-for 1-dimensional encoding,
-.B 2d
-for 2-dimensional encoding,
-and
-.B 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.
-.B "\-c g3:2d:fill"
-to get 2D-encoded data with byte-aligned EOL codes.
-.IP
-.SM LZW, Deflate
-and
-.SM LZMA2
-compression can be specified together with a
-.I 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. A value 3 is for floating point
-predictor which you can use if the encoded data are in floating point format.
-LZW-specific options are specified by appending a ``:''-separated list to the
-``lzw'' option; e.g.
-.B "\-c lzw:2"
-for
-.SM LZW
-compression with horizontal differencing.
-.IP
-.SM Deflate
-and
-.SM LZMA2
-encoders support various compression levels (or encoder presets) set as
-character ``p'' and a preset number. ``p1'' is the fastest one with the worst
-compression ratio and ``p9'' is the slowest but with the best possible ratio;
-e.g.
-.B "\-c zip:3:p9"
-for
-.SM Deflate
-encoding with maximum compression level and floating point predictor.
-.TP
-.B \-f
-Specify the bit fill order to use in writing output data.
-By default,
-.I tiffcp
-will create a new file with the same fill order as the original.
-Specifying
-.B "\-f lsb2msb"
-will force data to be written with the FillOrder tag set to
-.SM LSB2MSB,
-while
-.B "\-f msb2lsb"
-will force data to be written with the FillOrder tag set to
-.SM MSB2LSB.
-.TP
-.B \-i
-Ignore non-fatal read errors and continue processing of the input file.
-.TP
-.B \-l
-Specify the length of a tile (in pixels).
-.I tiffcp
-attempts to set the tile dimensions so
-that no more than 8 kilobytes of data appear in a tile.
-.TP
-.B \-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.
-.TP
-.B \-M
-Suppress the use of memory-mapped files when reading images.
-.TP
-.BI \-o " offset"
-Set initial directory offset.
-.TP
-.B \-p
-Specify the planar configuration to use in writing image data
-that has one 8-bit sample per pixel.
-By default,
-.I tiffcp
-will create a new file with the same planar configuration as
-the original.
-Specifying
-.B "\-p contig"
-will force data to be written with multi-sample data packed
-together, while
-.B "\-p separate"
-will force samples to be written in separate planes.
-.TP
-.B \-r
-Specify the number of rows (scanlines) in each strip of data
-written to the output file.
-By default (or when value
-.B 0
-is specified),
-.I tiffcp
-attempts to set the rows/strip
-that no more than 8 kilobytes of data appear in a strip. If you specify
-special value
-.B \-1
-it will results in infinite number of the rows per strip. The entire image
-will be the one strip in that case.
-.TP
-.B \-s
-Force the output file to be written with data organized in strips
-(rather than tiles).
-.TP
-.B \-t
-Force the output file to be written with 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.
-.TP
-.B \-w
-Specify the width of a tile (in pixels).
-.I tiffcp
-attempts to set the tile dimensions so that no more than 8 kilobytes of data
-appear in a tile.
-.I tiffcp
-attempts to set the tile dimensions so that no more than 8 kilobytes of data
-appear in a tile.
-.TP
-.B \-x
-Force the output file to be written with PAGENUMBER value in sequence.
-.TP
-.B \-8
-Write BigTIFF instead of classic TIFF format.
-.TP
-.BI \-,= character
-substitute
-.I character
-for `,' in parsing image directory indices
-in files. This is necessary if filenames contain commas.
-Note that
-.B \-,=
-with whitespace immediately following will disable
-the special meaning of the `,' entirely. See examples.
-.SH EXAMPLES
-The following concatenates two files and writes the result using
-.SM LZW
-encoding:
-.RS
-.nf
-tiffcp \-c lzw a.tif b.tif result.tif
-.fi
-.RE
-.PP
-To convert a G3 1d-encoded
-.SM TIFF
-to a single strip of G4-encoded data the following might be used:
-.RS
-.nf
-tiffcp \-c g4 \-r 10000 g3.tif g4.tif
-.fi
-.RE
-(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'':
-.RS
-.nf
-tiffcp album.tif,0,2 result.tif
-.fi
-.RE
-
-A trailing comma denotes remaining images in sequence. The following command
-will copy all image with except the first one:
-.RS
-.nf
-tiffcp album.tif,1, result.tif
-.fi
-.RE
-
-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:
-.RS
-.nf
-tiffcp \-c none \-b CCD.tif CCD.tif,1, result.tif
-.fi
-.RE
-
-If the file above were named ``CCD,X.tif'', the
-.B \-,=
-option would
-be required to correctly parse this filename with image numbers,
-as follows:
-.RS
-.nf
-tiffcp \-c none \-,=% \-b CCD,X.tif CCD,X%1%.tif result.tif
-.SH "SEE ALSO"
-.BR pal2rgb (1),
-.BR tiffinfo (1),
-.BR tiffcmp (1),
-.BR tiffmedian (1),
-.BR tiffsplit (1),
-.BR libtiff (3TIFF)
-.PP
-Libtiff library home page:
-.BR http://www.remotesensing.org/libtiff/