Provided by: libtiff-tools_4.5.1+git230720-1ubuntu1.2_amd64 bug

NAME

       raw2tiff - create a TIFF file from a raw data file

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

       option -b number

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

       -d datatype
              type of samples in input image, where datatype may be one of:

                                ┌──────────┬──────────────────────────────────┐
                                │Data type │ Description                      │
                                ├──────────┼──────────────────────────────────┤
                                │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 sample interleaving in input image, where config may be one of:

                              ┌──────────────┬──────────────────────────────────┐
                              │Configuration │ Description                      │
                              ├──────────────┼──────────────────────────────────┤
                              │pixel         │ pixel interleaved data (default) │
                              ├──────────────┼──────────────────────────────────┤
                              │band          │ band interleaved data.           │
                              └──────────────┴──────────────────────────────────┘

       -p photo
              photometric interpretation (color space) of the input image, where photo may be one
              of:

                               ┌────────────┬──────────────────────────────────┐
                               │Photometric │ Description                      │
                               ├────────────┼──────────────────────────────────┤
                               │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, -c lzw for Lempel-Ziv & Welch.

GUESSING THE IMAGE GEOMETRY

       raw2tif  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 (3tiff)

AUTHOR

       LibTIFF contributors

COPYRIGHT

       1988-2024, LibTIFF contributors