1<!-- Creator     : groff version 1.19.2 -->
2<!-- CreationDate: Mon Jan  2 17:41:36 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>TIFFError</title>
16
17</head>
18<body>
19
20<h1 align=center>TIFFError</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="#SEE ALSO">SEE ALSO</a><br>
27
28<hr>
29
30
31<a name="NAME"></a>
32<h2>NAME</h2>
33
34
35<p style="margin-left:11%; margin-top: 1em">TIFFError,
36TIFFSetErrorHandler &minus; library error handling
37interface</p>
38
39<a name="SYNOPSIS"></a>
40<h2>SYNOPSIS</h2>
41
42
43<p style="margin-left:11%; margin-top: 1em"><b>#include
44&lt;tiffio.h&gt;</b></p>
45
46<p style="margin-left:11%; margin-top: 1em"><b>void
47TIFFError(const char *</b><i>module</i><b>, const char
48*</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p>
49
50<p style="margin-left:11%; margin-top: 1em"><b>#include
51&lt;stdarg.h&gt;</b></p>
52
53<p style="margin-left:11%; margin-top: 1em"><b>typedef void
54(*TIFFErrorHandler)(const char *</b><i>module</i><b>, const
55char *</b><i>fmt</i><b>, va_list</b> <i>ap</i><b>); <br>
56TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler
57handler);</b></p>
58
59<a name="DESCRIPTION"></a>
60<h2>DESCRIPTION</h2>
61
62
63
64<p style="margin-left:11%; margin-top: 1em"><i>TIFFError</i>
65invokes the library-wide error handling function to
66(normally) write an error message to the <b>stderr</b>. The
67<i>fmt</i> parameter is a <i>printf</i>(3S) format string,
68and any number arguments can be supplied. The <i>module</i>
69parameter, if non-zero, is printed before the message; it
70typically is used to identify the software module in which
71an error is detected.</p>
72
73<p style="margin-left:11%; margin-top: 1em">Applications
74that desire to capture control in the event of an error
75should use <i>TIFFSetErrorHandler</i> to override the
76default error handler. A <small>NULL</small> (0) error
77handling function may be installed to suppress error
78messages.</p>
79
80<a name="RETURN VALUES"></a>
81<h2>RETURN VALUES</h2>
82
83
84
85<p style="margin-left:11%; margin-top: 1em"><i>TIFFSetErrorHandler</i>
86returns a reference to the previous error handling
87function.</p>
88
89<a name="SEE ALSO"></a>
90<h2>SEE ALSO</h2>
91
92
93
94<p style="margin-left:11%; margin-top: 1em"><b>TIFFWarning</b>(3TIFF),
95<b>libtiff</b>(3TIFF), <b>printf</b>(3)</p>
96
97<p style="margin-left:11%; margin-top: 1em">Libtiff library
98home page: <b>http://www.remotesensing.org/libtiff/</b></p>
99<hr>
100</body>
101</html>
102