'\" te
.TH tiffcp 1 "26 Mar 2004" "SunOS 5.11" "User Commands"
.SH "NAME"
tiffcp \- copy,
and possibly convert, a TIFF file
.SH "SYNOPSIS"
.PP
\fBtiffcp\fR [\fB\fIoptions\fR\fR] \fB\fIsrc1\&.tif\fR\fR\&... \fB\fIsrcN\&.tif\fR\fR \fB\fIdest\&.tif\fR\fR
.SH "DESCRIPTION"
.PP
\fBtiffcp\fR combines one or more files created according
to the Tag Image File Format, Revision 6\&.0 into a single TIFF file\&. The output
file might be compressed using a different algorithm than the input files\&.
Therefore\&. \fBtiffcp\fR is most often used to convert between
different compression schemes\&.
.PP
By default, \fBtiffcp\fR copies all of the understood tags
in a TIFF directory of an input file, to the associated directory in the output
file\&.
.PP
\fBtiffcp\fR can be used to reorganize the storage characteristics
of data in a file, but is explicitly intended to not alter or convert the
image data content in any way\&.
.SH "OPTIONS"
.PP
The following options are supported:
.sp
.ne 2
.mk
\fB-\fBB\fR\fR
.in +16n
.rt
Force output
to be written with Big-Endian byte order\&. This option only has an effect when
the output file is created or overwritten\&. This option has no effect when
you append to the output file\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBC\fR\fR
.in +16n
.rt
Suppress the
use of "strip chopping" when reading images that have a single
strip or tile of uncompressed data\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBc\fR\fR
.in +16n
.rt
Specify a compression
scheme to use when writing image data:
.sp
.sp
.ne 2
.mk
\fB-\fBc g3\fR\fR
.in +24n
.rt
CCITT Group
3 compression algorithm\&.
.sp
.sp 2
.in -24n
.sp
.ne 2
.mk
\fB-\fBc g4\fR\fR
.in +24n
.rt
CCITT Group
4 compression algorithm\&.
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB-\fBc jpeg\fR\fR
.in +24n
.rt
Baseline
JPEG compression algorithm\&.
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB-\fBc lzw\fR\fR
.in +24n
.rt
Lempel-Ziv
and Welch algorithm\&.
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB-\fBc none\fR\fR
.in +24n
.rt
No compression\&.
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB-\fBc packbits\fR\fR
.in +24n
.rt
PackBits
compression algorithm\&.
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB-\fBc zip\fR\fR
.in +24n
.rt
Deflate compression
algorithm\&.
.sp
.sp 1
.in -24n
By default, \fBtiffcp\fR compresses data
according to the value of the Compression tag found in the source file\&.
.sp
.sp 0
.in -16n
.sp
.ne 2
.mk
\fB-\fBf\fR\fR
.in +16n
.rt
Specify the bit
fill order to use to write output data\&. By default, \fBtiffcp\fR
creates a new file with the same fill order as the original\&. Specify -\fBf lsb2msb\fR to force data to be written with the FillOrder tag set
to LSB2MSB\&. Specify -\fBf msb2lsb\fR to force data to be written
with the FillOrder tag set to MSB2LSB\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBl\fR\fR
.in +16n
.rt
Specify the length
of a tile in pixels\&. \fBtiffcp\fR attempts to set the tile dimensions
so that no more than 8 kilobytes of data appear in a tile\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBL\fR\fR
.in +16n
.rt
Force output
to be written with Little-Endian byte order\&. This option only has an effect
when the output file is created or overwritten\&. This option has no effect
when you append to the output file\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBM\fR\fR
.in +16n
.rt
Suppress the
use of memory-mapped files when reading images\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBp\fR\fR
.in +16n
.rt
Explicitly select
the planar configuration used to write image data  that has one 8-bit sample
per pixel\&. By default, \fBtiffcp\fR creates a new file with the
same planar configuration as the original\&.
.sp
.sp
.ne 2
.mk
\fB-\fBp contig\fR\fR
.in +24n
.rt
Samples
are packed contiguously\&.
.sp
.sp 2
.in -24n
.sp
.ne 2
.mk
\fB-\fBp separate\fR\fR
.in +24n
.rt
Samples
are stored separately\&.
.sp
.sp 1
.in -24n
.sp 0
.in -16n
.sp
.ne 2
.mk
\fB-\fBr\fR\fR
.in +16n
.rt
Write data with
a specified number of rows per strip\&. By default, the number of rows per strip
is selected so that each strip is approximately 8 kilobytes\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBs\fR\fR
.in +16n
.rt
Force the output
file to be written with data organized in strips instead of tiles\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBt\fR\fR
.in +16n
.rt
Force the output
file to be written with data organized in tiles instead of strips\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB-\fBw\fR\fR
.in +16n
.rt
Specify the width
of a tile in pixels\&. \fBtiffcp\fR attempts to set the tile dimensions
so that no more than 8 kilobytes of data appear in a tile\&.
.sp
.sp 1
.in -16n
.SH "OPERANDS"
.PP
The following operands are supported:
.sp
.ne 2
.mk
\fB\fB\fIsrc\&.tif\fR\fR\fR
.in +16n
.rt
The name of the source file\&.
.sp
.sp 1
.in -16n
.sp
.ne 2
.mk
\fB\fB\fIdest\&.tif\fR\fR\fR
.in +16n
.rt
The name of the destination file\&.
.sp
.sp 1
.in -16n
.SH "EXTENDED DESCRIPTION"
.PP
The CCITT Group 3 and Group 4 compression algorithms can only be used
with bilevel data\&.
.PP
Group 3 compression can be specified together with several T\&.4-specific
options:
.sp
.ne 2
.mk
\fB\fB1d\fR\fR
.in +24n
.rt
1-dimensional encoding
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB\fB2d\fR\fR
.in +24n
.rt
2-dimensional encoding
.sp
.sp 1
.in -24n
.sp
.ne 2
.mk
\fB\fBfill\fR\fR
.in +24n
.rt
Force each encoded scanline to be zero-filled so that the terminating EOL
code lies on a byte boundary\&.
.sp
.sp 1
.in -24n
.PP
Group 3-specific options are specified by appending a
colon-separated list to the \fBg3\fR option\&. For
example, specify -\fBc\fR \fBg3:2d:fill\fR
to get 2D-encoded data with byte-aligned EOL codes\&.
.PP
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 being encoded\&. A predictor value of 1 forces each scanline
to be encoded without differencing\&.
.PP
LZW-specific options are specified by appending a colon-separated list
to the \fBlzw\fR option\&. For example, specify -\fBc\fR \fBlzw:2\fR for LZW compression with horizontal
differencing\&.
.SH "EXAMPLES"
.PP
\fBExample 1: Concatenating Two Files and Writing the Result Using LZW Encoding\fR
.PP
.PP
.nf
example% \fBtiffcp -c lzw a\&.tif b\&.tif result\&.tif\fR
.fi
.PP
\fBExample 2: Converting a G3 1d-Encoded TIFF to a Single Strip of G4-Encoded Data \fR
.PP
.PP
.nf
example% \fBtiffcp -c g4 -r 10000 g3\&.tif g4\&.tif\fR
.fi
.PP
In this example, 1000 is a number that is larger than the number of
rows in the source file\&.
.SH "ATTRIBUTES"
.PP
See \fBattributes\fR(5)
for descriptions of the following attributes:
.sp
.TS
tab() allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPEATTRIBUTE VALUE
Availabilityimage/library/libtiff
Interface stabilityUncommitted
.TE
.sp
.SH "SEE ALSO"
.PP
\fBpal2rgb\fR(1), \fBtiffinfo\fR(1), \fBtiffcmp\fR(1), \fBtiffmedian\fR(1), \fBtiffsplit\fR(1), \fBlibtiff\fR(3)
.SH "NOTES"
.PP
Updated by Breda McColgan, Sun Microsystems Inc\&., 2004\&.
...\" created by instant / solbook-to-man, Thu 20 Mar 2014, 02:30
...\" LSARC 2003/085 libtiff, libjpeg, and libpng