10dcb9ef1SAndrey Kiselev<!-- Creator : groff version 1.18.1 --> 2f14d1a56SAndrey Kiselev<!-- CreationDate: Sat Feb 24 18:37:17 2007 --> 387c5da6fSAndrey Kiselev<html> 487c5da6fSAndrey Kiselev<head> 587c5da6fSAndrey Kiselev<meta name="generator" content="groff -Thtml, see www.gnu.org"> 687c5da6fSAndrey Kiselev<meta name="Content-Style" content="text/css"> 787c5da6fSAndrey Kiselev<title>TIFFReadTile</title> 887c5da6fSAndrey Kiselev</head> 987c5da6fSAndrey Kiselev<body> 1087c5da6fSAndrey Kiselev 1187c5da6fSAndrey Kiselev<h1 align=center>TIFFReadTile</h1> 1287c5da6fSAndrey Kiselev<a href="#NAME">NAME</a><br> 1387c5da6fSAndrey Kiselev<a href="#SYNOPSIS">SYNOPSIS</a><br> 1487c5da6fSAndrey Kiselev<a href="#DESCRIPTION">DESCRIPTION</a><br> 1587c5da6fSAndrey Kiselev<a href="#NOTES">NOTES</a><br> 1687c5da6fSAndrey Kiselev<a href="#RETURN VALUES">RETURN VALUES</a><br> 1787c5da6fSAndrey Kiselev<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> 1887c5da6fSAndrey Kiselev<a href="#SEE ALSO">SEE ALSO</a><br> 1987c5da6fSAndrey Kiselev 2087c5da6fSAndrey Kiselev<hr> 2187c5da6fSAndrey Kiselev<a name="NAME"></a> 2287c5da6fSAndrey Kiselev<h2>NAME</h2> 230dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 240dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 250dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 260dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 270dcb9ef1SAndrey Kiselev<td width="8%"></td> 280dcb9ef1SAndrey Kiselev<td width="91%"> 290dcb9ef1SAndrey Kiselev<p>TIFFReadTile − read and decode a tile of data from 300dcb9ef1SAndrey Kiselevan open <small>TIFF</small> file</p> 310dcb9ef1SAndrey Kiselev</td> 320dcb9ef1SAndrey Kiselev</table> 3387c5da6fSAndrey Kiselev<a name="SYNOPSIS"></a> 3487c5da6fSAndrey Kiselev<h2>SYNOPSIS</h2> 350dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 360dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 370dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 380dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 390dcb9ef1SAndrey Kiselev<td width="8%"></td> 400dcb9ef1SAndrey Kiselev<td width="91%"> 410dcb9ef1SAndrey Kiselev<p><b>#include <tiffio.h></b></p> 420dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 430dcb9ef1SAndrey Kiselev<p><b>tsize_t TIFFReadTile(TIFF *</b><i>tif</i><b>, 440dcb9ef1SAndrey Kiselevtdata_t</b> <i>buf</i><b>, uint32</b> <i>x</i><b>, 450dcb9ef1SAndrey Kiselevuint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, 460dcb9ef1SAndrey Kiselevtsample_t</b> <i>sample</i><b>)</b></p> 470dcb9ef1SAndrey Kiselev</td> 480dcb9ef1SAndrey Kiselev</table> 4987c5da6fSAndrey Kiselev<a name="DESCRIPTION"></a> 5087c5da6fSAndrey Kiselev<h2>DESCRIPTION</h2> 510dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 520dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 530dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 540dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 550dcb9ef1SAndrey Kiselev<td width="8%"></td> 560dcb9ef1SAndrey Kiselev<td width="91%"> 570dcb9ef1SAndrey Kiselev<p>Return the data for the tile <i>containing</i> the 580dcb9ef1SAndrey Kiselevspecified coordinates. The data placed in <i>buf</i> are 590dcb9ef1SAndrey Kiselevreturned decompressed and, typically, in the native byte- 600dcb9ef1SAndrey Kiselevand bit-ordering, but are otherwise packed (see further 610dcb9ef1SAndrey Kiselevbelow). The buffer must be large enough to hold an entire 620dcb9ef1SAndrey Kiselevtile of data. Applications should call the routine 630dcb9ef1SAndrey Kiselev<i>TIFFTileSize</i> to find out the size (in bytes) of a 640dcb9ef1SAndrey Kiselevtile buffer. The <i>x</i> and <i>y</i> parameters are always 650dcb9ef1SAndrey Kiselevused by <i>TIFFReadTile</i>. The <i>z</i> parameter is used 660dcb9ef1SAndrey Kiselevif the image is deeper than 1 slice 670dcb9ef1SAndrey Kiselev(<i>ImageDepth</i>>1). The <i>sample</i> parameter is 680dcb9ef1SAndrey Kiselevused only if data are organized in separate planes 6987c5da6fSAndrey Kiselev(<i>PlanarConfiguration</i>=2).</p> 700dcb9ef1SAndrey Kiselev</td> 710dcb9ef1SAndrey Kiselev</table> 7287c5da6fSAndrey Kiselev<a name="NOTES"></a> 7387c5da6fSAndrey Kiselev<h2>NOTES</h2> 740dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 750dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 760dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 770dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 780dcb9ef1SAndrey Kiselev<td width="8%"></td> 790dcb9ef1SAndrey Kiselev<td width="91%"> 800dcb9ef1SAndrey Kiselev<p>The library attempts to hide bit- and byte-ordering 810dcb9ef1SAndrey Kiselevdifferences between the image and the native machine by 820dcb9ef1SAndrey Kiselevconverting data to the native machine order. Bit reversal is 830dcb9ef1SAndrey Kiselevdone if the <i>FillOrder</i> tag is opposite to the native 840dcb9ef1SAndrey Kiselevmachine bit order. 16- and 32-bit samples are automatically 850dcb9ef1SAndrey Kiselevbyte-swapped if the file was written with a byte order 860dcb9ef1SAndrey Kiselevopposite to the native machine byte order,</p> 870dcb9ef1SAndrey Kiselev</td> 880dcb9ef1SAndrey Kiselev</table> 8987c5da6fSAndrey Kiselev<a name="RETURN VALUES"></a> 9087c5da6fSAndrey Kiselev<h2>RETURN VALUES</h2> 910dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 920dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 930dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 940dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 950dcb9ef1SAndrey Kiselev<td width="8%"></td> 960dcb9ef1SAndrey Kiselev<td width="91%"> 970dcb9ef1SAndrey Kiselev<p><i>TIFFReadTile</i> returns −1 if it detects an 980dcb9ef1SAndrey Kiseleverror; otherwise the number of bytes in the decoded tile is 990dcb9ef1SAndrey Kiselevreturned.</p> 1000dcb9ef1SAndrey Kiselev</td> 1010dcb9ef1SAndrey Kiselev</table> 10287c5da6fSAndrey Kiselev<a name="DIAGNOSTICS"></a> 10387c5da6fSAndrey Kiselev<h2>DIAGNOSTICS</h2> 1040dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 1050dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 1060dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 1070dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 1080dcb9ef1SAndrey Kiselev<td width="8%"></td> 1090dcb9ef1SAndrey Kiselev<td width="91%"> 1100dcb9ef1SAndrey Kiselev<p>All error messages are directed to the 1110dcb9ef1SAndrey Kiselev<b>TIFFError</b>(3TIFF) routine.</p> 1120dcb9ef1SAndrey Kiselev</td> 1130dcb9ef1SAndrey Kiselev</table> 11487c5da6fSAndrey Kiselev<a name="SEE ALSO"></a> 11587c5da6fSAndrey Kiselev<h2>SEE ALSO</h2> 1160dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 1170dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 1180dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 1190dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 1200dcb9ef1SAndrey Kiselev<td width="8%"></td> 1210dcb9ef1SAndrey Kiselev<td width="91%"> 1220dcb9ef1SAndrey Kiselev<p><b>TIFFCheckTile</b>(3TIFF), 1230776b32dSAndrey Kiselev<b>TIFFComputeTile</b>(3TIFF), <b>TIFFOpen</b>(3TIFF), 1240776b32dSAndrey Kiselev<b>TIFFReadEncodedTile</b>(3TIFF), 1250776b32dSAndrey Kiselev<b>TIFFReadRawTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> 1260dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 1270dcb9ef1SAndrey Kiselev<p>Libtiff library home page: 128*d4dd6cccSBob Friesenhahn<b>http://www.simplesystems.org/libtiff/</b></p> 1290dcb9ef1SAndrey Kiselev</td> 1300dcb9ef1SAndrey Kiselev</table> 13187c5da6fSAndrey Kiselev<hr> 13287c5da6fSAndrey Kiselev</body> 13387c5da6fSAndrey Kiselev</html> 134