summaryrefslogtreecommitdiff
path: root/doc/static/man/TIFFWarning.3tiff.html
blob: 04e7eae46f60b5a092d63a841917188ab333e263 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
<!-- Creator     : groff version 1.22.4 -->
<!-- CreationDate: Sat Jun  4 16:23:27 2022 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
       h1      { text-align: center }
</style>
<title>TIFFWarning</title>

</head>
<body>

<h1 align="center">TIFFWarning</h1>

<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#RETURN VALUES">RETURN VALUES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>

<hr>


<h2>NAME
<a name="NAME"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">TIFFWarning,
TIFFSetWarningHandler &minus; library warning interface</p>

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em"><b>#include
&lt;tiffio.h&gt;</b></p>

<p style="margin-left:11%; margin-top: 1em"><b>void
TIFFWarning(const char *</b><i>module</i><b>, const char
*</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p>

<p style="margin-left:11%; margin-top: 1em"><b>#include
&lt;stdarg.h&gt;</b></p>

<p style="margin-left:11%; margin-top: 1em"><b>typedef void
(*TIFFWarningHandler)(const char *</b><i>module</i><b>,
const char *</b><i>fmt</i><b>, va_list</b>
<i>ap</i><b>);</b></p>


<p style="margin-left:11%; margin-top: 1em"><b>TIFFWarningHandler
TIFFSetWarningHandler(TIFFWarningHandler</b>
<i>handler</i><b>);</b></p>

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b><i>TIFFWarning</i></b>
invokes the library-wide warning handler function to
(normally) write a warning message to the <b>stderr</b>. The
<i>fmt</i> parameter is a <i>printf</i>(3S) format string,
and any number arguments can be supplied. The <i>module</i>
parameter is interpreted as a string that, if non-zero,
should be printed before the message; it typically is used
to identify the software module in which a warning is
detected.</p>

<p style="margin-left:11%; margin-top: 1em">Applications
that desire to capture control in the event of a warning
should use <i>TIFFSetWarningHandler</i> to override the
default warning handler. A <small>NULL</small> (0) warning
handler function may be installed to suppress error
messages.</p>

<h2>RETURN VALUES
<a name="RETURN VALUES"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><i>TIFFSetWarningHandler</i>
returns a reference to the previous error handling
function.</p>

<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>TIFFError</b>(3TIFF),
<b>libtiff</b>(3TIFF), <b>printf</b>(3)</p>

<p style="margin-left:11%; margin-top: 1em">Libtiff library
home page: <b>http://www.simplesystems.org/libtiff/</b></p>
<hr>
</body>
</html>