libtiff/html/man/raw2tiff.1.html
Bob Friesenhahn c3402403ea * html/man/Makefile.am (htmldoc): Fix htmldoc rule so that it can
be used if build directory is not the same as source directory.
* man/{TIFFGetField.3tiff, man/TIFFSetField.3tiff}: Documented
TIFFTAG_PHOTOSHOP, TIFFTAG_RICHTIFFIPTC, and TIFFTAG_XMLPACKET,
and re-sorted tag names in alphabetical order.
2006-01-02 23:50:44 +00:00

465 lines
11 KiB
HTML

<!-- Creator : groff version 1.19.2 -->
<!-- CreationDate: Mon Jan 2 17:41:53 2006 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; }
pre { margin-top: 0; margin-bottom: 0; }
table { margin-top: 0; margin-bottom: 0; }
</style>
<title>RAW2TIFF</title>
</head>
<body>
<h1 align=center>RAW2TIFF</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#GUESSING THE IMAGE GEOMETRY">GUESSING THE IMAGE GEOMETRY</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<a name="NAME"></a>
<h2>NAME</h2>
<p style="margin-left:11%; margin-top: 1em">raw2tiff
&minus; create a <small>TIFF</small> file from a raw
data</p>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<p style="margin-left:11%; margin-top: 1em"><b>raw2tiff</b>
[ <i>options</i> ] <i>input.raw output.tif</i></p>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<p style="margin-left:11%; margin-top: 1em"><i>raw2tiff</i>
converts a raw byte sequence into <small>TIFF.</small> By
default, the <small>TIFF</small> image is created with data
samples packed (<i>PlanarConfiguration</i>=1), compressed
with the PackBits algorithm
(<i>Compression</i>=<i>32773),</i> and with each strip no
more than 8 kilobytes. These characteristics can overridden,
or explicitly specified with the options described
below.</p>
<a name="OPTIONS"></a>
<h2>OPTIONS</h2>
<p style="margin-left:11%; margin-top: 1em"><b>&minus;H
&lt;number&gt;</b></p>
<p style="margin-left:22%;">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.</p>
<p style="margin-left:11%;"><b>&minus;w
&lt;number&gt;</b></p>
<p style="margin-left:22%;">width of input image in pixels
(can be guessed, see <b><small>GUESSING THE IMAGE
GEOMETRY</small></b> below).</p>
<p style="margin-left:11%;"><b>&minus;l
&lt;number&gt;</b></p>
<p style="margin-left:22%;">length of input image in
lines(can be guessed, see <b><small>GUESSING THE IMAGE
GEOMETRY</small></b> below).</p>
<p style="margin-left:11%;"><b>&minus;b
&lt;number&gt;</b></p>
<p style="margin-left:22%;">number of bands in input image
(1 by default).</p>
<p style="margin-left:11%;"><b>&minus;d data_type</b></p>
<p style="margin-left:22%;">type of samples in input image,
where <b>data_type</b> may be:</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>byte</i></p></td>
<td width="77%">
</td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%"></td>
<td width="77%">
<p valign="top">8-bit unsigned integer (default),</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>short</i></p></td>
<td width="77%">
<p valign="top">16-bit unsigned integer,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>long</i></p></td>
<td width="77%">
</td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%"></td>
<td width="77%">
<p valign="top">32-bit unsigned integer,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>sbyte</i></p></td>
<td width="77%">
<p valign="top">8-bit signed integer,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>sshort</i></p></td>
<td width="77%">
<p valign="top">16-bit signed integer,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>slong</i></p></td>
<td width="77%">
<p valign="top">32-bit signed integer,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>float</i></p></td>
<td width="77%">
<p valign="top">32-bit IEEE floating point,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>double</i></p></td>
<td width="77%">
<p valign="top">64-bit IEEE floating point,</p></td>
</table>
<p style="margin-left:11%;"><b>&minus;i config</b></p>
<p style="margin-left:22%;">type of samples interleaving in
input image, where <b>config</b> may be:</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>pixel</i></p></td>
<td width="77%">
<p valign="top">pixel interleaved data (default),</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>band</i></p></td>
<td width="77%">
</td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%"></td>
<td width="77%">
<p valign="top">band interleaved data.</p></td>
</table>
<p style="margin-left:11%;"><b>&minus;p photo</b></p>
<p style="margin-left:22%;">photometric interpretation
(color space) of the input image, where <b>photo</b> may be:
<i><br>
miniswhite</i> white color represented with 0 value, <i><br>
minisblack</i> black color represented with 0 value
(default),</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>rgb</i></p></td>
<td width="8%">
</td>
<td width="69%">
<p valign="top">image has RGB color model,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>cmyk</i></p></td>
<td width="8%">
</td>
<td width="69%">
<p valign="top">image has CMYK (separated) color model,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>ycbcr</i></p></td>
<td width="8%"></td>
<td width="69%">
</td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%"></td>
<td width="8%"></td>
<td width="69%">
<p valign="top">image has YCbCr color model,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>cielab</i></p></td>
<td width="8%"></td>
<td width="69%">
<p valign="top">image has CIE L*a*b color model,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>icclab</i></p></td>
<td width="8%"></td>
<td width="69%">
<p valign="top">image has ICC L*a*b color model,</p></td>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
<p valign="top"><i>itulab</i></p></td>
<td width="8%"></td>
<td width="69%">
<p valign="top">image has ITU L*a*b color model,</p></td>
</table>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>&minus;s</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">swap bytes fetched
from the input file.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>&minus;L</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">input data has
LSB2MSB bit order (default).</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>&minus;M</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">input data has
MSB2LSB bit order.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>&minus;c</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Specify a
compression scheme to use when writing image data:
<b>&minus;c none</b> for no compression, <b>-c packbits</b>
for the PackBits compression algorithm (the default), <b>-c
jpeg</b> for the baseline JPEG compression algorithm, <b>-c
zip</b> for the Deflate compression algorithm, and
<b>&minus;c lzw</b> for Lempel-Ziv &amp; Welch.</p></td>
</table>
<p style="margin-left:11%;"><b>&minus;r
&lt;number&gt;</b></p>
<p style="margin-left:22%;">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.</p>
<a name="GUESSING THE IMAGE GEOMETRY"></a>
<h2>GUESSING THE IMAGE GEOMETRY</h2>
<p style="margin-left:11%; margin-top: 1em"><i>raw2tiff</i>
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&rsquo;t guess the header size, number of bands
and data type, so it should be specified manually. If you
don&rsquo;t know anything about your image, just try with
the several combinations of those options.</p>
<p style="margin-left:11%; margin-top: 1em">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.</p>
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>
<p style="margin-left:11%; margin-top: 1em"><b>pal2rgb</b>(1),
<b>tiffcp</b>(1), <b>tiffmedian</b>(1),
<b>libtiff</b>(3)</p>
<p style="margin-left:11%; margin-top: 1em">Libtiff library
home page: <b>http://www.remotesensing.org/libtiff/</b></p>
<hr>
</body>
</html>