1<!-- Creator     : groff version 1.19.2 -->
2<!-- CreationDate: Mon Jan  2 17:41:50 2006 -->
3<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
4"http://www.w3.org/TR/html4/loose.dtd">
5<html>
6<head>
7<meta name="generator" content="groff -Thtml, see www.gnu.org">
8<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
9<meta name="Content-Style" content="text/css">
10<style type="text/css">
11       p     { margin-top: 0; margin-bottom: 0; }
12       pre   { margin-top: 0; margin-bottom: 0; }
13       table { margin-top: 0; margin-bottom: 0; }
14</style>
15<title>TIFFWriteTile</title>
16
17</head>
18<body>
19
20<h1 align=center>TIFFWriteTile</h1>
21
22<a href="#NAME">NAME</a><br>
23<a href="#SYNOPSIS">SYNOPSIS</a><br>
24<a href="#DESCRIPTION">DESCRIPTION</a><br>
25<a href="#RETURN VALUES">RETURN VALUES</a><br>
26<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
27<a href="#SEE ALSO">SEE ALSO</a><br>
28
29<hr>
30
31
32<a name="NAME"></a>
33<h2>NAME</h2>
34
35
36<p style="margin-left:11%; margin-top: 1em">TIFFWriteTile
37&minus; encode and write a tile of data to an open
38<small>TIFF</small> file</p>
39
40<a name="SYNOPSIS"></a>
41<h2>SYNOPSIS</h2>
42
43
44<p style="margin-left:11%; margin-top: 1em"><b>#include
45&lt;tiffio.h&gt;</b></p>
46
47<p style="margin-left:11%; margin-top: 1em"><b>tsize_t
48TIFFWriteTile(TIFF *</b><i>tif</i><b>, tdata_t</b>
49<i>buf</i><b>, uint32</b> <i>x</i><b>, uint32</b>
50<i>y</i><b>, uint32</b> <i>z</i><b>, tsample_t</b>
51<i>sample</i><b>)</b></p>
52
53<a name="DESCRIPTION"></a>
54<h2>DESCRIPTION</h2>
55
56
57<p style="margin-left:11%; margin-top: 1em">Write the data
58for the tile <i>containing</i> the specified coordinates.
59The data in <i>buf</i> are is (potentially) compressed, and
60written to the indicated file, normally being appended to
61the end of the file. The buffer must be contain an entire
62tile of data. Applications should call the routine
63<i>TIFFTileSize</i> to find out the size (in bytes) of a
64tile buffer. The <i>x</i> and <i>y</i> parameters are always
65used by <i>TIFFWriteTile</i>. The <i>z</i> parameter is used
66if the image is deeper than 1 slice
67(<i>ImageDepth</i>&gt;1). The <i>sample</i> parameter is
68used only if data are organized in separate planes
69(<i>PlanarConfiguration</i>=2).</p>
70
71<a name="RETURN VALUES"></a>
72<h2>RETURN VALUES</h2>
73
74
75
76<p style="margin-left:11%; margin-top: 1em"><i>TIFFWriteTile</i>
77returns &minus;1 if it detects an error; otherwise the
78number of bytes in the tile is returned.</p>
79
80<a name="DIAGNOSTICS"></a>
81<h2>DIAGNOSTICS</h2>
82
83
84<p style="margin-left:11%; margin-top: 1em">All error
85messages are directed to the <b>TIFFError</b>(3TIFF)
86routine.</p>
87
88<a name="SEE ALSO"></a>
89<h2>SEE ALSO</h2>
90
91
92
93<p style="margin-left:11%; margin-top: 1em"><b>TIFFCheckTile</b>(3TIFF),
94<b>TIFFComputeTile</b>(3TIFF), <b>TIFFOpen</b>(3TIFF),
95<b>TIFFReadTile</b>(3TIFF), <b>TIFFWriteScanline</b>(3TIFF),
96<b>TIFFWriteEncodedTile</b>(3TIFF),
97<b>TIFFWriteRawTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p>
98
99<p style="margin-left:11%; margin-top: 1em">Libtiff library
100home page: <b>http://www.remotesensing.org/libtiff/</b></p>
101<hr>
102</body>
103</html>
104