• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1
2
3
4
5<!DOCTYPE html>
6<html lang="en">
7<head>
8    <title>ImageMagick: MagickWand, C API for ImageMagick: Wand Methods</title>
9  <meta charset="utf-8" />
10  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
11  <meta name="viewport" content="width=device-width, initial-scale=1" />
12  <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
13  <meta name="application-name" content="ImageMagick"/>
14  <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
15  <meta name="application-url" content="http://www.imagemagick.org"/>
16  <meta name="generator" content="PHP"/>
17  <meta name="keywords" content="magickwc, api, for, imagemagick:, wmethods, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
18  <meta name="rating" content="GENERAL"/>
19  <meta name="robots" content="INDEX, FOLLOW"/>
20  <meta name="generator" content="ImageMagick Studio LLC"/>
21  <meta name="author" content="ImageMagick Studio LLC"/>
22  <meta name="revisit-after" content="2 DAYS"/>
23  <meta name="resource-type" content="document"/>
24  <meta name="copyright" content="Copyright (c) 1999-2016 ImageMagick Studio LLC"/>
25  <meta name="distribution" content="Global"/>
26  <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
27  <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
28  <link rel="icon" href="../images/wand.png"/>
29  <link rel="shortcut icon" href="../images/wand.ico"/>
30  <link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:900,400,400italic,700,700italic,300,300italic|Open+Sans:300italic,400italic,700italic,300,400,600,700">
31  <link rel="stylesheet" href="../css/magick.html"/>
32</head>
33<body>
34<div class="main">
35<div class="magick-masthead">
36  <div class="container">
37    <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
38         style="display:block"
39         data-ad-client="ca-pub-3129977114552745"
40         data-ad-slot="6345125851"
41         data-ad-format="auto"></ins>
42    <script>
43      (adsbygoogle = window.adsbygoogle || []).push({});
44    </script>
45    <nav class="magick-nav">
46      <a class="magick-nav-item " href="../index.html">Home</a>
47      <a class="magick-nav-item " href="../binary-releases.html">Download</a>
48      <a class="magick-nav-item " href="../command-line-tools.html">Tools</a>
49      <a class="magick-nav-item " href="../command-line-processing.html">Command-line</a>
50      <a class="magick-nav-item " href="../resources.html">Resources</a>
51      <a class="magick-nav-item " href="api.html">Develop</a>
52      <a class="magick-nav-item " href="http://www.imagemagick.org/script/search.php">Search</a>
53      <a class="magick-nav-item pull-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
54    </nav>
55  </div>
56</div>
57<div class="container">
58<div class="magick-header">
59<p class="text-center"><a href="magick-wand.html#ClearMagickWand">ClearMagickWand</a> &#8226; <a href="magick-wand.html#CloneMagickWand">CloneMagickWand</a> &#8226; <a href="magick-wand.html#DestroyMagickWand">DestroyMagickWand</a> &#8226; <a href="magick-wand.html#IsMagickWand">IsMagickWand</a> &#8226; <a href="magick-wand.html#MagickClearException">MagickClearException</a> &#8226; <a href="magick-wand.html#MagickGetException">MagickGetException</a> &#8226; <a href="magick-wand.html#MagickGetExceptionType">MagickGetExceptionType</a> &#8226; <a href="magick-wand.html#MagickGetIteratorIndex">MagickGetIteratorIndex</a> &#8226; <a href="magick-wand.html#MagickQueryConfigureOption">MagickQueryConfigureOption</a> &#8226; <a href="magick-wand.html#MagickQueryConfigureOptions">MagickQueryConfigureOptions</a> &#8226; <a href="magick-wand.html#MagickQueryFontMetrics">MagickQueryFontMetrics</a> &#8226; <a href="magick-wand.html#MagickQueryMultilineFontMetrics">MagickQueryMultilineFontMetrics</a> &#8226; <a href="magick-wand.html#MagickQueryFonts">MagickQueryFonts</a> &#8226; <a href="magick-wand.html#MagickQueryFormats">MagickQueryFormats</a> &#8226; <a href="magick-wand.html#MagickRelinquishMemory">MagickRelinquishMemory</a> &#8226; <a href="magick-wand.html#MagickResetIterator">MagickResetIterator</a> &#8226; <a href="magick-wand.html#MagickSetFirstIterator">MagickSetFirstIterator</a> &#8226; <a href="magick-wand.html#MagickSetIteratorIndex">MagickSetIteratorIndex</a> &#8226; <a href="magick-wand.html#MagickSetLastIterator">MagickSetLastIterator</a> &#8226; <a href="magick-wand.html#MagickWandGenesis">MagickWandGenesis</a> &#8226; <a href="magick-wand.html#MagickWandTerminus">MagickWandTerminus</a> &#8226; <a href="magick-wand.html#NewMagickWand">NewMagickWand</a> &#8226; <a href="magick-wand.html#NewMagickWandFromImage">NewMagickWandFromImage</a> &#8226; <a href="magick-wand.html#IsMagickWandInstantiated">IsMagickWandInstantiated</a></p>
60
61<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="ClearMagickWand">ClearMagickWand</a></h2>
62
63<p>ClearMagickWand() clears resources associated with the wand, leaving the wand blank, and ready to be used for a new set of images.</p>
64
65<p>The format of the ClearMagickWand method is:</p>
66
67<pre class="text">
68void ClearMagickWand(MagickWand *wand)
69</pre>
70
71<p>A description of each parameter follows:</p>
72
73<dd>
74</dd>
75
76<dd> </dd>
77<dl class="dl-horizontal">
78<dt>wand</dt>
79<dd>the magick wand. </dd>
80
81<dd>  </dd>
82</dl>
83<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="CloneMagickWand">CloneMagickWand</a></h2>
84
85<p>CloneMagickWand() makes an exact copy of the specified wand.</p>
86
87<p>The format of the CloneMagickWand method is:</p>
88
89<pre class="text">
90MagickWand *CloneMagickWand(const MagickWand *wand)
91</pre>
92
93<p>A description of each parameter follows:</p>
94
95<dd>
96</dd>
97
98<dd> </dd>
99<dl class="dl-horizontal">
100<dt>wand</dt>
101<dd>the magick wand. </dd>
102
103<dd>  </dd>
104</dl>
105<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="DestroyMagickWand">DestroyMagickWand</a></h2>
106
107<p>DestroyMagickWand() deallocates memory associated with an MagickWand.</p>
108
109<p>The format of the DestroyMagickWand method is:</p>
110
111<pre class="text">
112MagickWand *DestroyMagickWand(MagickWand *wand)
113</pre>
114
115<p>A description of each parameter follows:</p>
116
117<dd>
118</dd>
119
120<dd> </dd>
121<dl class="dl-horizontal">
122<dt>wand</dt>
123<dd>the magick wand. </dd>
124
125<dd>  </dd>
126</dl>
127<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="IsMagickWand">IsMagickWand</a></h2>
128
129<p>IsMagickWand() returns MagickTrue if the wand is verified as a magick wand.</p>
130
131<p>The format of the IsMagickWand method is:</p>
132
133<pre class="text">
134MagickBooleanType IsMagickWand(const MagickWand *wand)
135</pre>
136
137<p>A description of each parameter follows:</p>
138
139<dd>
140</dd>
141
142<dd> </dd>
143<dl class="dl-horizontal">
144<dt>wand</dt>
145<dd>the magick wand. </dd>
146
147<dd>  </dd>
148</dl>
149<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickClearException">MagickClearException</a></h2>
150
151<p>MagickClearException() clears any exceptions associated with the wand.</p>
152
153<p>The format of the MagickClearException method is:</p>
154
155<pre class="text">
156MagickBooleanType MagickClearException(MagickWand *wand)
157</pre>
158
159<p>A description of each parameter follows:</p>
160
161<dd>
162</dd>
163
164<dd> </dd>
165<dl class="dl-horizontal">
166<dt>wand</dt>
167<dd>the magick wand. </dd>
168
169<dd>  </dd>
170</dl>
171<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickGetException">MagickGetException</a></h2>
172
173<p>MagickGetException() returns the severity, reason, and description of any error that occurs when using other methods in this API.</p>
174
175<p>The format of the MagickGetException method is:</p>
176
177<pre class="text">
178char *MagickGetException(const MagickWand *wand,ExceptionType *severity)
179</pre>
180
181<p>A description of each parameter follows:</p>
182
183<dd>
184</dd>
185
186<dd> </dd>
187<dl class="dl-horizontal">
188<dt>wand</dt>
189<dd>the magick wand. </dd>
190
191<dd> </dd>
192<dt>severity</dt>
193<dd>the severity of the error is returned here. </dd>
194
195<dd>  </dd>
196</dl>
197<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickGetExceptionType">MagickGetExceptionType</a></h2>
198
199<p>MagickGetExceptionType() returns the exception type associated with the wand.  If no exception has occurred, UndefinedExceptionType is returned.</p>
200
201<p>The format of the MagickGetExceptionType method is:</p>
202
203<pre class="text">
204ExceptionType MagickGetExceptionType(const MagickWand *wand)
205</pre>
206
207<p>A description of each parameter follows:</p>
208
209<dd>
210</dd>
211
212<dd> </dd>
213<dl class="dl-horizontal">
214<dt>wand</dt>
215<dd>the magick wand. </dd>
216
217<dd>  </dd>
218</dl>
219<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickGetIteratorIndex">MagickGetIteratorIndex</a></h2>
220
221<p>MagickGetIteratorIndex() returns the position of the iterator in the image list.</p>
222
223<p>The format of the MagickGetIteratorIndex method is:</p>
224
225<pre class="text">
226ssize_t MagickGetIteratorIndex(MagickWand *wand)
227</pre>
228
229<p>A description of each parameter follows:</p>
230
231<dd>
232</dd>
233
234<dd> </dd>
235<dl class="dl-horizontal">
236<dt>wand</dt>
237<dd>the magick wand. </dd>
238
239<dd>  </dd>
240</dl>
241<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickQueryConfigureOption">MagickQueryConfigureOption</a></h2>
242
243<p>MagickQueryConfigureOption() returns the value associated with the specified configure option.</p>
244
245<p>The format of the MagickQueryConfigureOption function is:</p>
246
247<pre class="text">
248char *MagickQueryConfigureOption(const char *option)
249</pre>
250
251<p>A description of each parameter follows:</p>
252
253<dd>
254</dd>
255
256<dd> </dd>
257<dl class="dl-horizontal">
258<dt>option</dt>
259<dd>the option name. </dd>
260
261<dd>  </dd>
262</dl>
263<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickQueryConfigureOptions">MagickQueryConfigureOptions</a></h2>
264
265<p>MagickQueryConfigureOptions() returns any configure options that match the specified pattern (e.g.  "*" for all).  Options include NAME, VERSION, LIB_VERSION, etc.</p>
266
267<p>The format of the MagickQueryConfigureOptions function is:</p>
268
269<pre class="text">
270char **MagickQueryConfigureOptions(const char *pattern,
271  size_t *number_options)
272</pre>
273
274<p>A description of each parameter follows:</p>
275
276<dd>
277</dd>
278
279<dd> </dd>
280<dl class="dl-horizontal">
281<dt>pattern</dt>
282<dd>Specifies a pointer to a text string containing a pattern. </dd>
283
284<dd> </dd>
285<dt>number_options</dt>
286<dd> Returns the number of configure options in the list. </dd>
287
288<dd> </dd>
289
290<dd>  </dd>
291</dl>
292<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickQueryFontMetrics">MagickQueryFontMetrics</a></h2>
293
294<p>MagickQueryFontMetrics() returns a 13 element array representing the following font metrics:</p>
295
296<pre class="text">
297    Element Description
298    -------------------------------------------------
299    0 character width
300    1 character height
301    2 ascender
302    3 descender
303    4 text width
304    5 text height
305    6 maximum horizontal advance
306    7 bounding box: x1
307    8 bounding box: y1
308    9 bounding box: x2
309   10 bounding box: y2
310   11 origin: x
311   12 origin: y
312</pre>
313
314<p>The format of the MagickQueryFontMetrics method is:</p>
315
316<pre class="text">
317double *MagickQueryFontMetrics(MagickWand *wand,
318  const DrawingWand *drawing_wand,const char *text)
319</pre>
320
321<p>A description of each parameter follows:</p>
322
323<dd>
324</dd>
325
326<dd> </dd>
327<dl class="dl-horizontal">
328<dt>wand</dt>
329<dd>the Magick wand. </dd>
330
331<dd> </dd>
332<dt>drawing_wand</dt>
333<dd>the drawing wand. </dd>
334
335<dd> </dd>
336<dt>text</dt>
337<dd>the text. </dd>
338
339<dd>  </dd>
340</dl>
341<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickQueryMultilineFontMetrics">MagickQueryMultilineFontMetrics</a></h2>
342
343<p>MagickQueryMultilineFontMetrics() returns a 13 element array representing the following font metrics:</p>
344
345<pre class="text">
346    Element Description
347    -------------------------------------------------
348    0 character width
349    1 character height
350    2 ascender
351    3 descender
352    4 text width
353    5 text height
354    6 maximum horizontal advance
355    7 bounding box: x1
356    8 bounding box: y1
357    9 bounding box: x2
358   10 bounding box: y2
359   11 origin: x
360   12 origin: y
361</pre>
362
363<p>This method is like MagickQueryFontMetrics() but it returns the maximum text width and height for multiple lines of text.</p>
364
365<p>The format of the MagickQueryFontMetrics method is:</p>
366
367<pre class="text">
368double *MagickQueryMultilineFontMetrics(MagickWand *wand,
369  const DrawingWand *drawing_wand,const char *text)
370</pre>
371
372<p>A description of each parameter follows:</p>
373
374<dd>
375</dd>
376
377<dd> </dd>
378<dl class="dl-horizontal">
379<dt>wand</dt>
380<dd>the Magick wand. </dd>
381
382<dd> </dd>
383<dt>drawing_wand</dt>
384<dd>the drawing wand. </dd>
385
386<dd> </dd>
387<dt>text</dt>
388<dd>the text. </dd>
389
390<dd>  </dd>
391</dl>
392<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickQueryFonts">MagickQueryFonts</a></h2>
393
394<p>MagickQueryFonts() returns any font that match the specified pattern (e.g. "*" for all).</p>
395
396<p>The format of the MagickQueryFonts function is:</p>
397
398<pre class="text">
399char **MagickQueryFonts(const char *pattern,size_t *number_fonts)
400</pre>
401
402<p>A description of each parameter follows:</p>
403
404<dd>
405</dd>
406
407<dd> </dd>
408<dl class="dl-horizontal">
409<dt>pattern</dt>
410<dd>Specifies a pointer to a text string containing a pattern. </dd>
411
412<dd> </dd>
413<dt>number_fonts</dt>
414<dd> Returns the number of fonts in the list. </dd>
415
416<dd> </dd>
417
418<dd>  </dd>
419</dl>
420<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickQueryFormats">MagickQueryFormats</a></h2>
421
422<p>MagickQueryFormats() returns any image formats that match the specified pattern (e.g.  "*" for all).</p>
423
424<p>The format of the MagickQueryFormats function is:</p>
425
426<pre class="text">
427char **MagickQueryFormats(const char *pattern,size_t *number_formats)
428</pre>
429
430<p>A description of each parameter follows:</p>
431
432<dd>
433</dd>
434
435<dd> </dd>
436<dl class="dl-horizontal">
437<dt>pattern</dt>
438<dd>Specifies a pointer to a text string containing a pattern. </dd>
439
440<dd> </dd>
441<dt>number_formats</dt>
442<dd> This integer returns the number of image formats in the list. </dd>
443
444<dd>  </dd>
445</dl>
446<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickRelinquishMemory">MagickRelinquishMemory</a></h2>
447
448<p>MagickRelinquishMemory() relinquishes memory resources returned by such methods as MagickIdentifyImage(), MagickGetException(), etc.</p>
449
450<p>The format of the MagickRelinquishMemory method is:</p>
451
452<pre class="text">
453void *MagickRelinquishMemory(void *resource)
454</pre>
455
456<p>A description of each parameter follows:</p>
457
458<dd>
459</dd>
460
461<dd> </dd>
462<dl class="dl-horizontal">
463<dt>resource</dt>
464<dd>Relinquish the memory associated with this resource. </dd>
465
466<dd>  </dd>
467</dl>
468<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickResetIterator">MagickResetIterator</a></h2>
469
470<p>MagickResetIterator() resets the wand iterator.</p>
471
472<p>It is typically used either before iterating though images, or before calling specific functions such as  MagickAppendImages() to append all images together.</p>
473
474<p>Afterward you can use MagickNextImage() to iterate over all the images in a wand container, starting with the first image.</p>
475
476<p>Using this before MagickAddImages() or MagickReadImages() will cause new images to be inserted between the first and second image.</p>
477
478<p>The format of the MagickResetIterator method is:</p>
479
480<pre class="text">
481void MagickResetIterator(MagickWand *wand)
482</pre>
483
484<p>A description of each parameter follows:</p>
485
486<dd>
487</dd>
488
489<dd> </dd>
490<dl class="dl-horizontal">
491<dt>wand</dt>
492<dd>the magick wand. </dd>
493
494<dd>  </dd>
495</dl>
496<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickSetFirstIterator">MagickSetFirstIterator</a></h2>
497
498<p>MagickSetFirstIterator() sets the wand iterator to the first image.</p>
499
500<p>After using any images added to the wand using MagickAddImage() or MagickReadImage() will be prepended before any image in the wand.</p>
501
502<p>Also the current image has been set to the first image (if any) in the Magick Wand.  Using MagickNextImage() will then set teh current image to the second image in the list (if present).</p>
503
504<p>This operation is similar to MagickResetIterator() but differs in how MagickAddImage(), MagickReadImage(), and MagickNextImage() behaves afterward.</p>
505
506<p>The format of the MagickSetFirstIterator method is:</p>
507
508<pre class="text">
509void MagickSetFirstIterator(MagickWand *wand)
510</pre>
511
512<p>A description of each parameter follows:</p>
513
514<dd>
515</dd>
516
517<dd> </dd>
518<dl class="dl-horizontal">
519<dt>wand</dt>
520<dd>the magick wand. </dd>
521
522<dd>  </dd>
523</dl>
524<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickSetIteratorIndex">MagickSetIteratorIndex</a></h2>
525
526<p>MagickSetIteratorIndex() set the iterator to the given position in the image list specified with the index parameter.  A zero index will set the first image as current, and so on.  Negative indexes can be used to specify an image relative to the end of the images in the wand, with -1 being the last image in the wand.</p>
527
528<p>If the index is invalid (range too large for number of images in wand) the function will return MagickFalse, but no 'exception' will be raised, as it is not actually an error.  In that case the current image will not change.</p>
529
530<p>After using any images added to the wand using MagickAddImage() or MagickReadImage() will be added after the image indexed, regardless of if a zero (first image in list) or negative index (from end) is used.</p>
531
532<p>Jumping to index 0 is similar to MagickResetIterator() but differs in how MagickNextImage() behaves afterward.</p>
533
534<p>The format of the MagickSetIteratorIndex method is:</p>
535
536<pre class="text">
537MagickBooleanType MagickSetIteratorIndex(MagickWand *wand,
538  const ssize_t index)
539</pre>
540
541<p>A description of each parameter follows:</p>
542
543<dd>
544</dd>
545
546<dd> </dd>
547<dl class="dl-horizontal">
548<dt>wand</dt>
549<dd>the magick wand. </dd>
550
551<dd> </dd>
552<dt>index</dt>
553<dd>the scene number. </dd>
554
555<dd>  </dd>
556</dl>
557<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickSetLastIterator">MagickSetLastIterator</a></h2>
558
559<p>MagickSetLastIterator() sets the wand iterator to the last image.</p>
560
561<p>The last image is actually the current image, and the next use of MagickPreviousImage() will not change this allowing this function to be used to iterate over the images in the reverse direction. In this sense it is more like  MagickResetIterator() than MagickSetFirstIterator().</p>
562
563<p>Typically this function is used before MagickAddImage(), MagickReadImage() functions to ensure new images are appended to the very end of wand's image list.</p>
564
565<p>The format of the MagickSetLastIterator method is:</p>
566
567<pre class="text">
568void MagickSetLastIterator(MagickWand *wand)
569</pre>
570
571<p>A description of each parameter follows:</p>
572
573<dd>
574</dd>
575
576<dd> </dd>
577<dl class="dl-horizontal">
578<dt>wand</dt>
579<dd>the magick wand. </dd>
580
581<dd>  </dd>
582</dl>
583<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickWandGenesis">MagickWandGenesis</a></h2>
584
585<p>MagickWandGenesis() initializes the MagickWand environment.</p>
586
587<p>The format of the MagickWandGenesis method is:</p>
588
589<pre class="text">
590void MagickWandGenesis(void)
591</pre>
592
593<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="MagickWandTerminus">MagickWandTerminus</a></h2>
594
595<p>MagickWandTerminus() terminates the MagickWand environment.</p>
596
597<p>The format of the MaickWandTerminus method is:</p>
598
599<pre class="text">
600void MagickWandTerminus(void)
601</pre>
602
603<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="NewMagickWand">NewMagickWand</a></h2>
604
605<p>NewMagickWand() returns a wand required for all other methods in the API. A fatal exception is thrown if there is not enough memory to allocate the wand.   Use DestroyMagickWand() to dispose of the wand when it is no longer needed.</p>
606
607<p>The format of the NewMagickWand method is:</p>
608
609<pre class="text">
610MagickWand *NewMagickWand(void)
611</pre>
612
613<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="NewMagickWandFromImage">NewMagickWandFromImage</a></h2>
614
615<p>NewMagickWandFromImage() returns a wand with an image.</p>
616
617<p>The format of the NewMagickWandFromImage method is:</p>
618
619<pre class="text">
620MagickWand *NewMagickWandFromImage(const Image *image)
621</pre>
622
623<p>A description of each parameter follows:</p>
624
625<dd>
626</dd>
627
628<dd> </dd>
629<dl class="dl-horizontal">
630<dt>image</dt>
631<dd>the image. </dd>
632
633<dd>  </dd>
634</dl>
635<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-wand_8c.html" id="IsMagickWandInstantiated">IsMagickWandInstantiated</a></h2>
636
637<p>IsMagickWandInstantiated() returns MagickTrue if the ImageMagick environment is currently instantiated--  that is, MagickWandGenesis() has been called but MagickWandTerminus() has not.</p>
638
639<p>The format of the IsMagickWandInstantiated method is:</p>
640
641<pre class="text">
642MagickBooleanType IsMagickWandInstantiated(void)
643</pre>
644
645</div>
646  <footer class="magick-footer">
647    <p><a href="../support.html">Donate</a> •
648     <a href="../sitemap.html">Sitemap</a> •
649    <a href="../links.html">Related</a> •
650    <a href="../architecture.html">Architecture</a>
651</p>
652    <p><a href="magick-wand.html#">Back to top</a> •
653    <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
654    <a href="http://www.imagemagick.org/script/contact.php">Contact Us</a></p>
655        <p><small>©  1999-2016 ImageMagick Studio LLC</small></p>
656  </footer>
657</div><!-- /.container -->
658
659  <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
660  <script src="../js/magick.html"></script>
661</div>
662</body>
663</html>
664