TIFFBUFFER(3T)    Image Format Library C++ Reference Manual     TIFFBUFFER(3T)



NAME
     TIFFReadBufferSetup, TIFFWriteBufferSetup - I/O buffering control
     routines

SYNOPSIS
     #include <tiffio.h>
     int TIFFReadBufferSetup(TIFF*, tdatat buffer, tsizet size);
     int TIFFWriteBufferSetup(TIFF*, tdatat buffer, tsizet 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(3T)















                                                                        Page 1