Home | History | Annotate | Download | only in api
      1 
      2 
      3 
      4 
      5 <!DOCTYPE html>
      6 <html lang="en">
      7 <head>
      8     <title>ImageMagick: MagickCore, C API for ImageMagick: Working with Image Lists</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 Bzier curves."/>
     15   <meta name="application-url" content="http://www.imagemagick.org"/>
     16   <meta name="generator" content="PHP"/>
     17   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, working, with, image, lists, 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="list.html#AppendImageToList">AppendImageToList</a> &#8226; <a href="list.html#CloneImageList">CloneImageList</a> &#8226; <a href="list.html#CloneImages">CloneImages</a> &#8226; <a href="list.html#DeleteImageFromList">DeleteImageFromList</a> &#8226; <a href="list.html#DeleteImages">DeleteImages</a> &#8226; <a href="list.html#DestroyImageList">DestroyImageList</a> &#8226; <a href="list.html#DuplicateImages">DuplicateImages</a> &#8226; <a href="list.html#GetFirstImageInList">GetFirstImageInList</a> &#8226; <a href="list.html#GetImageFromList">GetImageFromList</a> &#8226; <a href="list.html#GetImageIndexInList">GetImageIndexInList</a> &#8226; <a href="list.html#GetImageListLength">GetImageListLength</a> &#8226; <a href="list.html#GetLastImageInList">GetLastImageInList</a> &#8226; <a href="list.html#GetNextImageInList">GetNextImageInList</a> &#8226; <a href="list.html#GetPreviousImageInList">GetPreviousImageInList</a> &#8226; <a href="list.html#ImageListToArray">ImageListToArray</a> &#8226; <a href="list.html#InsertImageInList">InsertImageInList</a> &#8226; <a href="list.html#NewImageList">NewImageList</a> &#8226; <a href="list.html#PrependImageToList">PrependImageToList</a> &#8226; <a href="list.html#RemoveImageFromList">RemoveImageFromList</a> &#8226; <a href="list.html#RemoveFirstImageFromList">RemoveFirstImageFromList</a> &#8226; <a href="list.html#RemoveLastImageFromList">RemoveLastImageFromList</a> &#8226; <a href="list.html#ReplaceImageInList">ReplaceImageInList</a> &#8226; <a href="list.html#ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a> &#8226; <a href="list.html#ReverseImageList">ReverseImageList</a> &#8226; <a href="list.html#SpliceImageIntoList">SpliceImageIntoList</a> &#8226; <a href="list.html#SplitImageList">SplitImageList</a></p>
     60 
     61 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="AppendImageToList">AppendImageToList</a></h2>
     62 
     63 <p>AppendImageToList() appends the second image list to the end of the first list.  The given image list pointer is left unchanged, unless it was empty.</p>
     64 
     65 <p>The format of the AppendImageToList method is:</p>
     66 
     67 <pre class="text">
     68 AppendImageToList(Image *images,const Image *image)
     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>images</dt>
     79 <dd>the image list to be appended to. </dd>
     80 
     81 <dd> </dd>
     82 <dt>image</dt>
     83 <dd>the appended image or image list. </dd>
     84 
     85 <dd>  </dd>
     86 </dl>
     87 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="CloneImageList">CloneImageList</a></h2>
     88 
     89 <p>CloneImageList() returns a duplicate of the image list.</p>
     90 
     91 <p>The format of the CloneImageList method is:</p>
     92 
     93 <pre class="text">
     94 Image *CloneImageList(const Image *images,ExceptionInfo *exception)
     95 </pre>
     96 
     97 <p>A description of each parameter follows:</p>
     98 
     99 <dd>
    100 </dd>
    101 
    102 <dd> </dd>
    103 <dl class="dl-horizontal">
    104 <dt>images</dt>
    105 <dd>the image list. </dd>
    106 
    107 <dd> </dd>
    108 <dt>exception</dt>
    109 <dd>return any errors or warnings in this structure. </dd>
    110 
    111 <dd>  </dd>
    112 </dl>
    113 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="CloneImages">CloneImages</a></h2>
    114 
    115 <p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
    116 
    117 <p>The numbers start at 0 for the first image in the list, while negative numbers refer to images starting counting from the end of the range. Images may be refered to multiple times to clone them multiple times. Images refered beyond the available number of images in list are ignored.</p>
    118 
    119 <p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p>
    120 
    121 <p>The format of the CloneImages method is:</p>
    122 
    123 <pre class="text">
    124 Image *CloneImages(const Image *images,const char *scenes,
    125   ExceptionInfo *exception)
    126 </pre>
    127 
    128 <p>A description of each parameter follows:</p>
    129 
    130 <dd>
    131 </dd>
    132 
    133 <dd> </dd>
    134 <dl class="dl-horizontal">
    135 <dt>images</dt>
    136 <dd>the image sequence. </dd>
    137 
    138 <dd> </dd>
    139 <dt>scenes</dt>
    140 <dd>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2). </dd>
    141 
    142 <dd> </dd>
    143 <dt>exception</dt>
    144 <dd>return any errors or warnings in this structure. </dd>
    145 
    146 <dd>  </dd>
    147 </dl>
    148 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DeleteImageFromList">DeleteImageFromList</a></h2>
    149 
    150 <p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p>
    151 
    152 <p>The format of the DeleteImageFromList method is:</p>
    153 
    154 <pre class="text">
    155 DeleteImageFromList(Image **images)
    156 </pre>
    157 
    158 <p>A description of each parameter follows:</p>
    159 
    160 <dd>
    161 </dd>
    162 
    163 <dd> </dd>
    164 <dl class="dl-horizontal">
    165 <dt>images</dt>
    166 <dd>the image list. </dd>
    167 
    168 <dd>  </dd>
    169 </dl>
    170 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DeleteImages">DeleteImages</a></h2>
    171 
    172 <p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
    173 
    174 <p>The numbers start at 0 for the first image, while negative numbers refer to images starting counting from the end of the range. Images may be refered to multiple times without problems. Image refered beyond the available number of images in list are ignored.</p>
    175 
    176 <p>If the referenced images are in the reverse order, that range will be completely ignored, unlike CloneImages().</p>
    177 
    178 <p>The format of the DeleteImages method is:</p>
    179 
    180 <pre class="text">
    181 DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
    182 </pre>
    183 
    184 <p>A description of each parameter follows:</p>
    185 
    186 <dd>
    187 </dd>
    188 
    189 <dd> </dd>
    190 <dl class="dl-horizontal">
    191 <dt>images</dt>
    192 <dd>the image sequence. </dd>
    193 
    194 <dd> </dd>
    195 <dt>scenes</dt>
    196 <dd>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2). </dd>
    197 
    198 <dd> </dd>
    199 <dt>exception</dt>
    200 <dd>return any errors or warnings in this structure. </dd>
    201 
    202 <dd>  </dd>
    203 </dl>
    204 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DestroyImageList">DestroyImageList</a></h2>
    205 
    206 <p>DestroyImageList() destroys an image list.</p>
    207 
    208 <p>The format of the DestroyImageList method is:</p>
    209 
    210 <pre class="text">
    211 Image *DestroyImageList(Image *image)
    212 </pre>
    213 
    214 <p>A description of each parameter follows:</p>
    215 
    216 <dd>
    217 </dd>
    218 
    219 <dd> </dd>
    220 <dl class="dl-horizontal">
    221 <dt>image</dt>
    222 <dd>the image sequence. </dd>
    223 
    224 <dd>  </dd>
    225 </dl>
    226 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DuplicateImages">DuplicateImages</a></h2>
    227 
    228 <p>DuplicateImages() duplicates one or more images from an image sequence, using a count and a comma separated list of image numbers or ranges.</p>
    229 
    230 <p>The numbers start at 0 for the first image, while negative numbers refer to images starting counting from the end of the range. Images may be refered to multiple times without problems. Image refered beyond the available number of images in list are ignored.</p>
    231 
    232 <p>The format of the DuplicateImages method is:</p>
    233 
    234 <pre class="text">
    235 Image *DuplicateImages(Image *images,const size_t number_duplicates,
    236   const char *scenes,ExceptionInfo *exception)
    237 </pre>
    238 
    239 <p>A description of each parameter follows:</p>
    240 
    241 <dd>
    242 </dd>
    243 
    244 <dd> </dd>
    245 <dl class="dl-horizontal">
    246 <dt>images</dt>
    247 <dd>the image sequence. </dd>
    248 
    249 <dd> </dd>
    250 <dt>number_duplicates</dt>
    251 <dd>duplicate the image sequence this number of times. </dd>
    252 
    253 <dd> </dd>
    254 <dt>scenes</dt>
    255 <dd>This character string specifies which scenes to duplicate (e.g. 1,3-5,-2-6,2). </dd>
    256 
    257 <dd> </dd>
    258 <dt>exception</dt>
    259 <dd>return any errors or warnings in this structure. </dd>
    260 
    261 <dd>  </dd>
    262 </dl>
    263 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetFirstImageInList">GetFirstImageInList</a></h2>
    264 
    265 <p>GetFirstImageInList() returns a pointer to the first image in the list.</p>
    266 
    267 <p>The format of the GetFirstImageInList method is:</p>
    268 
    269 <pre class="text">
    270 Image *GetFirstImageInList(const Image *images)
    271 </pre>
    272 
    273 <p>A description of each parameter follows:</p>
    274 
    275 <dd>
    276 </dd>
    277 
    278 <dd> </dd>
    279 <dl class="dl-horizontal">
    280 <dt>images</dt>
    281 <dd>the image list. </dd>
    282 
    283 <dd>  </dd>
    284 </dl>
    285 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageFromList">GetImageFromList</a></h2>
    286 
    287 <p>GetImageFromList() returns an image at the specified index from the image list. Starting with 0 as the first image in the list.</p>
    288 
    289 <p>A negative offset will return the image from the end of the list, such that an index of -1 is the last image.</p>
    290 
    291 <p>If no such image exists at the specified offset a NULL image pointer is returned.  This will only happen if index is less that the negative of the list length, or larger than list length -1.  EG: ( -N to N-1 )</p>
    292 
    293 <p>The format of the GetImageFromList method is:</p>
    294 
    295 <pre class="text">
    296 Image *GetImageFromList(const Image *images,const ssize_t index)
    297 </pre>
    298 
    299 <p>A description of each parameter follows:</p>
    300 
    301 <dd>
    302 </dd>
    303 
    304 <dd> </dd>
    305 <dl class="dl-horizontal">
    306 <dt>images</dt>
    307 <dd>the image list. </dd>
    308 
    309 <dd> </dd>
    310 <dt>index</dt>
    311 <dd>the position within the list. </dd>
    312 
    313 <dd>  </dd>
    314 </dl>
    315 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageIndexInList">GetImageIndexInList</a></h2>
    316 
    317 <p>GetImageIndexInList() returns the offset in the list of the specified image.</p>
    318 
    319 <p>The format of the GetImageIndexInList method is:</p>
    320 
    321 <pre class="text">
    322 ssize_t GetImageIndexInList(const Image *images)
    323 </pre>
    324 
    325 <p>A description of each parameter follows:</p>
    326 
    327 <dd>
    328 </dd>
    329 
    330 <dd> </dd>
    331 <dl class="dl-horizontal">
    332 <dt>images</dt>
    333 <dd>the image list. </dd>
    334 
    335 <dd>  </dd>
    336 </dl>
    337 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageListLength">GetImageListLength</a></h2>
    338 
    339 <p>GetImageListLength() returns the length of the list (the number of images in the list).</p>
    340 
    341 <p>The format of the GetImageListLength method is:</p>
    342 
    343 <pre class="text">
    344 size_t GetImageListLength(const Image *images)
    345 </pre>
    346 
    347 <p>A description of each parameter follows:</p>
    348 
    349 <dd>
    350 </dd>
    351 
    352 <dd> </dd>
    353 <dl class="dl-horizontal">
    354 <dt>images</dt>
    355 <dd>the image list. </dd>
    356 
    357 <dd>  </dd>
    358 </dl>
    359 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetLastImageInList">GetLastImageInList</a></h2>
    360 
    361 <p>GetLastImageInList() returns a pointer to the last image in the list.</p>
    362 
    363 <p>The format of the GetLastImageInList method is:</p>
    364 
    365 <pre class="text">
    366 Image *GetLastImageInList(const Image *images)
    367 </pre>
    368 
    369 <p>A description of each parameter follows:</p>
    370 
    371 <dd>
    372 </dd>
    373 
    374 <dd> </dd>
    375 <dl class="dl-horizontal">
    376 <dt>images</dt>
    377 <dd>the image list. </dd>
    378 
    379 <dd>  </dd>
    380 </dl>
    381 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetNextImageInList">GetNextImageInList</a></h2>
    382 
    383 <p>GetNextImageInList() returns the next image in the list.</p>
    384 
    385 <p>The format of the GetNextImageInList method is:</p>
    386 
    387 <pre class="text">
    388 Image *GetNextImageInList(const Image *images)
    389 </pre>
    390 
    391 <p>A description of each parameter follows:</p>
    392 
    393 <dd>
    394 </dd>
    395 
    396 <dd> </dd>
    397 <dl class="dl-horizontal">
    398 <dt>images</dt>
    399 <dd>the image list. </dd>
    400 
    401 <dd>  </dd>
    402 </dl>
    403 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetPreviousImageInList">GetPreviousImageInList</a></h2>
    404 
    405 <p>GetPreviousImageInList() returns the previous image in the list.</p>
    406 
    407 <p>The format of the GetPreviousImageInList method is:</p>
    408 
    409 <pre class="text">
    410 Image *GetPreviousImageInList(const Image *images)
    411 </pre>
    412 
    413 <p>A description of each parameter follows:</p>
    414 
    415 <dd>
    416 </dd>
    417 
    418 <dd> </dd>
    419 <dl class="dl-horizontal">
    420 <dt>images</dt>
    421 <dd>the image list. </dd>
    422 
    423 <dd>  </dd>
    424 </dl>
    425 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ImageListToArray">ImageListToArray</a></h2>
    426 
    427 <p>ImageListToArray() is a convenience method that converts an image list to a sequential array, with a NULL image pointer at the end of the array.</p>
    428 
    429 <p>The images remain part of the original image list, with the array providing an alternative means of indexing the image array.</p>
    430 
    431 <p>group = ImageListToArray(images, exception); while (i = 0; group[i] != (Image *) NULL; i++) printf("s\n", group[i]-&gt;filename); printf("d images\n", i); group = RelinquishMagickMemory(group);</p>
    432 
    433 <p>The format of the ImageListToArray method is:</p>
    434 
    435 <pre class="text">
    436 Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
    437 </pre>
    438 
    439 <p>A description of each parameter follows:</p>
    440 
    441 <dd>
    442 </dd>
    443 
    444 <dd> </dd>
    445 <dl class="dl-horizontal">
    446 <dt>image</dt>
    447 <dd>the image list. </dd>
    448 
    449 <dd> </dd>
    450 <dt>exception</dt>
    451 <dd>return any errors or warnings in this structure. </dd>
    452 
    453 <dd>  </dd>
    454 </dl>
    455 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="InsertImageInList">InsertImageInList</a></h2>
    456 
    457 <p>InsertImageInList() insert the given image or image list, into the first image list, immediately AFTER the image pointed to.  The given image list pointer is left unchanged unless previously empty.</p>
    458 
    459 <p>The format of the InsertImageInList method is:</p>
    460 
    461 <pre class="text">
    462 InsertImageInList(Image **images,Image *insert)
    463 </pre>
    464 
    465 <p>A description of each parameter follows:</p>
    466 
    467 <dd>
    468 </dd>
    469 
    470 <dd> </dd>
    471 <dl class="dl-horizontal">
    472 <dt>images</dt>
    473 <dd>the image list to insert into. </dd>
    474 
    475 <dd> </dd>
    476 <dt>insert</dt>
    477 <dd>the image list to insert. </dd>
    478 
    479 <dd>  </dd>
    480 </dl>
    481 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="NewImageList">NewImageList</a></h2>
    482 
    483 <p>NewImageList() creates an empty image list.</p>
    484 
    485 <p>The format of the NewImageList method is:</p>
    486 
    487 <pre class="text">
    488 Image *NewImageList(void)
    489 </pre>
    490 
    491 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="PrependImageToList">PrependImageToList</a></h2>
    492 
    493 <p>PrependImageToList() prepends the image to the beginning of the list.</p>
    494 
    495 <p>The format of the PrependImageToList method is:</p>
    496 
    497 <pre class="text">
    498 PrependImageToList(Image *images,Image *image)
    499 </pre>
    500 
    501 <p>A description of each parameter follows:</p>
    502 
    503 <dd>
    504 </dd>
    505 
    506 <dd> </dd>
    507 <dl class="dl-horizontal">
    508 <dt>images</dt>
    509 <dd>the image list. </dd>
    510 
    511 <dd> </dd>
    512 <dt>image</dt>
    513 <dd>the image. </dd>
    514 
    515 <dd>  </dd>
    516 </dl>
    517 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveImageFromList">RemoveImageFromList</a></h2>
    518 
    519 <p>RemoveImageFromList() removes and returns the image pointed to.</p>
    520 
    521 <p>The given image list pointer is set to point to the next image in list if it exists, otherwise it is set to the previous image, or NULL if list was emptied.</p>
    522 
    523 <p>The format of the RemoveImageFromList method is:</p>
    524 
    525 <pre class="text">
    526 Image *RemoveImageFromList(Image **images)
    527 </pre>
    528 
    529 <p>A description of each parameter follows:</p>
    530 
    531 <dd>
    532 </dd>
    533 
    534 <dd> </dd>
    535 <dl class="dl-horizontal">
    536 <dt>images</dt>
    537 <dd>the image list. </dd>
    538 
    539 <dd>  </dd>
    540 </dl>
    541 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
    542 
    543 <p>RemoveFirstImageFromList() removes and returns the first image in the list.</p>
    544 
    545 <p>If the given image list pointer pointed to the removed first image, it is set to the new first image of list, or NULL if list was emptied, otherwise it is left as is.</p>
    546 
    547 <p>The format of the RemoveFirstImageFromList method is:</p>
    548 
    549 <pre class="text">
    550 Image *RemoveFirstImageFromList(Image **images)
    551 </pre>
    552 
    553 <p>A description of each parameter follows:</p>
    554 
    555 <dd>
    556 </dd>
    557 
    558 <dd> </dd>
    559 <dl class="dl-horizontal">
    560 <dt>images</dt>
    561 <dd>the image list. </dd>
    562 
    563 <dd>  </dd>
    564 </dl>
    565 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
    566 
    567 <p>RemoveLastImageFromList() removes and returns the last image from the list.</p>
    568 
    569 <p>If the given image list pointer pointed to the removed last image, it is set to the new last image of list, or NULL if list was emptied, otherwise it is left as is.</p>
    570 
    571 <p>The format of the RemoveLastImageFromList method is:</p>
    572 
    573 <pre class="text">
    574 Image *RemoveLastImageFromList(Image **images)
    575 </pre>
    576 
    577 <p>A description of each parameter follows:</p>
    578 
    579 <dd>
    580 </dd>
    581 
    582 <dd> </dd>
    583 <dl class="dl-horizontal">
    584 <dt>images</dt>
    585 <dd>the image list. </dd>
    586 
    587 <dd>  </dd>
    588 </dl>
    589 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReplaceImageInList">ReplaceImageInList</a></h2>
    590 
    591 <p>ReplaceImageInList() replaces an image in the list with the given image, or list of images.  Old image is destroyed.</p>
    592 
    593 <p>The images list pointer is set to point to the first image of the inserted list of images.</p>
    594 
    595 <p>The format of the ReplaceImageInList method is:</p>
    596 
    597 <pre class="text">
    598 ReplaceImageInList(Image **images,Image *replace)
    599 </pre>
    600 
    601 <p>A description of each parameter follows:</p>
    602 
    603 <dd>
    604 </dd>
    605 
    606 <dd> </dd>
    607 <dl class="dl-horizontal">
    608 <dt>images</dt>
    609 <dd>the list and pointer to image to replace </dd>
    610 
    611 <dd> </dd>
    612 <dt>replace</dt>
    613 <dd>the image or image list replacing the original </dd>
    614 
    615 <dd>  </dd>
    616 </dl>
    617 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a></h2>
    618 
    619 <p>ReplaceImageInListReturnLast() is exactly as ReplaceImageInList() except the images pointer is set to the last image in the list of replacemen images.</p>
    620 
    621 <p>This allows you to simply use GetNextImageInList() to go to the image that follows the just replaced image, even if a list of replacement images was inserted.</p>
    622 
    623 <p>The format of the ReplaceImageInList method is:</p>
    624 
    625 <pre class="text">
    626 ReplaceImageInListReturnLast(Image **images,Image *replace)
    627 </pre>
    628 
    629 <p>A description of each parameter follows:</p>
    630 
    631 <dd>
    632 </dd>
    633 
    634 <dd> </dd>
    635 <dl class="dl-horizontal">
    636 <dt>images</dt>
    637 <dd>the list and pointer to image to replace </dd>
    638 
    639 <dd> </dd>
    640 <dt>replace</dt>
    641 <dd>the image or image list replacing the original </dd>
    642 
    643 <dd>  </dd>
    644 </dl>
    645 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReverseImageList">ReverseImageList</a></h2>
    646 
    647 <p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p>
    648 
    649 <p>The format of the ReverseImageList method is:</p>
    650 
    651 <pre class="text">
    652 void ReverseImageList(Image **images)
    653 </pre>
    654 
    655 <p>A description of each parameter follows:</p>
    656 
    657 <dd>
    658 </dd>
    659 
    660 <dd> </dd>
    661 <dl class="dl-horizontal">
    662 <dt>images</dt>
    663 <dd>the image list. </dd>
    664 
    665 <dd>  </dd>
    666 </dl>
    667 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="SpliceImageIntoList">SpliceImageIntoList</a></h2>
    668 
    669 <p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p>
    670 
    671 <p>The format of the SpliceImageIntoList method is:</p>
    672 
    673 <pre class="text">
    674 SpliceImageIntoList(Image **images,const size_t,
    675   const Image *splice)
    676 </pre>
    677 
    678 <p>A description of each parameter follows:</p>
    679 
    680 <dd>
    681 </dd>
    682 
    683 <dd> </dd>
    684 <dl class="dl-horizontal">
    685 <dt>images</dt>
    686 <dd>the image list. </dd>
    687 
    688 <dd> </dd>
    689 <dt>length</dt>
    690 <dd>the length of the image list to remove. </dd>
    691 
    692 <dd> </dd>
    693 <dt>splice</dt>
    694 <dd>Replace the removed image list with this list. </dd>
    695 
    696 <dd>  </dd>
    697 </dl>
    698 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="SplitImageList">SplitImageList</a></h2>
    699 
    700 <p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p>
    701 
    702 <p>The format of the SplitImageList method is:</p>
    703 
    704 <pre class="text">
    705 Image *SplitImageList(Image *images)
    706 </pre>
    707 
    708 <p>A description of each parameter follows:</p>
    709 
    710 <dd>
    711 </dd>
    712 
    713 <dd> </dd>
    714 <dl class="dl-horizontal">
    715 <dt>images</dt>
    716 <dd>the image list. </dd>
    717 
    718 <dd>  </dd>
    719 </dl>
    720 </div>
    721   <footer class="magick-footer">
    722     <p><a href="../support.html">Donate</a> 
    723      <a href="../sitemap.html">Sitemap</a> 
    724     <a href="../links.html">Related</a> 
    725     <a href="../architecture.html">Architecture</a>
    726 </p>
    727     <p><a href="list.html#">Back to top</a> 
    728     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 
    729     <a href="http://www.imagemagick.org/script/contact.php">Contact Us</a></p>
    730         <p><small>  1999-2016 ImageMagick Studio LLC</small></p>
    731   </footer>
    732 </div><!-- /.container -->
    733 
    734   <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
    735   <script src="../js/magick.html"></script>
    736 </div>
    737 </body>
    738 </html>
    739