NAME¶
TIFFWriteTile - encode and write a tile of data to an open
TIFF
file
SYNOPSIS¶
#include <tiffio.h>
tsize_t TIFFWriteTile(TIFF *tif, tdata_t buf,
uint32 x, uint32 y, uint32 z,
tsample_t sample)
DESCRIPTION¶
Write the data for the tile
containing the specified coordinates. The
data in
buf are is (potentially) compressed, and written to the
indicated file, normally being appended to the end of the file. The buffer
must be contain an entire tile of data. Applications should call the routine
TIFFTileSize to find out the size (in bytes) of a tile buffer. The
x and
y parameters are always used by
TIFFWriteTile. The
z parameter is used if the image is deeper than 1 slice
(
ImageDepth>1). The
sample parameter is used only if data are
organized in separate planes (
PlanarConfiguration=2).
RETURN VALUES¶
TIFFWriteTile returns -1 if it detects an error; otherwise the number of
bytes in the tile is returned.
DIAGNOSTICS¶
All error messages are directed to the
TIFFError(3TIFF) routine.
SEE ALSO¶
TIFFCheckTile(3TIFF),
TIFFComputeTile(3TIFF),
TIFFOpen(3TIFF),
TIFFReadTile(3TIFF),
TIFFWriteScanline(3TIFF),
TIFFWriteEncodedTile(3TIFF),
TIFFWriteRawTile(3TIFF),
libtiff(3TIFF)
Libtiff library home page:
http://www.remotesensing.org/libtiff/