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

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

<title>TIFFReadTile</title>

TIFFReadTile

NAME

SYNOPSIS

DESCRIPTION

NOTES

RETURN VALUES

DIAGNOSTICS

SEE ALSO

NAME

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

TIFFReadTile − read and decode a tile of data from

an open <small>TIFF</small> file

SYNOPSIS

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

#include <tiffio.h>

tsize_t TIFFReadTile(TIFF *tif,

tdata_t buf, uint32 x,

uint32 y, uint32 z,

tsample_t sample)

DESCRIPTION

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

Return the data for the tile containing the

specified coordinates. The data placed in buf are

returned decompressed and, typically, in the native byte-

and bit-ordering, but are otherwise packed (see further

below). The buffer must be large enough to hold an entire

tile of data. Applications should call the routine

TIFFTileSize to find out the size (in bytes) of a

tile buffer. The x and y parameters are always

used by TIFFReadTile. The z parameter is used

if the image is deeper than 1 slice

(ImageDepth>1). The sample parameter is

used only if data are organized in separate planes

(PlanarConfiguration=2).

NOTES

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

The library attempts to hide bit- and byte-ordering

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">

TIFFReadTile returns −1 if it detects an

error; otherwise the number of bytes in the decoded tile is

returned.

DIAGNOSTICS

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

All error messages are directed to the

TIFFError(3TIFF) routine.

SEE ALSO

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

TIFFCheckTile(3TIFF),

TIFFComputeTile(3TIFF), TIFFOpen(3TIFF),

TIFFReadEncodedTile(3TIFF),

TIFFReadRawTile(3TIFF), libtiff(3TIFF)

Libtiff library home page:

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