ABCDEFGHIJKLMNOPQRSTUVWXYZ

tiffcp

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  compres-
       sion schemes.

       By  default,  tiffcp will copy all the understood tags in a TIFF direc-
       tory 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  pro-
              cessed.   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.

       -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 compres-
              sion, lzw for Lempel-Ziv & Welch compression, jpeg for  baseline
              JPEG  compression,  zip  for  Deflate  compression, g3 for CCITT
              Group 3 (T.4) compression, and g4 for CCITT Group 4  (T.6)  com-
              pression.  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 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  with a predictor
              value.  A predictor value of 2 causes each scanline of the  out-
              put  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.

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

       -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.   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     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  organized  in
              strips (rather than tiles).

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

       -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}
              substitute  {character}  for  ','  in  parsing  image  directory
              indices in files.  This is necessary if filenames  contain  com-
              mas.   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:
              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.)

       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:
              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  fol-
       lows:
              tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif

SEE ALSO
       pal2rgb(1),   tiffinfo(1),   tiffcmp(1),  tiffmedian(1),  tiffsplit(1),
       libtiff(3)



                               February 18, 2001                     TIFFCP(1)