src/tiff/html/man/TIFFWarning.3tiff.html

   1 <!-- Creator     : groff version 1.18.1 -->
   2 <!-- CreationDate: Mon Mar 13 18:03:11 2006 -->
   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
  28 warning 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>,
  42 const char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p>
  43 <!-- INDENTATION -->
  44 <p><b>#include &lt;stdargh.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>,
  48 va_list</b> <i>ap</i><b>);</b></p>
  49 <!-- INDENTATION -->
  50 <p><b>TIFFWarningHandler
  51 TIFFSetWarningHandler(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
  64 handler function to (normally) write a warning message to
  65 the <b>stderr</b>. The <i>fmt</i> parameter is a
  66 <i>printf</i>(3S) format string, and any number arguments
  67 can be supplied. The <i>module</i> parameter is interpreted
  68 as a string that, if non-zero, should be printed before the
  69 message; it typically is used to identify the software
  70 module in which a warning is detected.</p>
  71 <!-- INDENTATION -->
  72 <p>Applications that desire to capture control in the event
  73 of a warning should use <i>TIFFSetWarningHandler</i> to
  74 override the default warning handler. A <small>NULL</small>
  75 (0) warning handler function may be installed to suppress
  76 error 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
  88 previous 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.remotesensing.org/libtiff/</b></p>
 104 </td>
 105 </table>
 106 <hr>
 107 </body>
 108 </html>