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

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

<title>TIFFReadEncodedTile</title>

TIFFReadEncodedTile

NAME

SYNOPSIS

DESCRIPTION

NOTES

RETURN VALUES

DIAGNOSTICS

SEE ALSO

NAME

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

TIFFReadEncodedTile − read and decode a tile of

data from an open <small>TIFF</small> file

SYNOPSIS

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

#include <tiffio.h>

int TIFFReadEncodedTile(TIFF *tif,

ttile_t tile, tdata_t buf,

tsize_t size)

DESCRIPTION

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

Read the specified tile of data and place up to

size bytes of decompressed information in the (user

supplied) data buffer.

NOTES

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

The value of tile is a ‘‘raw tile

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

account whether or not the data are organized in separate

planes (PlanarConfiguration=2).

TIFFComputeTile automatically does this when

converting an (x,y,z,sample) coordinate quadruple to a tile

number. To read a full tile of data the data buffer should

be at least as large as the value returned by

TIFFTileSize.

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

The actual number of bytes of data that were placed in

buf is returned; TIFFReadEncodedTile returns

−1 if an error was encountered.

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

TIFFOpen(3TIFF), TIFFReadRawTile(3TIFF),

TIFFReadTile(3TIFF), libtiff(3TIFF)

Libtiff library home page:

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