src/tiff/man/raw2tiff.1

   1 .\" $Id: raw2tiff.1,v 1.5 2005/11/02 11:07:19 dron Exp $
   2 .\"
   3 .\" Copyright (c) 1990-1997 Sam Leffler
   4 .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
   5 .\"
   6 .\" Permission to use, copy, modify, distribute, and sell this software and
   7 .\" its documentation for any purpose is hereby granted without fee, provided
   8 .\" that (i) the above copyright notices and this permission notice appear in
   9 .\" all copies of the software and related documentation, and (ii) the names of
  10 .\" Sam Leffler and Silicon Graphics may not be used in any advertising or
  11 .\" publicity relating to the software without the specific, prior written
  12 .\" permission of Sam Leffler and Silicon Graphics.
  13 .\"
  14 .\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
  15 .\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  16 .\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  17 .\"
  18 .\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  19 .\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  20 .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  21 .\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  22 .\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  23 .\" OF THIS SOFTWARE.
  24 .\"
  25 .if n .po 0
  26 .TH RAW2TIFF 1 "November 2, 2005" "libtiff"
  27 .SH NAME
  28 raw2tiff \- create a
  29 .SM TIFF
  30 file from a raw data
  31 .SH SYNOPSIS
  32 .B raw2tiff
  33 [
  34 .I options
  35 ]
  36 .I input.raw
  37 .I output.tif
  38 .SH DESCRIPTION
  39 .I raw2tiff
  40 converts a raw byte sequence into
  41 .SM TIFF.
  42 By default, the
  43 .SM TIFF
  44 image is created with data samples packed (\c
  45 .IR PlanarConfiguration =1),
  46 compressed with the PackBits algorithm (\c
  47 .IR Compression = 32773),
  48 and with each strip no more than 8 kilobytes.
  49 These characteristics can overridden, or explicitly specified
  50 with the options described below.
  51 .SH OPTIONS
  52 .TP
  53 .B \-H <number>
  54 size of input image file header in bytes (0 by default). This amount of data
  55 just will be skipped from the start of file while reading.
  56 .TP
  57 .B \-w <number>
  58 width of input image in pixels (can be guessed, see
  59 .SM
  60 .B "GUESSING THE IMAGE GEOMETRY"
  61 below).
  62 .TP
  63 .B \-l <number>
  64 length of input image in lines(can be guessed, see
  65 .SM
  66 .B "GUESSING THE IMAGE GEOMETRY"
  67 below).
  68 .TP
  69 .B \-b <number>
  70 number of bands in input image (1 by default).
  71 .TP
  72 .B \-d data_type
  73 type of samples in input image, where
  74 .B data_type
  75 may be:
  76 .br
  77 .I byte\t\t
  78 8-bit unsigned integer (default),
  79 .br
  80 .I short\t
  81 16-bit unsigned integer,
  82 .br
  83 .I long\t\t
  84 32-bit unsigned integer,
  85 .br
  86 .I sbyte\t
  87 8-bit signed integer,
  88 .br
  89 .I sshort\t
  90 16-bit signed integer,
  91 .br
  92 .I slong\t
  93 32-bit signed integer,
  94 .br
  95 .I float\t
  96 32-bit IEEE floating point,
  97 .br
  98 .I double\t
  99 64-bit IEEE floating point,
 100 .TP
 101 .B \-i config
 102 type of samples interleaving in input image, where
 103 .B config
 104 may be:
 105 .br
 106 .I pixel\t
 107 pixel interleaved data (default),
 108 .br
 109 .I band\t\t
 110 band interleaved data.
 111 .TP
 112 .B \-p photo
 113 photometric interpretation (color space) of the input image, where
 114 .B photo
 115 may be:
 116 .br
 117 .I miniswhite
 118 white color represented with 0 value,
 119 .br
 120 .I minisblack
 121 black color represented with 0 value (default),
 122 .br
 123 .I rgb\t\t
 124 image has RGB color model,
 125 .br
 126 .I cmyk\t\t
 127 image has CMYK (separated) color model,
 128 .br
 129 .I ycbcr\t\t
 130 image has YCbCr color model,
 131 .br
 132 .I cielab\t
 133 image has CIE L*a*b color model,
 134 .br
 135 .I icclab\t
 136 image has ICC L*a*b color model,
 137 .br
 138 .I itulab\t
 139 image has ITU L*a*b color model,
 140 .TP
 141 .B \-s
 142 swap bytes fetched from the input file.
 143 .TP
 144 .B \-L
 145 input data has LSB2MSB bit order (default).
 146 .TP
 147 .B \-M
 148 input data has MSB2LSB bit order.
 149 .TP
 150 .B \-c
 151 Specify a compression scheme to use when writing image data:
 152 .B "\-c none"
 153 for no compression,
 154 .B "-c packbits"
 155 for the PackBits compression algorithm (the default),
 156 .B "-c jpeg"
 157 for the baseline JPEG compression algorithm,
 158 .B "-c zip
 159 for the Deflate compression algorithm,
 160 and
 161 .B "\-c lzw"
 162 for Lempel-Ziv & Welch.
 163 .TP
 164 .B \-r <number>
 165 Write data with a specified number of rows per strip;
 166 by default the number of rows/strip is selected so that each strip
 167 is approximately 8 kilobytes.
 168 .SH GUESSING THE IMAGE GEOMETRY
 169 .I raw2tiff
 170 can guess image width and height in case one or both of these parameters are
 171 not specified. If you omit one of those parameters, the complementary one will
 172 be calculated based on the file size (taking into account header size, number
 173 of bands and data type). If you omit both parameters, the statistical approach
 174 will be used. Utility will compute correlation coefficient between two lines
 175 at the image center using several appropriate line sizes and the highest
 176 absolute value of the coefficient will indicate the right line size. That is
 177 why you should be cautious with the very large images, because guessing
 178 process may take a while (depending on your system performance). Of course, the
 179 utility can't guess the header size, number of bands and data type, so it
 180 should be specified manually. If you don't know anything about your image,
 181 just try with the several combinations of those options.
 182 .P
 183 There is no magic, it is just a mathematical statistics, so it can be wrong
 184 in some cases. But for most ordinary images guessing method will work fine.
 185 .SH "SEE ALSO"
 186 .BR pal2rgb (1),
 187 .bR tiffinfo (1),
 188 .BR tiffcp (1),
 189 .BR tiffmedian (1),
 190 .BR libtiff (3)
 191 .PP
 192 Libtiff library home page:
 193 .BR http://www.remotesensing.org/libtiff/