forked from Mirrors/freeswitch
197 lines
5.3 KiB
Groff
197 lines
5.3 KiB
Groff
.\" $Id: raw2tiff.1,v 1.7 2009-08-24 19:13:40 bfriesen Exp $
|
|
.\"
|
|
.\" Copyright (c) 1990-1997 Sam Leffler
|
|
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
|
|
.\"
|
|
.\" Permission to use, copy, modify, distribute, and sell this software and
|
|
.\" its documentation for any purpose is hereby granted without fee, provided
|
|
.\" that (i) the above copyright notices and this permission notice appear in
|
|
.\" all copies of the software and related documentation, and (ii) the names of
|
|
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
|
|
.\" publicity relating to the software without the specific, prior written
|
|
.\" permission of Sam Leffler and Silicon Graphics.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
|
|
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
|
|
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
|
|
.\"
|
|
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
|
|
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
|
|
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
|
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
|
|
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
|
|
.\" OF THIS SOFTWARE.
|
|
.\"
|
|
.if n .po 0
|
|
.TH RAW2TIFF 1 "November 2, 2005" "libtiff"
|
|
.SH NAME
|
|
raw2tiff \- create a
|
|
.SM TIFF
|
|
file from a raw data
|
|
.SH SYNOPSIS
|
|
.B raw2tiff
|
|
[
|
|
.I options
|
|
]
|
|
.I input.raw
|
|
.I output.tif
|
|
.SH DESCRIPTION
|
|
.I raw2tiff
|
|
converts a raw byte sequence into
|
|
.SM TIFF.
|
|
By default, the
|
|
.SM TIFF
|
|
image is created with data samples packed (\c
|
|
.IR PlanarConfiguration =1),
|
|
compressed with the PackBits algorithm (\c
|
|
.IR Compression =32773),
|
|
and with each strip no more than 8 kilobytes.
|
|
These characteristics can overridden, or explicitly specified
|
|
with the options described below.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI \-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.
|
|
.TP
|
|
.BI \-w " number"
|
|
width of input image in pixels (can be guessed, see
|
|
.SM
|
|
.B "GUESSING THE IMAGE GEOMETRY"
|
|
below).
|
|
.TP
|
|
.BI \-l " number"
|
|
length of input image in lines (can be guessed, see
|
|
.SM
|
|
.B "GUESSING THE IMAGE GEOMETRY"
|
|
below).
|
|
.TP
|
|
.BI \-b " number"
|
|
number of bands in input image (1 by default).
|
|
.TP
|
|
.BI \-d " data_type"
|
|
type of samples in input image, where
|
|
.I data_type
|
|
may be:
|
|
.ta \w'\fBdouble \fR'u
|
|
.br
|
|
.B byte\t
|
|
8-bit unsigned integer (default),
|
|
.br
|
|
.B short\t
|
|
16-bit unsigned integer,
|
|
.br
|
|
.B long\t
|
|
32-bit unsigned integer,
|
|
.br
|
|
.B sbyte\t
|
|
8-bit signed integer,
|
|
.br
|
|
.B sshort\t
|
|
16-bit signed integer,
|
|
.br
|
|
.B slong\t
|
|
32-bit signed integer,
|
|
.br
|
|
.B float\t
|
|
32-bit IEEE floating point,
|
|
.br
|
|
.B double\t
|
|
64-bit IEEE floating point.
|
|
.TP
|
|
.BI \-i " config"
|
|
type of samples interleaving in input image, where
|
|
.I config
|
|
may be:
|
|
.ta \w'\fBpixel \fR'u
|
|
.br
|
|
.B pixel\t
|
|
pixel interleaved data (default),
|
|
.br
|
|
.B band\t
|
|
band interleaved data.
|
|
.TP
|
|
.BI \-p " photo"
|
|
photometric interpretation (color space) of the input image, where
|
|
.I photo
|
|
may be:
|
|
.ta \w'\fBminiswhite \fR'u
|
|
.br
|
|
.B miniswhite\t
|
|
white color represented with 0 value,
|
|
.br
|
|
.B minisblack\t
|
|
black color represented with 0 value (default),
|
|
.br
|
|
.B rgb\t
|
|
image has RGB color model,
|
|
.br
|
|
.B cmyk\t
|
|
image has CMYK (separated) color model,
|
|
.br
|
|
.B ycbcr\t
|
|
image has YCbCr color model,
|
|
.br
|
|
.B cielab\t
|
|
image has CIE L*a*b color model,
|
|
.br
|
|
.B icclab\t
|
|
image has ICC L*a*b color model,
|
|
.br
|
|
.B itulab\t
|
|
image has ITU L*a*b color model.
|
|
.TP
|
|
.B \-s
|
|
swap bytes fetched from the input file.
|
|
.TP
|
|
.B \-L
|
|
input data has LSB2MSB bit order (default).
|
|
.TP
|
|
.B \-M
|
|
input data has MSB2LSB bit order.
|
|
.TP
|
|
.B \-c
|
|
Specify a compression scheme to use when writing image data:
|
|
.B "\-c none"
|
|
for no compression,
|
|
.B "\-c packbits"
|
|
for the PackBits compression algorithm (the default),
|
|
.B "\-c jpeg"
|
|
for the baseline JPEG compression algorithm,
|
|
.B "\-c zip"
|
|
for the Deflate compression algorithm,
|
|
and
|
|
.B "\-c lzw"
|
|
for Lempel-Ziv & Welch.
|
|
.TP
|
|
.BI \-r " number"
|
|
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.
|
|
.SH GUESSING THE IMAGE GEOMETRY
|
|
.I raw2tiff
|
|
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.
|
|
.P
|
|
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.
|
|
.SH "SEE ALSO"
|
|
.BR pal2rgb (1),
|
|
.BR tiffinfo (1),
|
|
.BR tiffcp (1),
|
|
.BR tiffmedian (1),
|
|
.BR libtiff (3)
|
|
.PP
|
|
Libtiff library home page:
|
|
.BR http://www.remotesensing.org/libtiff/
|