Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 851dbceb0a51cbcd3ed512f074e9f2d797b7cbc1 / . / www / api / exception.html
blob: fd663189243e7078c3cbe992e5843810402c9960 [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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]144</div>
145</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]146</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]147
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]148<div class="eastbar">
149 <script type="text/javascript">
150 <!--
151 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]152 google_ad_slot = "0574824969";
153 google_ad_width = 160;
154 google_ad_height = 600;
155 //-->
156 </script>
157 <script type="text/javascript"
158 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
159 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]160</div>
161
162<div class="main">
163
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]164<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>
165
166<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
167_8c.html" target="source" name="AcquireExceptionInfo">AcquireExceptionInfo</a></h2>
168<div class="doc-section">
169
170<p>AcquireExceptionInfo() allocates the ExceptionInfo structure.</p></ol>
171
172<p>The format of the AcquireExceptionInfo method is:</p>
173
174<pre class="code">
175 ExceptionInfo *AcquireExceptionInfo(void)
176</pre>
177
178 </div>
179<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
180_8c.html" target="source" name="ClearMagickException">ClearMagickException</a></h2>
181<div class="doc-section">
182
183<p>ClearMagickException() clears any exception that may not have been caught yet.</p></ol>
184
185<p>The format of the ClearMagickException method is:</p>
186
187<pre class="code">
188 ClearMagickException(ExceptionInfo *exception)
189</pre>
190
191<p>A description of each parameter follows:</p></ol>
192
193<h5>exception</h5>
194<ol><p>the exception info.</p></ol>
195
196 </div>
197<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
198_8c.html" target="source" name="CatchException">CatchException</a></h2>
199<div class="doc-section">
200
201<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>
202
203<p>The format of the CatchException method is:</p>
204
205<pre class="code">
206 CatchException(ExceptionInfo *exception)
207</pre>
208
209<p>A description of each parameter follows:</p></ol>
210
211<h5>exception</h5>
212<ol><p>the exception info.</p></ol>
213
214 </div>
215<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
216_8c.html" target="source" name="DestroyExceptionInfo">DestroyExceptionInfo</a></h2>
217<div class="doc-section">
218
219<p>DestroyExceptionInfo() deallocates memory associated with an exception.</p></ol>
220
221<p>The format of the DestroyExceptionInfo method is:</p>
222
223<pre class="code">
224 ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
225</pre>
226
227<p>A description of each parameter follows:</p></ol>
228
229<h5>exception</h5>
230<ol><p>the exception info.</p></ol>
231
232 </div>
233<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
234_8c.html" target="source" name="GetExceptionInfo">GetExceptionInfo</a></h2>
235<div class="doc-section">
236
237<p>GetExceptionInfo() initializes an exception to default values.</p></ol>
238
239<p>The format of the GetExceptionInfo method is:</p>
240
241<pre class="code">
242 GetExceptionInfo(ExceptionInfo *exception)
243</pre>
244
245<p>A description of each parameter follows:</p></ol>
246
247<h5>exception</h5>
248<ol><p>the exception info.</p></ol>
249
250 </div>
251<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
252_8c.html" target="source" name="GetExceptionMessage">GetExceptionMessage</a></h2>
253<div class="doc-section">
254
255<p>GetExceptionMessage() returns the error message defined by the specified error code.</p></ol>
256
257<p>The format of the GetExceptionMessage method is:</p>
258
259<pre class="code">
260 char *GetExceptionMessage(const int error)
261</pre>
262
263<p>A description of each parameter follows:</p></ol>
264
265<h5>error</h5>
266<ol><p>the error code.</p></ol>
267
268 </div>
269<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
270_8c.html" target="source" name="GetLocaleExceptionMessage">GetLocaleExceptionMessage</a></h2>
271<div class="doc-section">
272
273<p>GetLocaleExceptionMessage() converts a enumerated exception severity and tag to a message in the current locale.</p></ol>
274
275<p>The format of the GetLocaleExceptionMessage method is:</p>
276
277<pre class="code">
278 const char *GetLocaleExceptionMessage(const ExceptionType severity,
279 const char *tag)
280</pre>
281
282<p>A description of each parameter follows:</p></ol>
283
284<h5>severity</h5>
285<ol><p>the severity of the exception.</p></ol>
286
287<h5>tag</h5>
288<ol><p>the message tag.</p></ol>
289
290 </div>
291<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
292_8c.html" target="source" name="InheritException">InheritException</a></h2>
293<div class="doc-section">
294
295<p>InheritException() inherits an exception from a related exception.</p></ol>
296
297<p>The format of the InheritException method is:</p>
298
299<pre class="code">
300 InheritException(ExceptionInfo *exception,const ExceptionInfo *relative)
301</pre>
302
303<p>A description of each parameter follows:</p></ol>
304
305<h5>exception</h5>
306<ol><p>the exception info.</p></ol>
307
308<h5>relative</h5>
309<ol><p>the related exception info.</p></ol>
310
311 </div>
312<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
313_8c.html" target="source" name="MagickError">MagickError</a></h2>
314<div class="doc-section">
315
316<p>MagickError() calls the exception handler methods with an error reason.</p></ol>
317
318<p>The format of the MagickError method is:</p>
319
320<pre class="code">
321 void MagickError(const ExceptionType error,const char *reason,
322 const char *description)
323</pre>
324
325<p>A description of each parameter follows:</p></ol>
326
327<h5>exception</h5>
328<ol><p>Specifies the numeric error category.</p></ol>
329
330<h5>reason</h5>
331<ol><p>Specifies the reason to display before terminating the program.</p></ol>
332
333<h5>description</h5>
334<ol><p>Specifies any description to the reason.</p></ol>
335
336 </div>
337<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
338_8c.html" target="source" name="MagickFatalError">MagickFatalError</a></h2>
339<div class="doc-section">
340
341<p>MagickFatalError() calls the fatal exception handler methods with an error reason.</p></ol>
342
343<p>The format of the MagickError method is:</p>
344
345<pre class="code">
346 void MagickFatalError(const ExceptionType error,const char *reason,
347 const char *description)
348</pre>
349
350<p>A description of each parameter follows:</p></ol>
351
352<h5>exception</h5>
353<ol><p>Specifies the numeric error category.</p></ol>
354
355<h5>reason</h5>
356<ol><p>Specifies the reason to display before terminating the program.</p></ol>
357
358<h5>description</h5>
359<ol><p>Specifies any description to the reason.</p></ol>
360
361 </div>
362<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
363_8c.html" target="source" name="MagickWarning">MagickWarning</a></h2>
364<div class="doc-section">
365
366<p>MagickWarning() calls the warning handler methods with a warning reason.</p></ol>
367
368<p>The format of the MagickWarning method is:</p>
369
370<pre class="code">
371 void MagickWarning(const ExceptionType warning,const char *reason,
372 const char *description)
373</pre>
374
375<p>A description of each parameter follows:</p></ol>
376
377<h5>warning</h5>
378<ol><p>the warning severity.</p></ol>
379
380<h5>reason</h5>
381<ol><p>Define the reason for the warning.</p></ol>
382
383<h5>description</h5>
384<ol><p>Describe the warning.</p></ol>
385
386 </div>
387<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
388_8c.html" target="source" name="SetErrorHandler">SetErrorHandler</a></h2>
389<div class="doc-section">
390
391<p>SetErrorHandler() sets the exception handler to the specified method and returns the previous exception handler.</p></ol>
392
393<p>The format of the SetErrorHandler method is:</p>
394
395<pre class="code">
396 ErrorHandler SetErrorHandler(ErrorHandler handler)
397</pre>
398
399<p>A description of each parameter follows:</p></ol>
400
401<h5>handler</h5>
402<ol><p>the method to handle errors.</p></ol>
403
404 </div>
405<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
406_8c.html" target="source" name="SetFatalErrorHandler">SetFatalErrorHandler</a></h2>
407<div class="doc-section">
408
409<p>SetFatalErrorHandler() sets the fatal exception handler to the specified method and returns the previous fatal exception handler.</p></ol>
410
411<p>The format of the SetErrorHandler method is:</p>
412
413<pre class="code">
414 ErrorHandler SetErrorHandler(ErrorHandler handler)
415</pre>
416
417<p>A description of each parameter follows:</p></ol>
418
419<h5>handler</h5>
420<ol><p>the method to handle errors.</p></ol>
421
422 </div>
423<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
424_8c.html" target="source" name="SetWarningHandler">SetWarningHandler</a></h2>
425<div class="doc-section">
426
427<p>SetWarningHandler() sets the warning handler to the specified method and returns the previous warning handler.</p></ol>
428
429<p>The format of the SetWarningHandler method is:</p>
430
431<pre class="code">
432 ErrorHandler SetWarningHandler(ErrorHandler handler)
433</pre>
434
435<p>A description of each parameter follows:</p></ol>
436
437<h5>handler</h5>
438<ol><p>the method to handle warnings.</p></ol>
439
440 </div>
441<h2><a href="http://www.imagemagick.org/api/MagickCore/exception
442_8c.html" target="source" name="ThrowException">ThrowException</a></h2>
443<div class="doc-section">
444
445<p>ThrowException() throws an exception with the specified severity code, reason, and optional description.</p></ol>
446
447<p>The format of the ThrowException method is:</p>
448
449<pre class="code">
450 MagickBooleanType ThrowException(ExceptionInfo *exception,
451 const ExceptionType severity,const char *reason,
452 const char *description)
453</pre>
454
455<p>A description of each parameter follows:</p></ol>
456
457<h5>exception</h5>
458<ol><p>the exception info.</p></ol>
459
460<h5>severity</h5>
461<ol><p>the severity of the exception.</p></ol>
462
463<h5>reason</h5>
464<ol><p>the reason for the exception.</p></ol>
465
466<h5>description</h5>
467<ol><p>the exception description.</p></ol>
468
469 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]470
471</div>
472
473<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]474 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]475 <span id="linkbar-center">
476 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]477 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]478 </span>
479 <span id="linkbar-east">&nbsp;</span>
480 </div>
481 <div class="footer">
482 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
483 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
484 </div>
485 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]486 <script type="text/javascript">
487 var _gaq = _gaq || [];
488 _gaq.push(['_setAccount', 'UA-17690367-1']);
489 _gaq.push(['_trackPageview']);
490
491 (function() {
492 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
493 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
494 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
495 })();
496 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]497</body>
498</html>