1<!-- Creator     : groff version 1.19.2 -->
2<!-- CreationDate: Mon Jan  2 17:41:39 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>QUERY</title>
16
17</head>
18<body>
19
20<h1 align=center>QUERY</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="#DIAGNOSTICS">DIAGNOSTICS</a><br>
26<a href="#SEE ALSO">SEE ALSO</a><br>
27
28<hr>
29
30
31<a name="NAME"></a>
32<h2>NAME</h2>
33
34
35
36<p style="margin-left:11%; margin-top: 1em">TIFFCurrentRow,
37TIFFCurrentStrip, TIFFCurrentTile, TIFFCurrentDirectory,
38TIFFLastDirectory, TIFFFileno, TIFFFileName, TIFFGetMode,
39TIFFIsTiled, TIFFIsByteSwapped, TIFFIsUpSampled,
40TIFFIsMSB2LSB, TIFFGetVersion &minus; query routines</p>
41
42<a name="SYNOPSIS"></a>
43<h2>SYNOPSIS</h2>
44
45
46<p style="margin-left:11%; margin-top: 1em"><b>#include
47&lt;tiffio.h&gt;</b></p>
48
49<p style="margin-left:11%; margin-top: 1em"><b>uint32
50TIFFCurrentRow(TIFF*</b> <i>tif</i><b>) <br>
51tstrip_t TIFFCurrentStrip(TIFF*</b> <i>tif</i><b>) <br>
52ttile_t TIFFCurrentTile(TIFF*</b> <i>tif</i><b>) <br>
53tdir_t TIFFCurrentDirectory(TIFF*</b> <i>tif</i><b>) <br>
54int TIFFLastDirectory(TIFF*</b> <i>tif</i><b>) <br>
55int TIFFFileno(TIFF*</b> <i>tif</i><b>) <br>
56char* TIFFFileName(TIFF*</b> <i>tif</i><b>) <br>
57int TIFFGetMode(TIFF*</b> <i>tif</i><b>) <br>
58int TIFFIsTiled(TIFF*</b> <i>tif</i><b>) <br>
59int TIFFIsByteSwapped(TIFF*</b> <i>tif</i><b>) <br>
60int TIFFIsUpSampled(TIFF*</b> <i>tif</i><b>) <br>
61int TIFFIsMSB2LSB(TIFF*</b> <i>tif</i><b>) <br>
62const char* TIFFGetVersion(void)</b></p>
63
64<a name="DESCRIPTION"></a>
65<h2>DESCRIPTION</h2>
66
67
68<p style="margin-left:11%; margin-top: 1em">The following
69routines return status information about an open
70<small>TIFF</small> file.</p>
71
72
73<p style="margin-left:11%; margin-top: 1em"><i>TIFFCurrentDirectory</i>
74returns the index of the current directory (directories are
75numbered starting at 0). This number is suitable for use
76with the <i>TIFFSetDirectory</i> routine.</p>
77
78
79<p style="margin-left:11%; margin-top: 1em"><i>TIFFLastDirectory</i>
80returns a non-zero value if the current directory is the
81last directory in the file; otherwise zero is returned.</p>
82
83
84<p style="margin-left:11%; margin-top: 1em"><i>TIFFCurrentRow</i>,
85<i>TIFFCurrentStrip</i>, and <i>TIFFCurrentTile</i>, return
86the current row, strip, and tile, respectively, that is
87being read or written. These values are updated each time a
88read or write is done.</p>
89
90
91<p style="margin-left:11%; margin-top: 1em"><i>TIFFFileno</i>
92returns the underlying file descriptor used to access the
93<small>TIFF</small> image in the filesystem.</p>
94
95
96<p style="margin-left:11%; margin-top: 1em"><i>TIFFFileName</i>
97returns the pathname argument passed to <i>TIFFOpen</i> or
98<i>TIFFFdOpen</i>.</p>
99
100
101<p style="margin-left:11%; margin-top: 1em"><i>TIFFGetMode</i>
102returns the mode with which the underlying file was opened.
103On <small>UNIX</small> systems, this is the value passed to
104the <i>open</i>(2) system call.</p>
105
106
107<p style="margin-left:11%; margin-top: 1em"><i>TIFFIsTiled</i>
108returns a non-zero value if the image data has a tiled
109organization. Zero is returned if the image data is
110organized in strips.</p>
111
112
113<p style="margin-left:11%; margin-top: 1em"><i>TIFFIsByteSwapped</i>
114returns a non-zero value if the image data was in a
115different byte-order than the host machine. Zero is returned
116if the TIFF file and local host byte-orders are the same.
117Note that TIFFReadTile(), TIFFReadStrip() and
118TIFFReadScanline() functions already normally perform byte
119swapping to local host order if needed.</p>
120
121
122<p style="margin-left:11%; margin-top: 1em"><i>TIFFIsUpSampled</i>
123returns a non-zero value if image data returned through the
124read interface routines is being up-sampled. This can be
125useful to applications that want to calculate I/O buffer
126sizes to reflect this usage (though the usual strip and tile
127size routines already do this).</p>
128
129
130<p style="margin-left:11%; margin-top: 1em"><i>TIFFIsMSB2LSB</i>
131returns a non-zero value if the image data is being returned
132with bit 0 as the most significant bit.</p>
133
134
135<p style="margin-left:11%; margin-top: 1em"><i>TIFFGetVersion</i>
136returns an <small>ASCII</small> string that has a version
137stamp for the <small>TIFF</small> library software.</p>
138
139<a name="DIAGNOSTICS"></a>
140<h2>DIAGNOSTICS</h2>
141
142
143<p style="margin-left:11%; margin-top: 1em">None.</p>
144
145<a name="SEE ALSO"></a>
146<h2>SEE ALSO</h2>
147
148
149
150<p style="margin-left:11%; margin-top: 1em"><i>libtiff</i>(3TIFF),
151<i>TIFFOpen</i>(3TIFF), <i>TIFFFdOpen</i>(3TIFF)</p>
152<hr>
153</body>
154</html>
155