diff -r 000000000000 -r 1918ee327afb src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html Mon Jan 11 14:00:40 2010 +0000 @@ -0,0 +1,130 @@ + + + + + + +TIFFReadEncodedTile + + + +

TIFFReadEncodedTile

+NAME
+SYNOPSIS
+DESCRIPTION
+NOTES
+RETURN VALUES
+DIAGNOSTICS
+SEE ALSO
+ +

+ +

NAME

+ + + + + +

TIFFReadEncodedTile − read and decode a tile of +data from an open TIFF file

+ +

SYNOPSIS

+ + + + + +

#include <tiffio.h>

+ +

int TIFFReadEncodedTile(TIFF *tif, +u_long tile, u_char *buf, +u_long size)

+ +

DESCRIPTION

+ + + + + +

Read the specified tile of data and place up to +size bytes of decompressed 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 machine 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.

+ +