src/tiff/man/raw2tiff.1

   1 .\" $Id: raw2tiff.1,v 1.7 2009-08-24 19:13:40 bfriesen 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 .BI \-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 .BI \-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 .BI \-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 .BI \-b " number"
  70 number of bands in input image (1 by default).
  71 .TP
  72 .BI \-d " data_type"
  73 type of samples in input image, where
  74 .I data_type
  75 may be:
  76 .ta \w'\fBdouble  \fR'u
  77 .br
  78 .B byte\t
  79 8-bit unsigned integer (default),
  80 .br
  81 .B short\t
  82 16-bit unsigned integer,
  83 .br
  84 .B long\t
  85 32-bit unsigned integer,
  86 .br
  87 .B sbyte\t
  88 8-bit signed integer,
  89 .br
  90 .B sshort\t
  91 16-bit signed integer,
  92 .br
  93 .B slong\t
  94 32-bit signed integer,
  95 .br
  96 .B float\t
  97 32-bit IEEE floating point,
  98 .br
  99 .B double\t
 100 64-bit IEEE floating point.
 101 .TP
 102 .BI \-i " config"
 103 type of samples interleaving in input image, where
 104 .I config
 105 may be:
 106 .ta \w'\fBpixel  \fR'u
 107 .br
 108 .B pixel\t
 109 pixel interleaved data (default),
 110 .br
 111 .B band\t
 112 band interleaved data.
 113 .TP
 114 .BI \-p " photo"
 115 photometric interpretation (color space) of the input image, where
 116 .I photo
 117 may be:
 118 .ta \w'\fBminiswhite  \fR'u
 119 .br
 120 .B miniswhite\t
 121 white color represented with 0 value,
 122 .br
 123 .B minisblack\t
 124 black color represented with 0 value (default),
 125 .br
 126 .B rgb\t
 127 image has RGB color model,
 128 .br
 129 .B cmyk\t
 130 image has CMYK (separated) color model,
 131 .br
 132 .B ycbcr\t
 133 image has YCbCr color model,
 134 .br
 135 .B cielab\t
 136 image has CIE L*a*b color model,
 137 .br
 138 .B icclab\t
 139 image has ICC L*a*b color model,
 140 .br
 141 .B itulab\t
 142 image has ITU L*a*b color model.
 143 .TP
 144 .B \-s
 145 swap bytes fetched from the input file.
 146 .TP
 147 .B \-L
 148 input data has LSB2MSB bit order (default).
 149 .TP
 150 .B \-M
 151 input data has MSB2LSB bit order.
 152 .TP
 153 .B \-c
 154 Specify a compression scheme to use when writing image data:
 155 .B "\-c none"
 156 for no compression,
 157 .B "\-c packbits"
 158 for the PackBits compression algorithm (the default),
 159 .B "\-c jpeg"
 160 for the baseline JPEG compression algorithm,
 161 .B "\-c zip"
 162 for the Deflate compression algorithm,
 163 and
 164 .B "\-c lzw"
 165 for Lempel-Ziv & Welch.
 166 .TP
 167 .BI \-r " number"
 168 Write data with a specified number of rows per strip;
 169 by default the number of rows/strip is selected so that each strip
 170 is approximately 8 kilobytes.
 171 .SH GUESSING THE IMAGE GEOMETRY
 172 .I raw2tiff
 173 can guess image width and height in case one or both of these parameters are
 174 not specified. If you omit one of those parameters, the complementary one will
 175 be calculated based on the file size (taking into account header size, number
 176 of bands and data type). If you omit both parameters, the statistical approach
 177 will be used. Utility will compute correlation coefficient between two lines
 178 at the image center using several appropriate line sizes and the highest
 179 absolute value of the coefficient will indicate the right line size. That is
 180 why you should be cautious with the very large images, because guessing
 181 process may take a while (depending on your system performance). Of course, the
 182 utility can't guess the header size, number of bands and data type, so it
 183 should be specified manually. If you don't know anything about your image,
 184 just try with the several combinations of those options.
 185 .P
 186 There is no magic, it is just a mathematical statistics, so it can be wrong
 187 in some cases. But for most ordinary images guessing method will work fine.
 188 .SH "SEE ALSO"
 189 .BR pal2rgb (1),
 190 .BR tiffinfo (1),
 191 .BR tiffcp (1),
 192 .BR tiffmedian (1),
 193 .BR libtiff (3)
 194 .PP
 195 Libtiff library home page:
 196 .BR http://www.remotesensing.org/libtiff/