TIFFCP(1)                                               TIFFCP(1)

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 direc-
       tory in the output file.

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

OPTIONS
       -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  compres-
              sion,  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.

              The  CCITT  Group  3  and Group 4 compression algo-
              rithms 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 bound-
              ary.   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  hori-
              zontal  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,  tiffcp will create a new file
              with the same fill order as the original.  Specify-
              ing  -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     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
              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 one 8-bit sample per pixel.  By
              default,  tiffcp  will  create  a new file with the
              same planar configuration as the original.   Speci-
              fying  -p contig will force data to be written with
              multi-sample data packed together, while  -p  sepa-
              rate  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, tiffcp attempts to set the rows/strip that
              no more than 8 kilobytes of data appear in a strip.

       -s     Force the output file to be written with data orga-
              nized in strips (rather than tiles).

       -t     Force the output file to be written wtih data orga-
              nized 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.

EXAMPLES
       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:
              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.)

SEE ALSO
       pal2rgb(1), tiffinfo(1), tiffcmp(1), tiffmedian(1), tiffs-
       plit(1), libtiff(3)

                         January 9, 1996                        1