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/