TIFFBUFFER(3TIFF)                                            TIFFBUFFER(3TIFF)



NAME
       TIFFReadBufferSetup, TIFFWriteBufferSetup - 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(3TIFF)

       Libtiff library home page: http://www.remotesensing.org/libtiff/



libtiff                        November 1, 2005              TIFFBUFFER(3TIFF)
