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  uncom­
              pressed 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.

              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 read­
              ing 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



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)


Man(1) output converted with man2html