Manual Reference Pages  - TIFFBUFFER (3T)

NAME

TIFFReadBufferSetup, TIFFWriteBufferSetup - I/O buffering control routines

CONTENTS

Synopsis
Description
Diagnostics

SYNOPSIS


#include <tiffio.h> 

int TIFFReadBufferSetup(TIFF*, tdata_t buffer, tsize_t size); 

int TIFFWriteBufferSetup(TIFF*, 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(3T)
Jump to page    or go to Top of page |  Section 3T |  Main Index.


TIFFBUFFER (3T) October 15, 1995
Generated by manServer 1.07 from /usr/share/man/man3/../man3/TIFFbuffer.3t.gz using man macros.