TIFFReadRawTile(3T)      UNIX System V(June 18, 1991)       TIFFReadRawTile(3T)


NAME
      TIFFReadRawTile - return the undecoded contents of a tile from an open
      TIFF file

SYNOPSIS
      #include <tiffio.h>
      int TIFFReadRawTile(TIFF* tif, uint tile, uchar* buf, uint size)

DESCRIPTION
      Return the contents of the specified tile of data into the (user
      supplied) data buffer.  The actual number of bytes of data that were
      placed in buf is returned; TIFFReadEncodedTile() returns -1 if an error
      was encountered.  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 as large as the value returned by TIFFTileSize().

DIAGNOSTICS
      All error messages are directed to the TIFFError(3T) routine.

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






























10/89                                                                    Page 1