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  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.
 
               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 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
               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                TIFFCP(1)

---