<meta content="groff -Thtml, see www.gnu.org" name="generator">

<meta content="text/css" name="Content-Style">

<title>TIFFReadEncodedStrip</title>

TIFFReadEncodedStrip

NAME

SYNOPSIS

DESCRIPTION

NOTES

RETURN VALUES

DIAGNOSTICS

SEE ALSO

NAME

       cols="2" cellspacing="0" cellpadding="0">

<big>TIFFReadEncodedStrip − read and decode a strip</big>

of data from an open TIFF <big>file</big>

SYNOPSIS

       cols="2" cellspacing="0" cellpadding="0">

<big>#include <tiffio.h></big>

<big>tsize_t TIFFReadEncodedStrip(TIFF</big>

*tif, tstrip_t strip,

tdata_t buf, tsize_t

size)

DESCRIPTION

       cols="2" cellspacing="0" cellpadding="0">

<big>Read the specified strip of data and place up to</big>

size bytes of decompressed information in the (user

supplied) data buffer.

NOTES

       cols="2" cellspacing="0" cellpadding="0">

<big>The value of strip is a ‘‘raw</big>

strip number.’’ That is, the caller must take

into account whether or not the data are organized in

separate planes (PlanarConfiguration=2). To read a

full strip of data the data buffer should typically be at

least as large as the number returned by

TIFFStripSize(3TIFF). If the -1 passed in size

parameter, the whole strip will be read. You should be sure

you have enough space allocated for the buffer.

<big>The library attempts to hide bit- and byte-ordering</big>

differences between the image and the native machine by

converting data to the native machine order. Bit reversal is

done if the FillOrder tag is opposite to the native

machine bit order. 16- and 32-bit samples are automatically

byte-swapped if the file was written with a byte order

opposite to the native machine byte order,

RETURN VALUES

       cols="2" cellspacing="0" cellpadding="0">

<big>The actual number of bytes of data that were placed</big>

in buf is returned; TIFFReadEncodedStrip

returns −1 if an error was encountered.

DIAGNOSTICS

       cols="2" cellspacing="0" cellpadding="0">

<big>All error messages are directed to the</big>

TIFFError(3TIFF) routine.

SEE ALSO

       cols="2" cellspacing="0" cellpadding="0">

<big>TIFFOpen(3TIFF),</big>

TIFFReadRawStrip(3TIFF),

TIFFReadScanline(3TIFF),

libtiff(3TIFF)

<big>Libtiff library home page:</big>

http://www.remotesensing.org/libtiff/