1.2.1
by Jay Berkenbilt
Import upstream version 4.0.0~beta4 |
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/ |