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