TIFFBUFFER(3tiff) LibTIFF TIFFBUFFER(3tiff)
NAME
TIFFbuffer - I/O buffering control routines
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
buffers used by the library. Applications need never use these
routines; they 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
compression.
TIFFReadBufferSetup() sets up the data buffer used to read raw
(encoded) data from a file. If the specified pointer is NULL (zero),
then a buffer 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
kilobytes, 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
successful 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(3)
AUTHOR
LibTIFF contributors
COPYRIGHT
1988-2022, LibTIFF contributors
4.6 October 9, 2023 TIFFBUFFER(3tiff)
tiff 4.6.0 - Generated Sun Oct 15 06:04:29 CDT 2023