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

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

<title>TIFFReadRawTile</title>

TIFFReadRawTile

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUES

DIAGNOSTICS

SEE ALSO

NAME

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

TIFFReadRawTile − return an undecoded tile of data

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

SYNOPSIS

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

#include <tiffio.h>

tsize_t TIFFReadRawTile(TIFF *tif,

ttile_t tile, tdata_t buf,

tsize_t size)

DESCRIPTION

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

Read the contents of the specified tile into the (user

supplied) data buffer. Note that the value of tile is

a ‘‘raw tile number.’’ That is, the

caller must take into account whether or not the data is

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

typically be at least as large as the value returned by

TIFFTileSize.

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),

TIFFReadEncodedTile(3TIFF),

TIFFReadTile(3TIFF), TIFFTileSize(3TIFF),

libtiff(3TIFF)

Libtiff library home page:

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