diff -r 000000000000 -r 1918ee327afb src/3rdparty/libtiff/html/man/raw2tiff.1.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/3rdparty/libtiff/html/man/raw2tiff.1.html Mon Jan 11 14:00:40 2010 +0000 @@ -0,0 +1,553 @@ + + + + + + +RAW2TIFF + + + +

RAW2TIFF

+NAME
+SYNOPSIS
+DESCRIPTION
+OPTIONS
+GUESSING THE IMAGE GEOMETRY
+SEE ALSO
+ +
+ +

NAME

+ + + + + +
+

raw2tiff − create a TIFF file from a +raw data

+
+ +

SYNOPSIS

+ + + + + +
+

raw2tiff [ options ] input.raw +output.tif

+
+ +

DESCRIPTION

+ + + + + +
+

raw2tiff converts a raw byte sequence into +TIFF. By default, the TIFF +image is created with data samples packed +(PlanarConfiguration=1), compressed with the PackBits +algorithm (Compression=32773), and with each +strip no more than 8 kilobytes. These characteristics can +overridden, or explicitly specified with the options +described below.

+
+ +

OPTIONS

+ + + + + +
+

−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.

+
+ + + + + +
+

−w <number>

+ + + + + +
+

width of input image in pixels (can be guessed, see +GUESSING THE IMAGE GEOMETRY +below).

+
+ + + + + +
+

−l <number>

+ + + + + +
+

length of input image in lines(can be guessed, see +GUESSING THE IMAGE GEOMETRY +below).

+
+ + + + + +
+

−b <number>

+ + + + + +
+

number of bands in input image (1 by default).

+
+ + + + + +
+

−d data_type

+ + + + + +
+

type of samples in input image, where data_type +may be:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +

byte

+
+ + +

8-bit unsigned integer (default),

+
+
+ +

short

+
+ +

16-bit unsigned integer,

+
+
+ +

long

+
+ + +

32-bit unsigned integer,

+
+
+ +

sbyte

+
+ +

8-bit signed integer,

+
+
+ +

sshort

+
+ +

16-bit signed integer,

+
+
+ +

slong

+
+ +

32-bit signed integer,

+
+
+ +

float

+
+ +

32-bit IEEE floating point,

+
+
+ +

double

+
+ +

64-bit IEEE floating point,

+
+
+ + + + + +
+

−i config

+ + + + + +
+

type of samples interleaving in input image, where +config may be:

+ + + + + + + + + + + + + + +
+ +

pixel

+
+ +

pixel interleaved data (default),

+
+
+ +

band

+
+ + +

band interleaved data.

+
+
+ + + + + +
+

−p photo

+ + + + + +
+

photometric interpretation (color space) of the input +image, where photo may be:
+miniswhite
white color represented with 0 value,
+minisblack
black color represented with 0 value +(default),

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +

rgb

+
+ + +

image has RGB color model,

+
+
+ +

cmyk

+
+ + +

image has CMYK (separated) color model,

+
+
+ +

ycbcr

+
+ + +

image has YCbCr color model,

+
+
+ +

cielab

+
+ +

image has CIE L*a*b color model,

+
+
+ +

icclab

+
+ +

image has ICC L*a*b color model,

+
+
+ +

itulab

+
+ +

image has ITU L*a*b color model,

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +

−s

+
+ +

swap bytes fetched from the input file.

+
+
+ +

−L

+
+ +

input data has LSB2MSB bit order (default).

+
+
+ +

−M

+
+ +

input data has MSB2LSB bit order.

+
+
+ +

−c

+
+ +

Specify a compression scheme to use when writing image +data: −c none for no compression, -c +packbits for the PackBits compression algorithm (the +default), -c jpeg for the baseline JPEG compression +algorithm, -c zip for the Deflate compression +algorithm, and −c lzw for Lempel-Ziv & +Welch.

+
+
+ + + + + +
+

−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.

+
+ +

GUESSING THE IMAGE GEOMETRY

+ + + + + +
+

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.

+ +

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.

+
+ +

SEE ALSO

+ + + + + +
+

pal2rgb(1), tiffcp(1), +tiffmedian(1), libtiff(3)

+ +

Libtiff library home page: +http://www.remotesensing.org/libtiff/

+
+
+ +