|
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>TIFFReadTile</title>
|
|
Packit |
994f1a |
</head>
|
|
Packit |
994f1a |
<body>
|
|
Packit |
994f1a |
|
|
Packit |
994f1a |
TIFFReadTile
|
|
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 |
TIFFReadTile − read and decode a tile of data from
|
|
Packit |
994f1a |
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 |
tsize_t TIFFReadTile(TIFF *tif,
|
|
Packit |
994f1a |
tdata_t buf, uint32 x,
|
|
Packit |
994f1a |
uint32 y, uint32 z,
|
|
Packit |
994f1a |
tsample_t sample)
|
|
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 |
Return the data for the tile containing the
|
|
Packit |
994f1a |
specified coordinates. The data placed in buf are
|
|
Packit |
994f1a |
returned decompressed and, typically, in the native byte-
|
|
Packit |
994f1a |
and bit-ordering, but are otherwise packed (see further
|
|
Packit |
994f1a |
below). The buffer must be large enough to hold an entire
|
|
Packit |
994f1a |
tile of data. Applications should call the routine
|
|
Packit |
994f1a |
TIFFTileSize to find out the size (in bytes) of a
|
|
Packit |
994f1a |
tile buffer. The x and y parameters are always
|
|
Packit |
994f1a |
used by TIFFReadTile. The z parameter is used
|
|
Packit |
994f1a |
if the image is deeper than 1 slice
|
|
Packit |
994f1a |
(ImageDepth>1). The sample parameter is
|
|
Packit |
994f1a |
used only if data are organized in separate planes
|
|
Packit |
994f1a |
(PlanarConfiguration=2).
|
|
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 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 |
TIFFReadTile returns −1 if it detects an
|
|
Packit |
994f1a |
error; otherwise the number of bytes in the decoded tile is
|
|
Packit |
994f1a |
returned.
|
|
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 |
TIFFCheckTile(3TIFF),
|
|
Packit |
994f1a |
TIFFComputeTile(3TIFF), TIFFOpen(3TIFF),
|
|
Packit |
994f1a |
TIFFReadEncodedTile(3TIFF),
|
|
Packit |
994f1a |
TIFFReadRawTile(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>
|