NAME

       raw2tiff - create a TIFF file from a raw data

SYNOPSIS

       raw2tiff [ options ] input.raw output.tif

DESCRIPTION

       raw2tiff converts a raw byte sequence into TIFF.  By default, the TIFF image is created with data samples
       packed (PlanarConfiguration=1), compressed with the PackBits algorithm (Compression=32773), and with each
       strip  no  more than 8 kilobytes.  These characteristics can overridden, or explicitly specified with the
       options described below.

OPTIONS

       -H number
              size of input image file header in bytes (0 by default). This amount of data just will be  skipped
              from the start of file while reading.

       -w number
              width of input image in pixels (can be guessed, see GUESSING THE IMAGE GEOMETRY below).

       -l number
              length of input image in lines (can be guessed, see GUESSING THE IMAGE GEOMETRY below).

       -b number
              number of bands in input image (1 by default).

       -d data_type
              type of samples in input image, where data_type may be:
              byte     8-bit unsigned integer (default),
              short    16-bit unsigned integer,
              long     32-bit unsigned integer,
              sbyte    8-bit signed integer,
              sshort   16-bit signed integer,
              slong    32-bit signed integer,
              float    32-bit IEEE floating point,
              double   64-bit IEEE floating point.

       -i config
              type of samples interleaving in input image, where config may be:
              pixel   pixel interleaved data (default),
              band    band interleaved data.

       -p photo
              photometric interpretation (color space) of the input image, where photo may be:
              miniswhite   white color represented with 0 value,
              minisblack   black color represented with 0 value (default),
              rgb          image has RGB color model,
              cmyk         image has CMYK (separated) color model,
              ycbcr        image has YCbCr color model,
              cielab       image has CIE L*a*b color model,
              icclab       image has ICC L*a*b color model,
              itulab       image has ITU L*a*b color model.

       -s     swap bytes fetched from the input file.

       -L     input data has LSB2MSB bit order (default).

       -M     input data has MSB2LSB bit order.

       -c     Specify  a  compression  scheme  to  use  when  writing image data: -c none for no compression, -c
              packbits for the PackBits compression algorithm (the default),  -c  jpeg  for  the  baseline  JPEG
              compression  algorithm,  -c zip for the Deflate compression algorithm, and -c lzw for Lempel-Ziv &
              Welch.

       -r number
              Write data with a specified number of rows per strip; by  default  the  number  of  rows/strip  is
              selected so that each strip is approximately 8 kilobytes.

GUESSING THE IMAGE GEOMETRY

       raw2tiff  can  guess image width and height in case one or both of these parameters are not specified. If
       you omit one of those parameters, the complementary one will be calculated based on the file size (taking
       into  account  header  size, number of bands and data type). If you omit both parameters, the statistical
       approach will be used. Utility will compute correlation coefficient between two lines at the image center
       using  several appropriate line sizes and the highest absolute value of the coefficient will indicate the
       right line size. That is why you should be cautious with the very large images, because guessing  process
       may  take  a  while (depending on your system performance). Of course, the utility can't guess the header
       size, number of bands and data type, so it should be specified manually. If you don't know anything about
       your image, just try with the several combinations of those options.

       There  is  no magic, it is just a mathematical statistics, so it can be wrong in some cases. But for most
       ordinary images guessing method will work fine.

SEE ALSO

       pal2rgb(1), tiffinfo(1), tiffcp(1), tiffmedian(1), libtiff(3)

       Libtiff library home page: http://www.simplesystems.org/libtiff/