1<!-- Creator     : groff version 1.18.1 -->
2<!-- CreationDate: Sat Feb 24 18:37:18 2007 -->
3<html>
4<head>
5<meta name="generator" content="groff -Thtml, see www.gnu.org">
6<meta name="Content-Style" content="text/css">
7<title>TIFFWarning</title>
8</head>
9<body>
10
11<h1 align=center>TIFFWarning</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="#SEE ALSO">SEE ALSO</a><br>
17
18<hr>
19<a name="NAME"></a>
20<h2>NAME</h2>
21<!-- INDENTATION -->
22<table width="100%" border=0 rules="none" frame="void"
23       cols="2" cellspacing="0" cellpadding="0">
24<tr valign="top" align="left">
25<td width="8%"></td>
26<td width="91%">
27<p>TIFFWarning, TIFFSetWarningHandler &minus; library
28warning interface</p>
29</td>
30</table>
31<a name="SYNOPSIS"></a>
32<h2>SYNOPSIS</h2>
33<!-- INDENTATION -->
34<table width="100%" border=0 rules="none" frame="void"
35       cols="2" cellspacing="0" cellpadding="0">
36<tr valign="top" align="left">
37<td width="8%"></td>
38<td width="91%">
39<p><b>#include &lt;tiffio.h&gt;</b></p>
40<!-- INDENTATION -->
41<p><b>void TIFFWarning(const char *</b><i>module</i><b>,
42const char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p>
43<!-- INDENTATION -->
44<p><b>#include &lt;stdarg.h&gt;</b></p>
45<!-- INDENTATION -->
46<p><b>typedef void (*TIFFWarningHandler)(const char
47*</b><i>module</i><b>, const char *</b><i>fmt</i><b>,
48va_list</b> <i>ap</i><b>);</b></p>
49<!-- INDENTATION -->
50<p><b>TIFFWarningHandler
51TIFFSetWarningHandler(TIFFWarningHandler</b>
52<i>handler</i><b>);</b></p>
53</td>
54</table>
55<a name="DESCRIPTION"></a>
56<h2>DESCRIPTION</h2>
57<!-- INDENTATION -->
58<table width="100%" border=0 rules="none" frame="void"
59       cols="2" cellspacing="0" cellpadding="0">
60<tr valign="top" align="left">
61<td width="8%"></td>
62<td width="91%">
63<p><i>TIFFWarning</i> invokes the library-wide warning
64handler function to (normally) write a warning message to
65the <b>stderr</b>. The <i>fmt</i> parameter is a
66<i>printf</i>(3S) format string, and any number arguments
67can be supplied. The <i>module</i> parameter is interpreted
68as a string that, if non-zero, should be printed before the
69message; it typically is used to identify the software
70module in which a warning is detected.</p>
71<!-- INDENTATION -->
72<p>Applications that desire to capture control in the event
73of a warning should use <i>TIFFSetWarningHandler</i> to
74override the default warning handler. A <small>NULL</small>
75(0) warning handler function may be installed to suppress
76error messages.</p>
77</td>
78</table>
79<a name="RETURN VALUES"></a>
80<h2>RETURN VALUES</h2>
81<!-- INDENTATION -->
82<table width="100%" border=0 rules="none" frame="void"
83       cols="2" cellspacing="0" cellpadding="0">
84<tr valign="top" align="left">
85<td width="8%"></td>
86<td width="91%">
87<p><i>TIFFSetWarningHandler</i> returns a reference to the
88previous error handling function.</p>
89</td>
90</table>
91<a name="SEE ALSO"></a>
92<h2>SEE ALSO</h2>
93<!-- INDENTATION -->
94<table width="100%" border=0 rules="none" frame="void"
95       cols="2" cellspacing="0" cellpadding="0">
96<tr valign="top" align="left">
97<td width="8%"></td>
98<td width="91%">
99<p><b>TIFFError</b>(3TIFF), <b>libtiff</b>(3TIFF),
100<b>printf</b>(3)</p>
101<!-- INDENTATION -->
102<p>Libtiff library home page:
103<b>http://www.simplesystems.org/libtiff/</b></p>
104</td>
105</table>
106<hr>
107</body>
108</html>
109