TIFFbuffer - tines
#include <tiffio.h> int TIFFReadBufferSetup(TIFF *tif, tdata_t buffer, tsize_t size); int TIFFWriteBufferSetup(TIFF *tif, tdata_t buffer, tsize_t size);
TIFFBUFFER(3TIFF) TIFFBUFFER(3TIFF)
NAME
TIFFReadBufferSetup, TIFFWriteBufferSetup - I/O buffering control rou-
tines
SYNOPSIS
#include <tiffio.h>
int TIFFReadBufferSetup(TIFF *tif, tdata_t buffer, tsize_t size);
int TIFFWriteBufferSetup(TIFF *tif, tdata_t buffer, tsize_t size);
DESCRIPTION
The following routines are provided for client-control of the I/O buf-
fers used by the library. Applications need never use these routines;
they are provided only for ``intelligent clients'' that wish to opti-
mize memory usage and/or eliminate potential copy operations that can
occur when working with images that have data stored without compres-
sion.
TIFFReadBufferSetup sets up the data buffer used to read raw (encoded)
data from a file. If the specified pointer is NULL (zero), then a buf-
fer of the appropriate size is allocated. Otherwise the caller must
guarantee that the buffer is large enough to hold any individual strip
of raw data. TIFFReadBufferSetup returns a non-zero value if the setup
was successful and zero otherwise.
TIFFWriteBufferSetup sets up the data buffer used to write raw
(encoded) data to a file. If the specified size is -1 then the buffer
size is selected to hold a complete tile or strip, or at least 8 kilo-
bytes, whichever is greater. If the specified buffer is NULL (zero),
then a buffer of the appropriate size is dynamically allocated.
TIFFWriteBufferSetup returns a non-zero value if the setup was success-
ful and zero otherwise.
DIAGNOSTICS
%s: No space for data buffer at scanline %ld. TIFFReadBufferSetup was
unable to dynamically allocate space for a data buffer.
%s: No space for output buffer. TIFFWriteBufferSetup was unable to
dynamically allocate space for a data buffer.
SEE ALSO
libtiff(3TIFF)
Libtiff library home page: http://www.simplesystems.org/libtiff/
libtiff November 1, 2005 TIFFBUFFER(3TIFF)