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