1 <!-- Creator : groff version 1.18.1 -->
2 <!-- CreationDate: Sat Feb 24 18:37:17 2007 -->
5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
6 <meta name="Content-Style" content="text/css">
7 <title>TIFFReadRawTile</title>
11 <h1 align=center>TIFFReadRawTile</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="#RETURN VALUES">RETURN VALUES</a><br>
16 <a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
17 <a href="#SEE ALSO">SEE ALSO</a><br>
23 <table width="100%" border=0 rules="none" frame="void"
24 cols="2" cellspacing="0" cellpadding="0">
25 <tr valign="top" align="left">
28 <p>TIFFReadRawTile − return an undecoded tile of data
29 from an open <small>TIFF</small> file</p>
32 <a name="SYNOPSIS"></a>
35 <table width="100%" border=0 rules="none" frame="void"
36 cols="2" cellspacing="0" cellpadding="0">
37 <tr valign="top" align="left">
40 <p><b>#include <tiffio.h></b></p>
42 <p><b>tsize_t TIFFReadRawTile(TIFF *</b><i>tif</i><b>,
43 ttile_t</b> <i>tile</i><b>, tdata_t</b> <i>buf</i><b>,
44 tsize_t</b> <i>size</i><b>)</b></p>
47 <a name="DESCRIPTION"></a>
50 <table width="100%" border=0 rules="none" frame="void"
51 cols="2" cellspacing="0" cellpadding="0">
52 <tr valign="top" align="left">
55 <p>Read the contents of the specified tile into the (user
56 supplied) data buffer. Note that the value of <i>tile</i> is
57 a ‘‘raw tile number.’’ That is, the
58 caller must take into account whether or not the data is
59 organized in separate planes (<i>PlanarConfiguration</i>=2).
60 <i>TIFFComputeTile</i> automatically does this when
61 converting an (x,y,z,sample) coordinate quadruple to a tile
62 number. To read a full tile of data the data buffer should
63 typically be at least as large as the value returned by
64 <i>TIFFTileSize</i>.</p>
67 <a name="RETURN VALUES"></a>
68 <h2>RETURN VALUES</h2>
70 <table width="100%" border=0 rules="none" frame="void"
71 cols="2" cellspacing="0" cellpadding="0">
72 <tr valign="top" align="left">
75 <p>The actual number of bytes of data that were placed in
76 <i>buf</i> is returned; <i>TIFFReadEncodedTile</i> returns
77 −1 if an error was encountered.</p>
80 <a name="DIAGNOSTICS"></a>
83 <table width="100%" border=0 rules="none" frame="void"
84 cols="2" cellspacing="0" cellpadding="0">
85 <tr valign="top" align="left">
88 <p>All error messages are directed to the
89 <b>TIFFError</b>(3TIFF) routine.</p>
92 <a name="SEE ALSO"></a>
95 <table width="100%" border=0 rules="none" frame="void"
96 cols="2" cellspacing="0" cellpadding="0">
97 <tr valign="top" align="left">
100 <p><b>TIFFOpen</b>(3TIFF),
101 <b>TIFFReadEncodedTile</b>(3TIFF),
102 <b>TIFFReadTile</b>(3TIFF), <b>TIFFTileSize</b>(3TIFF),
103 <b>libtiff</b>(3TIFF)</p>
105 <p>Libtiff library home page:
106 <b>http://www.remotesensing.org/libtiff/</b></p>