1TIFFReadEncodedTile(3TIFF)                          TIFFReadEncodedTile(3TIFF)
2
3
4

NAME

6       TIFFReadEncodedTile  - read and decode a tile of data from an open TIFF
7       file
8

SYNOPSIS

10       #include <tiffio.h>
11
12       int TIFFReadEncodedTile(TIFF *tif, ttile_t tile, tdata_t  buf,  tsize_t
13       size)
14

DESCRIPTION

16       Read  the  specified  tile of data and place up to size bytes of decom‐
17       pressed information in the (user supplied) data buffer.
18

NOTES

20       The value of tile is a ``raw tile number.''  That is, the  caller  must
21       take  into  account  whether  or not the data are organized in separate
22       planes  (PlanarConfiguration=2).   TIFFComputeTile  automatically  does
23       this  when  converting an (x,y,z,sample) coordinate quadruple to a tile
24       number. To read a full tile of data the data buffer should be at  least
25       as large as the value returned by TIFFTileSize.
26
27       The library attempts to hide bit- and byte-ordering differences between
28       the image and the native machine  by  converting  data  to  the  native
29       machine  order.   Bit reversal is done if the FillOrder tag is opposite
30       to the native machine bit order. 16- and 32-bit samples  are  automati‐
31       cally  byte-swapped  if the file was written with a byte order opposite
32       to the native machine byte order,
33

RETURN VALUES

35       The actual number of bytes of data that were placed in buf is returned;
36       TIFFReadEncodedTile returns -1 if an error was encountered.
37

DIAGNOSTICS

39       All error messages are directed to the TIFFError(3TIFF) routine.
40

SEE ALSO

42       TIFFOpen(3TIFF),      TIFFReadRawTile(3TIFF),      TIFFReadTile(3TIFF),
43       libtiff(3TIFF)
44
45       Libtiff library home page: http://www.remotesensing.org/libtiff/
46
47
48
49libtiff                        October 13, 2006     TIFFReadEncodedTile(3TIFF)
Impressum