HP/util/HP/man/man1/tiffcp.1

   1 .\"     $Header: /CVS_DB/Eos/util/HP/man/man1/tiffcp.1,v 1.1.1.1 2002/02/01 06:30:52 tacyas Exp $
   2 .\"
   3 .\" Copyright (c) 1988-1997 Sam Leffler
   4 .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
   5 .\"
   6 .\" Permission to use, copy, modify, distribute, and sell this software and
   7 .\" its documentation for any purpose is hereby granted without fee, provided
   8 .\" that (i) the above copyright notices and this permission notice appear in
   9 .\" all copies of the software and related documentation, and (ii) the names of
  10 .\" Sam Leffler and Silicon Graphics may not be used in any advertising or
  11 .\" publicity relating to the software without the specific, prior written
  12 .\" permission of Sam Leffler and Silicon Graphics.
  13 .\"
  14 .\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
  15 .\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  16 .\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  17 .\"
  18 .\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  19 .\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  20 .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  21 .\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  22 .\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  23 .\" OF THIS SOFTWARE.
  24 .\"
  25 .if n .po 0
  26 .TH TIFFCP 1 "January 9, 1996"
  27 .SH NAME
  28 tiffcp \- copy (and possibly convert) a
  29 .SM TIFF
  30 file
  31 .SH SYNOPSIS
  32 .B tiffcp
  33 [
  34 .I options
  35 ]
  36 .I "src1.tif ... srcN.tif dst.tif"
  37 .SH DESCRIPTION
  38 .I tiffcp
  39 combines one or more files created according
  40 to the Tag Image File Format, Revision 6.0
  41 into a single
  42 .SM TIFF
  43 file.
  44 Because the output file may be compressed using a different
  45 algorithm than the input files,
  46 .I tiffcp
  47 is most often used to convert between different compression
  48 schemes.
  49 .PP
  50 By default,
  51 .I tiffcp
  52 will copy all the understood tags in a
  53 .SM TIFF
  54 directory of an input
  55 file to the associated directory in the output file.
  56 .PP
  57 .I tiffcp
  58 can be used to reorganize the storage characteristics of data
  59 in a file, but it is explicitly intended to not alter or convert
  60 the image data content in any way.
  61 .SH OPTIONS
  62 .TP
  63 .B \-B
  64 Force output to be written with Big-Endian byte order.
  65 This option only has an effect when the output file is created or
  66 overwritten and not when it is appended to.
  67 .TP
  68 .B \-C
  69 Suppress the use of ``strip chopping'' when reading images
  70 that have a single strip/tile of uncompressed data.
  71 .TP
  72 .B \-c
  73 Specify the compression to use for data written to the output file:
  74 .B none
  75 for no compression,
  76 .B packbits
  77 for PackBits compression,
  78 .B lzw
  79 for Lempel-Ziv & Welch compression,
  80 .B jpeg
  81 for baseline JPEG compression,
  82 .B zip
  83 for Deflate compression,
  84 .B g3
  85 for CCITT Group 3 (T.4) compression,
  86 and
  87 .B g4
  88 for CCITT Group 4 (T.6) compression.
  89 By default
  90 .I tiffcp
  91 will compress data according to the value of the
  92 .I Compression
  93 tag found in the source file.
  94 .IP
  95 The
  96 .SM CCITT
  97 Group 3 and Group 4 compression algorithms can only
  98 be used with bilevel data.
  99 .IP
 100 Group 3 compression can be specified together with several
 101 T.4-specific options:
 102 .B 1d
 103 for 1-dimensional encoding,
 104 .B 2d
 105 for 2-dimensional encoding,
 106 and
 107 .B fill
 108 to force each encoded scanline to be zero-filled so that the
 109 terminating EOL code lies on a byte boundary.
 110 Group 3-specific options are specified by appending a ``:''-separated
 111 list to the ``g3'' option; e.g.
 112 .B "\-c g3:2d:fill"
 113 to get 2D-encoded data with byte-aligned EOL codes.
 114 .IP
 115 .SM LZW
 116 compression can be specified together with a
 117 .I predictor
 118 value.
 119 A predictor value of 2 causes
 120 each scanline of the output image to undergo horizontal
 121 differencing before it is encoded; a value
 122 of 1 forces each scanline to be encoded without differencing.
 123 LZW-specific options are specified by appending a ``:''-separated
 124 list to the ``lzw'' option; e.g.
 125 .B "\-c lzw:2"
 126 for
 127 .SM LZW
 128 compression with horizontal differencing.
 129 .TP
 130 .B \-f
 131 Specify the bit fill order to use in writing output data.
 132 By default,
 133 .I tiffcp
 134 will create a new file with the same fill order as the original.
 135 Specifying
 136 .B "\-f lsb2msb"
 137 will force data to be written with the FillOrder tag set to
 138 .SM LSB2MSB,
 139 while
 140 .B "\-f msb2lsb"
 141 will force data to be written with the FillOrder tag set to
 142 .SM MSB2LSB.
 143 .TP
 144 .B \-l
 145 Specify the length of a tile (in pixels).
 146 .I tiffcp
 147 attempts to set the tile dimensions so
 148 that no more than 8 kilobytes of data appear in a tile.
 149 .TP
 150 .B \-L
 151 Force output to be written with Little-Endian byte order.
 152 This option only has an effect when the output file is created or
 153 overwritten and not when it is appended to.
 154 .TP
 155 .B \-M
 156 Suppress the use of memory-mapped files when reading images.
 157 .TP
 158 .B \-p
 159 Specify the planar configuration to use in writing image data
 160 that has one 8-bit sample per pixel.
 161 By default,
 162 .I tiffcp
 163 will create a new file with the same planar configuration as
 164 the original.
 165 Specifying
 166 .B "\-p contig"
 167 will force data to be written with multi-sample data packed
 168 together, while
 169 .B "\-p separate"
 170 will force samples to be written in separate planes.
 171 .TP
 172 .B \-r
 173 Specify the number of rows (scanlines) in each strip of data
 174 written to the output file.
 175 By default,
 176 .I tiffcp
 177 attempts to set the rows/strip
 178 that no more than 8 kilobytes of data appear in a strip.
 179 .TP
 180 .B \-s
 181 Force the output file to be written with data organized in strips
 182 (rather than tiles).
 183 .TP
 184 .B \-t
 185 Force the output file to be written wtih data organized in tiles
 186 (rather than strips).
 187 options can be used to force the resultant image to be written
 188 as strips or tiles of data, respectively.
 189 .TP
 190 .B \-w
 191 Specify the width of a tile (in pixels).
 192 .I tiffcp
 193 attempts to set the tile dimensions so
 194 that no more than 8 kilobytes of data appear in a tile.
 195 .SH EXAMPLES
 196 The following concatenates two files and writes the result using
 197 .SM LZW
 198 encoding:
 199 .RS
 200 .nf
 201 tiffcp -c lzw a.tif b.tif result.tif
 202 .fi
 203 .RE
 204 .PP
 205 To convert a G3 1d-encoded
 206 .SM TIFF
 207 to a single strip of G4-encoded data the following might be used:
 208 .RS
 209 .nf
 210 tiffcp -c g4 -r 10000 g3.tif g4.tif
 211 .fi
 212 .RE
 213 (1000 is just a number that is larger than the number of rows in
 214 the source file.)
 215 .SH "SEE ALSO"
 216 .IR pal2rgb (1),
 217 .IR tiffinfo (1),
 218 .IR tiffcmp (1),
 219 .IR tiffmedian (1),
 220 .IR tiffsplit (1),
 221 .IR libtiff (3)