TIFFBUFFER(3TIFF)                               TIFFBUFFER(3TIFF)



NAME
       TIFFReadBufferSetup,  TIFFWriteBufferSetup - I/O buffering
       control routines

SYNOPSIS
       #include 

       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.  TIFFWrite-
       BufferSetup returns a non-zero value if the setup was suc-
       cessful and zero otherwise.

DIAGNOSTICS
       %s:  No  space for data buffer at scanline %ld.  TIFFRead-
       BufferSetup 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                  October 15, 1995       TIFFBUFFER(3TIFF)