Blame man/raw2tiff.1

Packit 7838c8
.\" $Id: raw2tiff.1,v 1.8 2016-09-25 20:05:51 bfriesen Exp $
Packit 7838c8
.\"
Packit 7838c8
.\" Copyright (c) 1990-1997 Sam Leffler
Packit 7838c8
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
Packit 7838c8
.\"
Packit 7838c8
.\" Permission to use, copy, modify, distribute, and sell this software and 
Packit 7838c8
.\" its documentation for any purpose is hereby granted without fee, provided
Packit 7838c8
.\" that (i) the above copyright notices and this permission notice appear in
Packit 7838c8
.\" all copies of the software and related documentation, and (ii) the names of
Packit 7838c8
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
Packit 7838c8
.\" publicity relating to the software without the specific, prior written
Packit 7838c8
.\" permission of Sam Leffler and Silicon Graphics.
Packit 7838c8
.\" 
Packit 7838c8
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
Packit 7838c8
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
Packit 7838c8
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
Packit 7838c8
.\" 
Packit 7838c8
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
Packit 7838c8
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
Packit 7838c8
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
Packit 7838c8
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
Packit 7838c8
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
Packit 7838c8
.\" OF THIS SOFTWARE.
Packit 7838c8
.\"
Packit 7838c8
.if n .po 0
Packit 7838c8
.TH RAW2TIFF 1 "November 2, 2005" "libtiff"
Packit 7838c8
.SH NAME
Packit 7838c8
raw2tiff \- create a
Packit 7838c8
.SM TIFF
Packit 7838c8
file from a raw data
Packit 7838c8
.SH SYNOPSIS
Packit 7838c8
.B raw2tiff
Packit 7838c8
[
Packit 7838c8
.I options
Packit 7838c8
]
Packit 7838c8
.I input.raw
Packit 7838c8
.I output.tif
Packit 7838c8
.SH DESCRIPTION
Packit 7838c8
.I raw2tiff
Packit 7838c8
converts a raw byte sequence into
Packit 7838c8
.SM TIFF.
Packit 7838c8
By default, the
Packit 7838c8
.SM TIFF
Packit 7838c8
image is created with data samples packed (\c
Packit 7838c8
.IR PlanarConfiguration =1),
Packit 7838c8
compressed with the PackBits algorithm (\c
Packit 7838c8
.IR Compression =32773),
Packit 7838c8
and with each strip no more than 8 kilobytes.
Packit 7838c8
These characteristics can overridden, or explicitly specified
Packit 7838c8
with the options described below.
Packit 7838c8
.SH OPTIONS
Packit 7838c8
.TP
Packit 7838c8
.BI \-H " number"
Packit 7838c8
size of input image file header in bytes (0 by default). This amount of data
Packit 7838c8
just will be skipped from the start of file while reading.
Packit 7838c8
.TP
Packit 7838c8
.BI \-w " number"
Packit 7838c8
width of input image in pixels (can be guessed, see
Packit 7838c8
.SM
Packit 7838c8
.B "GUESSING THE IMAGE GEOMETRY"
Packit 7838c8
below).
Packit 7838c8
.TP
Packit 7838c8
.BI \-l " number"
Packit 7838c8
length of input image in lines (can be guessed, see
Packit 7838c8
.SM
Packit 7838c8
.B "GUESSING THE IMAGE GEOMETRY"
Packit 7838c8
below).
Packit 7838c8
.TP
Packit 7838c8
.BI \-b " number"
Packit 7838c8
number of bands in input image (1 by default).
Packit 7838c8
.TP
Packit 7838c8
.BI \-d " data_type"
Packit 7838c8
type of samples in input image, where
Packit 7838c8
.I data_type
Packit 7838c8
may be:
Packit 7838c8
.ta \w'\fBdouble  \fR'u
Packit 7838c8
.br
Packit 7838c8
.B byte\t
Packit 7838c8
8-bit unsigned integer (default),
Packit 7838c8
.br
Packit 7838c8
.B short\t
Packit 7838c8
16-bit unsigned integer,
Packit 7838c8
.br
Packit 7838c8
.B long\t
Packit 7838c8
32-bit unsigned integer,
Packit 7838c8
.br
Packit 7838c8
.B sbyte\t
Packit 7838c8
8-bit signed integer,
Packit 7838c8
.br
Packit 7838c8
.B sshort\t
Packit 7838c8
16-bit signed integer,
Packit 7838c8
.br
Packit 7838c8
.B slong\t
Packit 7838c8
32-bit signed integer,
Packit 7838c8
.br
Packit 7838c8
.B float\t
Packit 7838c8
32-bit IEEE floating point,
Packit 7838c8
.br
Packit 7838c8
.B double\t
Packit 7838c8
64-bit IEEE floating point.
Packit 7838c8
.TP
Packit 7838c8
.BI \-i " config"
Packit 7838c8
type of samples interleaving in input image, where
Packit 7838c8
.I config
Packit 7838c8
may be:
Packit 7838c8
.ta \w'\fBpixel  \fR'u
Packit 7838c8
.br
Packit 7838c8
.B pixel\t
Packit 7838c8
pixel interleaved data (default),
Packit 7838c8
.br
Packit 7838c8
.B band\t
Packit 7838c8
band interleaved data.
Packit 7838c8
.TP
Packit 7838c8
.BI \-p " photo"
Packit 7838c8
photometric interpretation (color space) of the input image, where
Packit 7838c8
.I photo
Packit 7838c8
may be:
Packit 7838c8
.ta \w'\fBminiswhite  \fR'u
Packit 7838c8
.br
Packit 7838c8
.B miniswhite\t
Packit 7838c8
white color represented with 0 value,
Packit 7838c8
.br
Packit 7838c8
.B minisblack\t
Packit 7838c8
black color represented with 0 value (default),
Packit 7838c8
.br
Packit 7838c8
.B rgb\t
Packit 7838c8
image has RGB color model,
Packit 7838c8
.br
Packit 7838c8
.B cmyk\t
Packit 7838c8
image has CMYK (separated) color model,
Packit 7838c8
.br
Packit 7838c8
.B ycbcr\t
Packit 7838c8
image has YCbCr color model,
Packit 7838c8
.br
Packit 7838c8
.B cielab\t
Packit 7838c8
image has CIE L*a*b color model,
Packit 7838c8
.br
Packit 7838c8
.B icclab\t
Packit 7838c8
image has ICC L*a*b color model,
Packit 7838c8
.br
Packit 7838c8
.B itulab\t
Packit 7838c8
image has ITU L*a*b color model.
Packit 7838c8
.TP
Packit 7838c8
.B \-s
Packit 7838c8
swap bytes fetched from the input file.
Packit 7838c8
.TP
Packit 7838c8
.B \-L
Packit 7838c8
input data has LSB2MSB bit order (default).
Packit 7838c8
.TP
Packit 7838c8
.B \-M
Packit 7838c8
input data has MSB2LSB bit order.
Packit 7838c8
.TP
Packit 7838c8
.B \-c
Packit 7838c8
Specify a compression scheme to use when writing image data:
Packit 7838c8
.B "\-c none"
Packit 7838c8
for no compression,
Packit 7838c8
.B "\-c packbits"
Packit 7838c8
for the PackBits compression algorithm (the default),
Packit 7838c8
.B "\-c jpeg"
Packit 7838c8
for the baseline JPEG compression algorithm,
Packit 7838c8
.B "\-c zip"
Packit 7838c8
for the Deflate compression algorithm,
Packit 7838c8
and
Packit 7838c8
.B "\-c lzw"
Packit 7838c8
for Lempel-Ziv & Welch.
Packit 7838c8
.TP
Packit 7838c8
.BI \-r " number"
Packit 7838c8
Write data with a specified number of rows per strip;
Packit 7838c8
by default the number of rows/strip is selected so that each strip
Packit 7838c8
is approximately 8 kilobytes.
Packit 7838c8
.SH GUESSING THE IMAGE GEOMETRY
Packit 7838c8
.I raw2tiff
Packit 7838c8
can guess image width and height in case one or both of these parameters are
Packit 7838c8
not specified. If you omit one of those parameters, the complementary one will
Packit 7838c8
be calculated based on the file size (taking into account header size, number
Packit 7838c8
of bands and data type). If you omit both parameters, the statistical approach
Packit 7838c8
will be used. Utility will compute correlation coefficient between two lines
Packit 7838c8
at the image center using several appropriate line sizes and the highest
Packit 7838c8
absolute value of the coefficient will indicate the right line size. That is
Packit 7838c8
why you should be cautious with the very large images, because guessing
Packit 7838c8
process may take a while (depending on your system performance). Of course, the
Packit 7838c8
utility can't guess the header size, number of bands and data type, so it
Packit 7838c8
should be specified manually. If you don't know anything about your image,
Packit 7838c8
just try with the several combinations of those options.
Packit 7838c8
.P
Packit 7838c8
There is no magic, it is just a mathematical statistics, so it can be wrong
Packit 7838c8
in some cases. But for most ordinary images guessing method will work fine.
Packit 7838c8
.SH "SEE ALSO"
Packit 7838c8
.BR pal2rgb (1),
Packit 7838c8
.BR tiffinfo (1),
Packit 7838c8
.BR tiffcp (1),
Packit 7838c8
.BR tiffmedian (1),
Packit 7838c8
.BR libtiff (3)
Packit 7838c8
.PP
Packit 7838c8
Libtiff library home page:
Packit 7838c8
.BR http://www.simplesystems.org/libtiff/