Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / bd4ab27c6c77958ac4ebe228f4c6e29287d671d8 / . / www / api / exception.html
blob: 226b7d44fb2baca4bc682d84639398d64c9eddfb [file] [log] [blame]
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
cristy2c839602010-04-03 02:32:08 +0000[diff] [blame]3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]4<head>
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]5 <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
7 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]8 <style type="text/css" media="all">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]9 @import url("../../www/magick.css");
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]10 </style>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]11 <link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
12 <title>ImageMagick: MagickCore, C API for ImageMagick: Dealing with Exceptions</title>
13 <meta http-equiv="Content-Language" content="en-US"/>
14 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
15 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
16 <meta name="Generator" content="PHP"/>
17 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, dealing, with, exceptions, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
18 <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
19 <meta name="Rating" content="GENERAL"/>
20 <meta name="Robots" content="INDEX, FOLLOW"/>
21 <meta name="Generator" content="ImageMagick Studio LLC"/>
22 <meta name="Author" content="ImageMagick Studio LLC"/>
23 <meta name="Revisit-after" content="2 DAYS"/>
24 <meta name="Resource-type" content="document"/>
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]25 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]26 <meta name="Distribution" content="Global"/>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]27</head>
28
29<body id="www-imagemagick-org">
30<div class="titlebar">
31<a href="../../index.html">
32 <img src="../../images/script.png" alt="[ImageMagick]"
33 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
34<a href="http://www.networkredux.com">
35 <img src="../../images/networkredux.png" alt="[sponsor]"
36 style="margin: 45px auto; border: 0px; float: left;" /></a>
37<a href="http://www.imagemagick.org/discourse-server/">
38 <img src="../../images/logo.jpg" alt=""
39 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
40<a href="../../index.html">
41 <img src="../../images/sprite.jpg" alt=""
42 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
43</div>
44
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]45<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]46
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]47<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]48 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]49</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]50<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]51<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]52 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
53</div>
54<div class="sub">
55 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
56</div>
57<div class="sub">
58 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
59</div>
60<div class="sub">
61 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
62</div>
63<div class="sep"></div>
64<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]65 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66</div>
67<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]68 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]69</div>
70<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]71 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]72</div>
73<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]74 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]75</div>
76<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]77 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]78</div>
79<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]80 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]81</div>
82<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]83 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]84</div>
85<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]86 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]87</div>
88<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]89 <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]90</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]91<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]92<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]93 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]94</div>
95<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]96 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]97</div>
98<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]99 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100 </div>
101<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]102 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]104<div class="menu">
105 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
106</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]107<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]108 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]112 <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]113</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]114<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]115<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]116 <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]117</div>
118<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]119 <a title="Site Map: Links"href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]121<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]123 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124
125<div class="sponsbox">
126<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]127 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
128</div>
129<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]130 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
cristy2c2a4492010-03-16 15:06:03 +0000[diff] [blame]131</div>
132<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]133 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristyb2a11ae2010-02-22 00:53:36 +0000[diff] [blame]134</div>
135<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]136 <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]137</div>
138<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]139 <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
cristyc1c61662009-09-30 14:04:37 +0000[diff] [blame]140</div>
141<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]142 <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristyec678732009-09-22 11:31:10 +0000[diff] [blame]143</div>
cristyae6203d2010-08-09 01:12:14 +0000[diff] [blame]144<div class="sponsor">
145 <a title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
146</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]149</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]150
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]151<div class="eastbar">
152 <script type="text/javascript">
153 <!--
154 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]155 google_ad_slot = "0574824969";
156 google_ad_width = 160;
157 google_ad_height = 600;
158 //-->
159 </script>
160 <script type="text/javascript"
161 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
162 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]163</div>
164
165<div class="main">
166
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]167<p class="navigation-index">[<a href="#AcquireExceptionInfo">AcquireExceptionInfo</a> &bull; <a href="#ClearMagickException">ClearMagickException</a> &bull; <a href="#CatchException">CatchException</a> &bull; <a href="#DestroyExceptionInfo">DestroyExceptionInfo</a> &bull; <a href="#GetExceptionInfo">GetExceptionInfo</a> &bull; <a href="#GetExceptionMessage">GetExceptionMessage</a> &bull; <a href="#GetLocaleExceptionMessage">GetLocaleExceptionMessage</a> &bull; <a href="#InheritException">InheritException</a> &bull; <a href="#MagickError">MagickError</a> &bull; <a href="#MagickFatalError">MagickFatalError</a> &bull; <a href="#MagickWarning">MagickWarning</a> &bull; <a href="#SetErrorHandler">SetErrorHandler</a> &bull; <a href="#SetFatalErrorHandler">SetFatalErrorHandler</a> &bull; <a href="#SetWarningHandler">SetWarningHandler</a> &bull; <a href="#ThrowException">ThrowException</a>]</p>
168
169<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
170_8c.html" target="source" name="AcquireExceptionInfo">AcquireExceptionInfo</a></h2>
171<div class="doc-section">
172
173<p>AcquireExceptionInfo() allocates the ExceptionInfo structure.</p></ol>
174
175<p>The format of the AcquireExceptionInfo method is:</p>
176
177<pre class="code">
178 ExceptionInfo *AcquireExceptionInfo(void)
179</pre>
180
181 </div>
182<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
183_8c.html" target="source" name="ClearMagickException">ClearMagickException</a></h2>
184<div class="doc-section">
185
186<p>ClearMagickException() clears any exception that may not have been caught yet.</p></ol>
187
188<p>The format of the ClearMagickException method is:</p>
189
190<pre class="code">
191 ClearMagickException(ExceptionInfo *exception)
192</pre>
193
194<p>A description of each parameter follows:</p></ol>
195
196<h5>exception</h5>
197<ol><p>the exception info.</p></ol>
198
199 </div>
200<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
201_8c.html" target="source" name="CatchException">CatchException</a></h2>
202<div class="doc-section">
203
204<p>CatchException() returns if no exceptions is found otherwise it reports the exception as a warning, error, or fatal depending on the severity.</p></ol>
205
206<p>The format of the CatchException method is:</p>
207
208<pre class="code">
209 CatchException(ExceptionInfo *exception)
210</pre>
211
212<p>A description of each parameter follows:</p></ol>
213
214<h5>exception</h5>
215<ol><p>the exception info.</p></ol>
216
217 </div>
218<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
219_8c.html" target="source" name="DestroyExceptionInfo">DestroyExceptionInfo</a></h2>
220<div class="doc-section">
221
222<p>DestroyExceptionInfo() deallocates memory associated with an exception.</p></ol>
223
224<p>The format of the DestroyExceptionInfo method is:</p>
225
226<pre class="code">
227 ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
228</pre>
229
230<p>A description of each parameter follows:</p></ol>
231
232<h5>exception</h5>
233<ol><p>the exception info.</p></ol>
234
235 </div>
236<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
237_8c.html" target="source" name="GetExceptionInfo">GetExceptionInfo</a></h2>
238<div class="doc-section">
239
240<p>GetExceptionInfo() initializes an exception to default values.</p></ol>
241
242<p>The format of the GetExceptionInfo method is:</p>
243
244<pre class="code">
245 GetExceptionInfo(ExceptionInfo *exception)
246</pre>
247
248<p>A description of each parameter follows:</p></ol>
249
250<h5>exception</h5>
251<ol><p>the exception info.</p></ol>
252
253 </div>
254<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
255_8c.html" target="source" name="GetExceptionMessage">GetExceptionMessage</a></h2>
256<div class="doc-section">
257
258<p>GetExceptionMessage() returns the error message defined by the specified error code.</p></ol>
259
260<p>The format of the GetExceptionMessage method is:</p>
261
262<pre class="code">
263 char *GetExceptionMessage(const int error)
264</pre>
265
266<p>A description of each parameter follows:</p></ol>
267
268<h5>error</h5>
269<ol><p>the error code.</p></ol>
270
271 </div>
272<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
273_8c.html" target="source" name="GetLocaleExceptionMessage">GetLocaleExceptionMessage</a></h2>
274<div class="doc-section">
275
276<p>GetLocaleExceptionMessage() converts a enumerated exception severity and tag to a message in the current locale.</p></ol>
277
278<p>The format of the GetLocaleExceptionMessage method is:</p>
279
280<pre class="code">
281 const char *GetLocaleExceptionMessage(const ExceptionType severity,
282 const char *tag)
283</pre>
284
285<p>A description of each parameter follows:</p></ol>
286
287<h5>severity</h5>
288<ol><p>the severity of the exception.</p></ol>
289
290<h5>tag</h5>
291<ol><p>the message tag.</p></ol>
292
293 </div>
294<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
295_8c.html" target="source" name="InheritException">InheritException</a></h2>
296<div class="doc-section">
297
298<p>InheritException() inherits an exception from a related exception.</p></ol>
299
300<p>The format of the InheritException method is:</p>
301
302<pre class="code">
303 InheritException(ExceptionInfo *exception,const ExceptionInfo *relative)
304</pre>
305
306<p>A description of each parameter follows:</p></ol>
307
308<h5>exception</h5>
309<ol><p>the exception info.</p></ol>
310
311<h5>relative</h5>
312<ol><p>the related exception info.</p></ol>
313
314 </div>
315<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
316_8c.html" target="source" name="MagickError">MagickError</a></h2>
317<div class="doc-section">
318
319<p>MagickError() calls the exception handler methods with an error reason.</p></ol>
320
321<p>The format of the MagickError method is:</p>
322
323<pre class="code">
324 void MagickError(const ExceptionType error,const char *reason,
325 const char *description)
326</pre>
327
328<p>A description of each parameter follows:</p></ol>
329
330<h5>exception</h5>
331<ol><p>Specifies the numeric error category.</p></ol>
332
333<h5>reason</h5>
334<ol><p>Specifies the reason to display before terminating the program.</p></ol>
335
336<h5>description</h5>
337<ol><p>Specifies any description to the reason.</p></ol>
338
339 </div>
340<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
341_8c.html" target="source" name="MagickFatalError">MagickFatalError</a></h2>
342<div class="doc-section">
343
344<p>MagickFatalError() calls the fatal exception handler methods with an error reason.</p></ol>
345
346<p>The format of the MagickError method is:</p>
347
348<pre class="code">
349 void MagickFatalError(const ExceptionType error,const char *reason,
350 const char *description)
351</pre>
352
353<p>A description of each parameter follows:</p></ol>
354
355<h5>exception</h5>
356<ol><p>Specifies the numeric error category.</p></ol>
357
358<h5>reason</h5>
359<ol><p>Specifies the reason to display before terminating the program.</p></ol>
360
361<h5>description</h5>
362<ol><p>Specifies any description to the reason.</p></ol>
363
364 </div>
365<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
366_8c.html" target="source" name="MagickWarning">MagickWarning</a></h2>
367<div class="doc-section">
368
369<p>MagickWarning() calls the warning handler methods with a warning reason.</p></ol>
370
371<p>The format of the MagickWarning method is:</p>
372
373<pre class="code">
374 void MagickWarning(const ExceptionType warning,const char *reason,
375 const char *description)
376</pre>
377
378<p>A description of each parameter follows:</p></ol>
379
380<h5>warning</h5>
381<ol><p>the warning severity.</p></ol>
382
383<h5>reason</h5>
384<ol><p>Define the reason for the warning.</p></ol>
385
386<h5>description</h5>
387<ol><p>Describe the warning.</p></ol>
388
389 </div>
390<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
391_8c.html" target="source" name="SetErrorHandler">SetErrorHandler</a></h2>
392<div class="doc-section">
393
394<p>SetErrorHandler() sets the exception handler to the specified method and returns the previous exception handler.</p></ol>
395
396<p>The format of the SetErrorHandler method is:</p>
397
398<pre class="code">
399 ErrorHandler SetErrorHandler(ErrorHandler handler)
400</pre>
401
402<p>A description of each parameter follows:</p></ol>
403
404<h5>handler</h5>
405<ol><p>the method to handle errors.</p></ol>
406
407 </div>
408<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
409_8c.html" target="source" name="SetFatalErrorHandler">SetFatalErrorHandler</a></h2>
410<div class="doc-section">
411
412<p>SetFatalErrorHandler() sets the fatal exception handler to the specified method and returns the previous fatal exception handler.</p></ol>
413
414<p>The format of the SetErrorHandler method is:</p>
415
416<pre class="code">
417 ErrorHandler SetErrorHandler(ErrorHandler handler)
418</pre>
419
420<p>A description of each parameter follows:</p></ol>
421
422<h5>handler</h5>
423<ol><p>the method to handle errors.</p></ol>
424
425 </div>
426<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
427_8c.html" target="source" name="SetWarningHandler">SetWarningHandler</a></h2>
428<div class="doc-section">
429
430<p>SetWarningHandler() sets the warning handler to the specified method and returns the previous warning handler.</p></ol>
431
432<p>The format of the SetWarningHandler method is:</p>
433
434<pre class="code">
435 ErrorHandler SetWarningHandler(ErrorHandler handler)
436</pre>
437
438<p>A description of each parameter follows:</p></ol>
439
440<h5>handler</h5>
441<ol><p>the method to handle warnings.</p></ol>
442
443 </div>
444<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
445_8c.html" target="source" name="ThrowException">ThrowException</a></h2>
446<div class="doc-section">
447
448<p>ThrowException() throws an exception with the specified severity code, reason, and optional description.</p></ol>
449
450<p>The format of the ThrowException method is:</p>
451
452<pre class="code">
453 MagickBooleanType ThrowException(ExceptionInfo *exception,
454 const ExceptionType severity,const char *reason,
455 const char *description)
456</pre>
457
458<p>A description of each parameter follows:</p></ol>
459
460<h5>exception</h5>
461<ol><p>the exception info.</p></ol>
462
463<h5>severity</h5>
464<ol><p>the severity of the exception.</p></ol>
465
466<h5>reason</h5>
467<ol><p>the reason for the exception.</p></ol>
468
469<h5>description</h5>
470<ol><p>the exception description.</p></ol>
471
472 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]473
474</div>
475
476<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]477 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]478 <span id="linkbar-center">
479 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]480 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]481 </span>
482 <span id="linkbar-east">&nbsp;</span>
483 </div>
484 <div class="footer">
485 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
486 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
487 </div>
488 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]489 <script type="text/javascript">
490 var _gaq = _gaq || [];
491 _gaq.push(['_setAccount', 'UA-17690367-1']);
492 _gaq.push(['_trackPageview']);
493
494 (function() {
495 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
496 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
497 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
498 })();
499 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]500</body>
501</html>