TIFFbuffer(3tiff)TIFFbuffer(3tiff)NAME
TIFFbuffer, TIFFReadBufferSetup, TIFFWriteBufferSetup - I/O buffering
control routines
SYNOPSIS
#include <tiffio.h>
int TIFFReadBufferSetup(TIFF*, tdata_t buffer, tsize_t size);
int TIFFWriteBufferSetup(TIFF*, tdata_t buffer, tsize_t size);
The following routines are provided for client-control of the I/O buf‐
fers used by the library. Applications need never use these routines.
The routines are provided only for "intelligent clients" that wish to
optimize memory usage and/or eliminate potential copy operations that
can occur when working with images that have data stored without com‐
pression.
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.
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.
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 attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │image/library/libtiff │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Uncommitted │
└─────────────────────────────┴─────────────────────────────┘
libtiff(3)
This man page was originally written by Sam Leffler. Updated by Breda
McColgan, Sun Microsystems Inc., 2004.
01 Apr 2004 TIFFbuffer(3tiff)