1TIFFBUFFER(3TIFF)                                            TIFFBUFFER(3TIFF)
2
3
4

NAME

6       TIFFReadBufferSetup,  TIFFWriteBufferSetup - I/O buffering control rou‐
7       tines
8

SYNOPSIS

10       #include <tiffio.h>
11
12       int TIFFReadBufferSetup(TIFF *tif, tdata_t buffer, tsize_t size);
13       int TIFFWriteBufferSetup(TIFF *tif, tdata_t buffer, tsize_t size);
14

DESCRIPTION

16       The following routines are provided for client-control of the I/O  buf‐
17       fers  used  by the library. Applications need never use these routines;
18       they are provided only for ``intelligent clients'' that wish  to  opti‐
19       mize  memory  usage and/or eliminate potential copy operations that can
20       occur when working with images that have data stored  without  compres‐
21       sion.
22
23       TIFFReadBufferSetup  sets up the data buffer used to read raw (encoded)
24       data from a file. If the specified pointer is NULL (zero), then a  buf‐
25       fer  of  the  appropriate  size is allocated. Otherwise the caller must
26       guarantee that the buffer is large enough to hold any individual  strip
27       of raw data.  TIFFReadBufferSetup returns a non-zero value if the setup
28       was successful and zero otherwise.
29
30       TIFFWriteBufferSetup  sets  up  the  data  buffer  used  to  write  raw
31       (encoded)  data  to a file. If the specified size is -1 then the buffer
32       size is selected to hold a complete tile or strip, or at least 8  kilo‐
33       bytes,  whichever  is  greater. If the specified buffer is NULL (zero),
34       then a  buffer  of  the  appropriate  size  is  dynamically  allocated.
35       TIFFWriteBufferSetup returns a non-zero value if the setup was success‐
36       ful and zero otherwise.
37

DIAGNOSTICS

39       %s: No space for data buffer at scanline %ld.  TIFFReadBufferSetup  was
40       unable to dynamically allocate space for a data buffer.
41
42       %s:  No  space  for  output buffer.  TIFFWriteBufferSetup was unable to
43       dynamically allocate space for a data buffer.
44

SEE ALSO

46       libtiff(3TIFF)
47
48       Libtiff library home page: http://www.simplesystems.org/libtiff/
49
50
51
52libtiff                        November 1, 2005              TIFFBUFFER(3TIFF)
Impressum