opensolaris man page for tiffreadbuffersetup

TIFFbuffer(3tiff)														 TIFFbuffer(3tiff)

NAME
       TIFFbuffer, TIFFReadBufferSetup, TIFFWriteBufferSetup - I/O buffering control routines

SYNOPSIS
       #include <tiffio.h>
       int TIFFReadBufferSetup(TIFF*, tdata_t buffer, tsize_t size);
       int TIFFWriteBufferSetup(TIFF*, tdata_t buffer, tsize_t size);

       The  following routines are provided for client-control of the I/O buffers used by the library. Applications need never use these routines.
       The routines 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.

       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.

   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 attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWTiff			   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

       libtiff(3)

       This man page was originally written by Sam Leffler. Updated by Breda McColgan, Sun Microsystems Inc., 2004.

								    01 Apr 2004 						 TIFFbuffer(3tiff)