|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
<html>
|
|
Packit |
994f1a |
<head>
|
|
Packit |
994f1a |
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
Packit |
994f1a |
<meta name="Content-Style" content="text/css">
|
|
Packit |
994f1a |
<title>TIFFReadEncodedTile</title>
|
|
Packit |
994f1a |
</head>
|
|
Packit |
994f1a |
<body>
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
TIFFReadEncodedTile
|
|
Packit |
994f1a |
NAME
|
|
Packit |
994f1a |
SYNOPSIS
|
|
Packit |
994f1a |
DESCRIPTION
|
|
Packit |
994f1a |
NOTES
|
|
Packit |
994f1a |
RETURN VALUES
|
|
Packit |
994f1a |
DIAGNOSTICS
|
|
Packit |
994f1a |
SEE ALSO
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
NAME
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
TIFFReadEncodedTile − read and decode a tile of
|
|
Packit |
994f1a |
data from an open <small>TIFF</small> file
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
SYNOPSIS
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
#include <tiffio.h>
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
int TIFFReadEncodedTile(TIFF *tif,
|
|
Packit |
994f1a |
ttile_t tile, tdata_t buf,
|
|
Packit |
994f1a |
tsize_t size)
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
DESCRIPTION
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
Read the specified tile of data and place up to
|
|
Packit |
994f1a |
size bytes of decompressed information in the (user
|
|
Packit |
994f1a |
supplied) data buffer.
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
NOTES
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
The value of tile is a ‘‘raw tile
|
|
Packit |
994f1a |
number.’’ That is, the caller must take into
|
|
Packit |
994f1a |
account whether or not the data are organized in separate
|
|
Packit |
994f1a |
planes (PlanarConfiguration=2).
|
|
Packit |
994f1a |
TIFFComputeTile automatically does this when
|
|
Packit |
994f1a |
converting an (x,y,z,sample) coordinate quadruple to a tile
|
|
Packit |
994f1a |
number. To read a full tile of data the data buffer should
|
|
Packit |
994f1a |
be at least as large as the value returned by
|
|
Packit |
994f1a |
TIFFTileSize.
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
The library attempts to hide bit- and byte-ordering
|
|
Packit |
994f1a |
differences between the image and the native machine by
|
|
Packit |
994f1a |
converting data to the native machine order. Bit reversal is
|
|
Packit |
994f1a |
done if the FillOrder tag is opposite to the native
|
|
Packit |
994f1a |
machine bit order. 16- and 32-bit samples are automatically
|
|
Packit |
994f1a |
byte-swapped if the file was written with a byte order
|
|
Packit |
994f1a |
opposite to the native machine byte order,
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
RETURN VALUES
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
The actual number of bytes of data that were placed in
|
|
Packit |
994f1a |
buf is returned; TIFFReadEncodedTile returns
|
|
Packit |
994f1a |
−1 if an error was encountered.
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
DIAGNOSTICS
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
All error messages are directed to the
|
|
Packit |
994f1a |
TIFFError(3TIFF) routine.
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
SEE ALSO
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
TIFFOpen(3TIFF), TIFFReadRawTile(3TIFF),
|
|
Packit |
994f1a |
TIFFReadTile(3TIFF), libtiff(3TIFF)
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
Libtiff library home page:
|
|
Packit |
994f1a |
http://www.remotesensing.org/libtiff/
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
</body>
|
|
Packit |
994f1a |
</html>
|