1<!-- Creator : groff version 1.18.1 --> 2<!-- CreationDate: Sat Feb 24 18:37:15 2007 --> 3<html> 4<head> 5<meta name="generator" content="groff -Thtml, see www.gnu.org"> 6<meta name="Content-Style" content="text/css"> 7<title>TIFFBUFFER</title> 8</head> 9<body> 10 11<h1 align=center>TIFFBUFFER</h1> 12<a href="#NAME">NAME</a><br> 13<a href="#SYNOPSIS">SYNOPSIS</a><br> 14<a href="#DESCRIPTION">DESCRIPTION</a><br> 15<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> 16<a href="#SEE ALSO">SEE ALSO</a><br> 17 18<hr> 19<a name="NAME"></a> 20<h2>NAME</h2> 21<!-- INDENTATION --> 22<table width="100%" border=0 rules="none" frame="void" 23 cols="2" cellspacing="0" cellpadding="0"> 24<tr valign="top" align="left"> 25<td width="8%"></td> 26<td width="91%"> 27<p>TIFFReadBufferSetup, TIFFWriteBufferSetup − I/O 28buffering control routines</p> 29</td> 30</table> 31<a name="SYNOPSIS"></a> 32<h2>SYNOPSIS</h2> 33<!-- INDENTATION --> 34<table width="100%" border=0 rules="none" frame="void" 35 cols="2" cellspacing="0" cellpadding="0"> 36<tr valign="top" align="left"> 37<td width="8%"></td> 38<td width="91%"> 39<pre><b>#include <tiffio.h> 40 41int TIFFReadBufferSetup(TIFF *</b><i>tif</i><b>, tdata_t</b> <i>buffer</i><b>, tsize_t</b> <i>size</i><b>); 42int TIFFWriteBufferSetup(TIFF *</b><i>tif</i><b>, tdata_t</b> <i>buffer</i><b>, tsize_t</b> <i>size</i><b>); 43</b></pre> 44</td> 45</table> 46<a name="DESCRIPTION"></a> 47<h2>DESCRIPTION</h2> 48<!-- INDENTATION --> 49 50<table width="100%" border=0 rules="none" frame="void" 51 cols="2" cellspacing="0" cellpadding="0"> 52<tr valign="top" align="left"> 53<td width="8%"></td> 54<td width="91%"> 55<p>The following routines are provided for client-control of 56the I/O buffers used by the library. Applications need never 57use these routines; they are provided only for 58‘‘intelligent clients’’ that wish to 59optimize memory usage and/or eliminate potential copy 60operations that can occur when working with images that have 61data stored without compression.</p> 62<!-- INDENTATION --> 63<p><i>TIFFReadBufferSetup</i> sets up the data buffer used 64to read raw (encoded) data from a file. If the specified 65pointer is <small>NULL</small> (zero), then a buffer of the 66appropriate size is allocated. Otherwise the caller must 67guarantee that the buffer is large enough to hold any 68individual strip of raw data. <i>TIFFReadBufferSetup</i> 69returns a non-zero value if the setup was successful and 70zero otherwise.</p> 71<!-- INDENTATION --> 72<p><i>TIFFWriteBufferSetup</i> sets up the data buffer used 73to write raw (encoded) data to a file. If the specified 74<i>size</i> is −1 then the buffer size is selected to 75hold a complete tile or strip, or at least 8 kilobytes, 76whichever is greater. If the specified <i>buffer</i> is 77<small>NULL</small> (zero), then a buffer of the appropriate 78size is dynamically allocated. <i>TIFFWriteBufferSetup</i> 79returns a non-zero value if the setup was successful and 80zero otherwise.</p> 81</td> 82</table> 83<a name="DIAGNOSTICS"></a> 84<h2>DIAGNOSTICS</h2> 85<!-- INDENTATION --> 86<table width="100%" border=0 rules="none" frame="void" 87 cols="2" cellspacing="0" cellpadding="0"> 88<tr valign="top" align="left"> 89<td width="8%"></td> 90<td width="91%"> 91<p><b>%s: No space for data buffer at scanline %ld</b>. 92<i>TIFFReadBufferSetup</i> was unable to dynamically 93allocate space for a data buffer.</p> 94<!-- INDENTATION --> 95<p><b>%s: No space for output buffer</b>. 96<i>TIFFWriteBufferSetup</i> was unable to dynamically 97allocate space for a data buffer.</p> 98</td> 99</table> 100<a name="SEE ALSO"></a> 101<h2>SEE ALSO</h2> 102<!-- INDENTATION --> 103<table width="100%" border=0 rules="none" frame="void" 104 cols="2" cellspacing="0" cellpadding="0"> 105<tr valign="top" align="left"> 106<td width="8%"></td> 107<td width="91%"> 108<p><b>libtiff</b>(3TIFF)</p> 109<!-- INDENTATION --> 110<p>Libtiff library home page: 111<b>http://www.simplesystems.org/libtiff/</b></p> 112</td> 113</table> 114<hr> 115</body> 116</html> 117