1 <!-- Creator : groff version 1.18.1 -->
2 <!-- CreationDate: Sat Feb 24 18:37:16 2007 -->
5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
6 <meta name="Content-Style" content="text/css">
11 <h1 align=center>QUERY</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>
22 <table width="100%" border=0 rules="none" frame="void"
23 cols="2" cellspacing="0" cellpadding="0">
24 <tr valign="top" align="left">
27 <p>TIFFCurrentRow, TIFFCurrentStrip, TIFFCurrentTile,
28 TIFFCurrentDirectory, TIFFLastDirectory, TIFFFileno,
29 TIFFFileName, TIFFGetMode, TIFFIsTiled, TIFFIsByteSwapped,
30 TIFFIsUpSampled, TIFFIsMSB2LSB, TIFFGetVersion − query
34 <a name="SYNOPSIS"></a>
37 <table width="100%" border=0 rules="none" frame="void"
38 cols="2" cellspacing="0" cellpadding="0">
39 <tr valign="top" align="left">
42 <p><b>#include <tiffio.h></b></p>
44 <p><b>uint32 TIFFCurrentRow(TIFF*</b> <i>tif</i><b>)<br>
45 tstrip_t TIFFCurrentStrip(TIFF*</b> <i>tif</i><b>)<br>
46 ttile_t TIFFCurrentTile(TIFF*</b> <i>tif</i><b>)<br>
47 tdir_t TIFFCurrentDirectory(TIFF*</b> <i>tif</i><b>)<br>
48 int TIFFLastDirectory(TIFF*</b> <i>tif</i><b>)<br>
49 int TIFFFileno(TIFF*</b> <i>tif</i><b>)<br>
50 char* TIFFFileName(TIFF*</b> <i>tif</i><b>)<br>
51 int TIFFGetMode(TIFF*</b> <i>tif</i><b>)<br>
52 int TIFFIsTiled(TIFF*</b> <i>tif</i><b>)<br>
53 int TIFFIsByteSwapped(TIFF*</b> <i>tif</i><b>)<br>
54 int TIFFIsUpSampled(TIFF*</b> <i>tif</i><b>)<br>
55 int TIFFIsMSB2LSB(TIFF*</b> <i>tif</i><b>)<br>
56 const char* TIFFGetVersion(void)</b></p>
59 <a name="DESCRIPTION"></a>
62 <table width="100%" border=0 rules="none" frame="void"
63 cols="2" cellspacing="0" cellpadding="0">
64 <tr valign="top" align="left">
67 <p>The following routines return status information about an
68 open <small>TIFF</small> file.</p>
70 <p><i>TIFFCurrentDirectory</i> returns the index of the
71 current directory (directories are numbered starting at 0).
72 This number is suitable for use with the
73 <i>TIFFSetDirectory</i> routine.</p>
75 <p><i>TIFFLastDirectory</i> returns a non-zero value if the
76 current directory is the last directory in the file;
77 otherwise zero is returned.</p>
79 <p><i>TIFFCurrentRow</i>, <i>TIFFCurrentStrip</i>, and
80 <i>TIFFCurrentTile</i>, return the current row, strip, and
81 tile, respectively, that is being read or written. These
82 values are updated each time a read or write is done.</p>
84 <p><i>TIFFFileno</i> returns the underlying file descriptor
85 used to access the <small>TIFF</small> image in the
88 <p><i>TIFFFileName</i> returns the pathname argument passed
89 to <i>TIFFOpen</i> or <i>TIFFFdOpen</i>.</p>
91 <p><i>TIFFGetMode</i> returns the mode with which the
92 underlying file was opened. On <small>UNIX</small> systems,
93 this is the value passed to the <i>open</i>(2) system
96 <p><i>TIFFIsTiled</i> returns a non-zero value if the image
97 data has a tiled organization. Zero is returned if the image
98 data is organized in strips.</p>
100 <p><i>TIFFIsByteSwapped</i> returns a non-zero value if the
101 image data was in a different byte-order than the host
102 machine. Zero is returned if the TIFF file and local host
103 byte-orders are the same. Note that TIFFReadTile(),
104 TIFFReadStrip() and TIFFReadScanline() functions already
105 normally perform byte swapping to local host order if
108 <p><i>TIFFIsUpSampled</i> returns a non-zero value if image
109 data returned through the read interface routines is being
110 up-sampled. This can be useful to applications that want to
111 calculate I/O buffer sizes to reflect this usage (though the
112 usual strip and tile size routines already do this).</p>
114 <p><i>TIFFIsMSB2LSB</i> returns a non-zero value if the
115 image data is being returned with bit 0 as the most
118 <p><i>TIFFGetVersion</i> returns an <small>ASCII</small>
119 string that has a version stamp for the <small>TIFF</small>
120 library software.</p>
123 <a name="DIAGNOSTICS"></a>
126 <table width="100%" border=0 rules="none" frame="void"
127 cols="2" cellspacing="0" cellpadding="0">
128 <tr valign="top" align="left">
134 <a name="SEE ALSO"></a>
137 <table width="100%" border=0 rules="none" frame="void"
138 cols="2" cellspacing="0" cellpadding="0">
139 <tr valign="top" align="left">
142 <p><i>libtiff</i>(3TIFF), <i>TIFFOpen</i>(3TIFF),
143 <i>TIFFFdOpen</i>(3TIFF)</p>