TIFFReadRawTile(3T)MISC. REFERENCE MANUAL PAGETIFFReadRawTile(3T)

NAME
     TIFFReadRawTile - return an undecoded tile of data  from  an
     open TIFF file

SYNOPSIS
     #include <tiffio.h>
     tsize_t TIFFReadRawTile(TIFF*  tif,  ttile_t  tile,  tdata_t
     buf, tsize_t size)

DESCRIPTION
     Read the contents of the specified tile into the (user  sup-
     plied)  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 qua-
     druple 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
     The actual number of bytes of data that were placed  in  buf
     is  returned; TIFFReadEncodedTile returns -1 if an error was
     encountered.

DIAGNOSTICS
     All error messages are directed to  the  TIFFError(3T)  rou-
     tine.

SEE ALSO
     intro(3T),      TIFFOpen(3T),       TIFFReadEncodedTile(3T),
     TIFFReadTile(3T)

Sun Release 4.1  Last change: December 16, 1991                 1