TIFFReadEncodedTile(3TIFF) TIFFReadEncodedTile(3TIFF)
NAME
TIFFReadEncodedTile - read and decode a tile of data from an open TIFF
file
SYNOPSIS
#include <tiffio.h>
int TIFFReadEncodedTile(TIFF *tif, ttile_t tile, tdata_t buf, tsize_t
size)
DESCRIPTION
Read the specified tile of data and place up to size bytes of decom-
pressed information in the (user supplied) data buffer.
NOTES
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 ma-
chine 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
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(3TIFF) routine.
SEE ALSO
TIFFOpen(3TIFF), TIFFReadRawTile(3TIFF), TIFFReadTile(3TIFF),
libtiff(3TIFF)
Libtiff library home page: http://www.simplesystems.org/libtiff/
libtiff October 13, 2006 TIFFReadEncodedTile(3TIFF)
Generated by dwww version 1.14 on Mon Feb 3 08:33:52 CET 2025.