|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<html>
|
|
Packit |
85355f |
<head>
|
|
Packit |
85355f |
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
Packit |
85355f |
<meta name="Content-Style" content="text/css">
|
|
Packit |
85355f |
<title>TIFFReadEncodedStrip</title>
|
|
Packit |
85355f |
</head>
|
|
Packit |
85355f |
<body>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
TIFFReadEncodedStrip
|
|
Packit |
85355f |
NAME
|
|
Packit |
85355f |
SYNOPSIS
|
|
Packit |
85355f |
DESCRIPTION
|
|
Packit |
85355f |
NOTES
|
|
Packit |
85355f |
RETURN VALUES
|
|
Packit |
85355f |
DIAGNOSTICS
|
|
Packit |
85355f |
SEE ALSO
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
NAME
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>TIFFReadEncodedStrip − read and decode a strip
|
|
Packit |
85355f |
of data from an open</big> TIFF <big>file</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
SYNOPSIS
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>#include <tiffio.h></big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>tsize_t TIFFReadEncodedStrip(TIFF
|
|
Packit |
85355f |
*tif, tstrip_t strip,
|
|
Packit |
85355f |
tdata_t buf, tsize_t
|
|
Packit |
85355f |
size)</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
DESCRIPTION
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>Read the specified strip of data and place up to
|
|
Packit |
85355f |
size bytes of decompressed information in the (user
|
|
Packit |
85355f |
supplied) data buffer.</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
NOTES
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>The value of strip is a ‘‘raw
|
|
Packit |
85355f |
strip number.’’ That is, the caller must take
|
|
Packit |
85355f |
into account whether or not the data are organized in
|
|
Packit |
85355f |
separate planes (PlanarConfiguration=2). To read a
|
|
Packit |
85355f |
full strip of data the data buffer should typically be at
|
|
Packit |
85355f |
least as large as the number returned by
|
|
Packit |
85355f |
TIFFStripSize(3TIFF). If the -1 passed in size
|
|
Packit |
85355f |
parameter, the whole strip will be read. You should be sure
|
|
Packit |
85355f |
you have enough space allocated for the buffer.</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>The library attempts to hide bit- and byte-ordering
|
|
Packit |
85355f |
differences between the image and the native machine by
|
|
Packit |
85355f |
converting data to the native machine order. Bit reversal is
|
|
Packit |
85355f |
done if the FillOrder tag is opposite to the native
|
|
Packit |
85355f |
machine bit order. 16- and 32-bit samples are automatically
|
|
Packit |
85355f |
byte-swapped if the file was written with a byte order
|
|
Packit |
85355f |
opposite to the native machine byte order,</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
RETURN VALUES
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>The actual number of bytes of data that were placed
|
|
Packit |
85355f |
in buf is returned; TIFFReadEncodedStrip
|
|
Packit |
85355f |
returns −1 if an error was encountered.</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
DIAGNOSTICS
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>All error messages are directed to the
|
|
Packit |
85355f |
TIFFError(3TIFF) routine.</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
SEE ALSO
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>TIFFOpen(3TIFF),
|
|
Packit |
85355f |
TIFFReadRawStrip(3TIFF),
|
|
Packit |
85355f |
TIFFReadScanline(3TIFF),
|
|
Packit |
85355f |
libtiff(3TIFF)</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
<big>Libtiff library home page:
|
|
Packit |
85355f |
http://www.simplesystems.org/libtiff/</big>
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
|
|
Packit |
85355f |
</body>
|
|
Packit |
85355f |
</html>
|