Home | History | Annotate | Download | only in api
      1 
      2 
      3 
      4 
      5 <!DOCTYPE html>
      6 <html lang="en">
      7 <head>
      8   <meta charset="utf-8"  />
      9   <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no"  />
     10   <title>MagickCore, C API: Working with Image Lists @ ImageMagick</title>
     11   <meta name="application-name" content="ImageMagick" />
     12   <meta name="description" content="Use ImageMagick to create, edit, compose, or convert bitmap images. You can resize your image, crop it, change its shades and colors, add captions, among other operations." />
     13   <meta name="application-url" content="https://imagemagick.org" />
     14   <meta name="generator" content="PHP" />
     15   <meta name="keywords" content="magickcore, c, api:, working, with, image, lists, 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-2019 ImageMagick Studio LLC" />
     23   <meta name="distribution" content="Global" />
     24   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
     25   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
     26   <link href="list.html" rel="canonical" />
     27   <link href="../../images/wand.png" rel="icon" />
     28   <link href="../../images/wand.ico" rel="shortcut icon" />
     29   <link href="../assets/magick.css" rel="stylesheet" />
     30 </head>
     31 <body>
     32   <header>
     33   <nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
     34     <a class="navbar-brand" href="../../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../../images/wand.ico"/></a>
     35     <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsMagick" aria-controls="navbarsMagick" aria-expanded="false" aria-label="Toggle navigation">
     36       <span class="navbar-toggler-icon"></span>
     37     </button>
     38 
     39     <div class="navbar-collapse collapse" id="navbarsMagick" style="">
     40     <ul class="navbar-nav mr-auto">
     41       <li class="nav-item ">
     42         <a class="nav-link" href="quantize.html">Home <span class="sr-only">(current)</span></a>
     43       </li>
     44       <li class="nav-item ">
     45         <a class="nav-link" href="../../www/download.html">Download</a>
     46       </li>
     47       <li class="nav-item ">
     48         <a class="nav-link" href="../../www/command-line-tools.html">Tools</a>
     49       </li>
     50       <li class="nav-item ">
     51         <a class="nav-link" href="../../www/command-line-processing.html">Command-line</a>
     52       </li>
     53       <li class="nav-item ">
     54         <a class="nav-link" href="../../www/resources.html">Resources</a>
     55       </li>
     56       <li class="nav-item ">
     57         <a class="nav-link" href="../../www/develop.html">Develop</a>
     58       </li>
     59       <li class="nav-item">
     60         <a class="nav-link" target="_blank" href="https://imagemagick.org/discourse-server/">Community</a>
     61       </li>
     62     </ul>
     63     <form class="form-inline my-2 my-lg-0" action="https://imagemagick.org/script/search.php">
     64       <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search">
     65       <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button>
     66     </form>
     67     </div>
     68   </nav>
     69   <div class="container">
     70    <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
     71          style="display:block"
     72          data-ad-client="ca-pub-3129977114552745"
     73          data-ad-slot="6345125851"
     74          data-ad-format="auto"></ins>
     75     <script>
     76       (adsbygoogle = window.adsbygoogle || []).push({});
     77     </script>
     78 
     79   </div>
     80   </header>
     81   <main class="container">
     82     <div class="magick-template">
     83 <div class="magick-header">
     84 <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>
     85 
     86 <h2><a href="../../api/MagickCore/list_8c.html" id="AppendImageToList">AppendImageToList</a></h2>
     87 
     88 <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>
     89 
     90 <p>The format of the AppendImageToList method is:</p>
     91 
     92 <pre class="text">
     93 AppendImageToList(Image *images,const Image *image)
     94 </pre>
     95 
     96 <p>A description of each parameter follows:</p>
     97 
     98 <dd>
     99 </dd>
    100 
    101 <dd> </dd>
    102 <dl class="dl-horizontal">
    103 <dt>images</dt>
    104 <dd>the image list to be appended to. </dd>
    105 
    106 <dd> </dd>
    107 <dt>image</dt>
    108 <dd>the appended image or image list. </dd>
    109 
    110 <dd>  </dd>
    111 </dl>
    112 <h2><a href="../../api/MagickCore/list_8c.html" id="CloneImageList">CloneImageList</a></h2>
    113 
    114 <p>CloneImageList() returns a duplicate of the image list.</p>
    115 
    116 <p>The format of the CloneImageList method is:</p>
    117 
    118 <pre class="text">
    119 Image *CloneImageList(const Image *images,ExceptionInfo *exception)
    120 </pre>
    121 
    122 <p>A description of each parameter follows:</p>
    123 
    124 <dd>
    125 </dd>
    126 
    127 <dd> </dd>
    128 <dl class="dl-horizontal">
    129 <dt>images</dt>
    130 <dd>the image list. </dd>
    131 
    132 <dd> </dd>
    133 <dt>exception</dt>
    134 <dd>return any errors or warnings in this structure. </dd>
    135 
    136 <dd>  </dd>
    137 </dl>
    138 <h2><a href="../../api/MagickCore/list_8c.html" id="CloneImages">CloneImages</a></h2>
    139 
    140 <p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
    141 
    142 <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 referred to multiple times to clone them multiple times. Images referred beyond the available number of images in list are ignored.</p>
    143 
    144 <p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p>
    145 
    146 <p>The format of the CloneImages method is:</p>
    147 
    148 <pre class="text">
    149 Image *CloneImages(const Image *images,const char *scenes,
    150   ExceptionInfo *exception)
    151 </pre>
    152 
    153 <p>A description of each parameter follows:</p>
    154 
    155 <dd>
    156 </dd>
    157 
    158 <dd> </dd>
    159 <dl class="dl-horizontal">
    160 <dt>images</dt>
    161 <dd>the image sequence. </dd>
    162 
    163 <dd> </dd>
    164 <dt>scenes</dt>
    165 <dd>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2). </dd>
    166 
    167 <dd> </dd>
    168 <dt>exception</dt>
    169 <dd>return any errors or warnings in this structure. </dd>
    170 
    171 <dd>  </dd>
    172 </dl>
    173 <h2><a href="../../api/MagickCore/list_8c.html" id="DeleteImageFromList">DeleteImageFromList</a></h2>
    174 
    175 <p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p>
    176 
    177 <p>The format of the DeleteImageFromList method is:</p>
    178 
    179 <pre class="text">
    180 DeleteImageFromList(Image **images)
    181 </pre>
    182 
    183 <p>A description of each parameter follows:</p>
    184 
    185 <dd>
    186 </dd>
    187 
    188 <dd> </dd>
    189 <dl class="dl-horizontal">
    190 <dt>images</dt>
    191 <dd>the image list. </dd>
    192 
    193 <dd>  </dd>
    194 </dl>
    195 <h2><a href="../../api/MagickCore/list_8c.html" id="DeleteImages">DeleteImages</a></h2>
    196 
    197 <p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
    198 
    199 <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 referred to multiple times without problems. Image referred beyond the available number of images in list are ignored.</p>
    200 
    201 <p>If the referenced images are in the reverse order, that range will be completely ignored, unlike CloneImages().</p>
    202 
    203 <p>The format of the DeleteImages method is:</p>
    204 
    205 <pre class="text">
    206 DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
    207 </pre>
    208 
    209 <p>A description of each parameter follows:</p>
    210 
    211 <dd>
    212 </dd>
    213 
    214 <dd> </dd>
    215 <dl class="dl-horizontal">
    216 <dt>images</dt>
    217 <dd>the image sequence. </dd>
    218 
    219 <dd> </dd>
    220 <dt>scenes</dt>
    221 <dd>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2). </dd>
    222 
    223 <dd> </dd>
    224 <dt>exception</dt>
    225 <dd>return any errors or warnings in this structure. </dd>
    226 
    227 <dd>  </dd>
    228 </dl>
    229 <h2><a href="../../api/MagickCore/list_8c.html" id="DestroyImageList">DestroyImageList</a></h2>
    230 
    231 <p>DestroyImageList() destroys an image list.</p>
    232 
    233 <p>The format of the DestroyImageList method is:</p>
    234 
    235 <pre class="text">
    236 Image *DestroyImageList(Image *image)
    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>image</dt>
    247 <dd>the image sequence. </dd>
    248 
    249 <dd>  </dd>
    250 </dl>
    251 <h2><a href="../../api/MagickCore/list_8c.html" id="DuplicateImages">DuplicateImages</a></h2>
    252 
    253 <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>
    254 
    255 <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 referred to multiple times without problems. Image referred beyond the available number of images in list are ignored.</p>
    256 
    257 <p>The format of the DuplicateImages method is:</p>
    258 
    259 <pre class="text">
    260 Image *DuplicateImages(Image *images,const size_t number_duplicates,
    261   const char *scenes,ExceptionInfo *exception)
    262 </pre>
    263 
    264 <p>A description of each parameter follows:</p>
    265 
    266 <dd>
    267 </dd>
    268 
    269 <dd> </dd>
    270 <dl class="dl-horizontal">
    271 <dt>images</dt>
    272 <dd>the image sequence. </dd>
    273 
    274 <dd> </dd>
    275 <dt>number_duplicates</dt>
    276 <dd>duplicate the image sequence this number of times. </dd>
    277 
    278 <dd> </dd>
    279 <dt>scenes</dt>
    280 <dd>This character string specifies which scenes to duplicate (e.g. 1,3-5,-2-6,2). </dd>
    281 
    282 <dd> </dd>
    283 <dt>exception</dt>
    284 <dd>return any errors or warnings in this structure. </dd>
    285 
    286 <dd>  </dd>
    287 </dl>
    288 <h2><a href="../../api/MagickCore/list_8c.html" id="GetFirstImageInList">GetFirstImageInList</a></h2>
    289 
    290 <p>GetFirstImageInList() returns a pointer to the first image in the list.</p>
    291 
    292 <p>The format of the GetFirstImageInList method is:</p>
    293 
    294 <pre class="text">
    295 Image *GetFirstImageInList(const Image *images)
    296 </pre>
    297 
    298 <p>A description of each parameter follows:</p>
    299 
    300 <dd>
    301 </dd>
    302 
    303 <dd> </dd>
    304 <dl class="dl-horizontal">
    305 <dt>images</dt>
    306 <dd>the image list. </dd>
    307 
    308 <dd>  </dd>
    309 </dl>
    310 <h2><a href="../../api/MagickCore/list_8c.html" id="GetImageFromList">GetImageFromList</a></h2>
    311 
    312 <p>GetImageFromList() returns an image at the specified index from the image list. Starting with 0 as the first image in the list.</p>
    313 
    314 <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>
    315 
    316 <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>
    317 
    318 <p>The format of the GetImageFromList method is:</p>
    319 
    320 <pre class="text">
    321 Image *GetImageFromList(const Image *images,const ssize_t index)
    322 </pre>
    323 
    324 <p>A description of each parameter follows:</p>
    325 
    326 <dd>
    327 </dd>
    328 
    329 <dd> </dd>
    330 <dl class="dl-horizontal">
    331 <dt>images</dt>
    332 <dd>the image list. </dd>
    333 
    334 <dd> </dd>
    335 <dt>index</dt>
    336 <dd>the position within the list. </dd>
    337 
    338 <dd>  </dd>
    339 </dl>
    340 <h2><a href="../../api/MagickCore/list_8c.html" id="GetImageIndexInList">GetImageIndexInList</a></h2>
    341 
    342 <p>GetImageIndexInList() returns the offset in the list of the specified image.</p>
    343 
    344 <p>The format of the GetImageIndexInList method is:</p>
    345 
    346 <pre class="text">
    347 ssize_t GetImageIndexInList(const Image *images)
    348 </pre>
    349 
    350 <p>A description of each parameter follows:</p>
    351 
    352 <dd>
    353 </dd>
    354 
    355 <dd> </dd>
    356 <dl class="dl-horizontal">
    357 <dt>images</dt>
    358 <dd>the image list. </dd>
    359 
    360 <dd>  </dd>
    361 </dl>
    362 <h2><a href="../../api/MagickCore/list_8c.html" id="GetImageListLength">GetImageListLength</a></h2>
    363 
    364 <p>GetImageListLength() returns the length of the list (the number of images in the list).</p>
    365 
    366 <p>The format of the GetImageListLength method is:</p>
    367 
    368 <pre class="text">
    369 size_t GetImageListLength(const Image *images)
    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>images</dt>
    380 <dd>the image list. </dd>
    381 
    382 <dd>  </dd>
    383 </dl>
    384 <h2><a href="../../api/MagickCore/list_8c.html" id="GetLastImageInList">GetLastImageInList</a></h2>
    385 
    386 <p>GetLastImageInList() returns a pointer to the last image in the list.</p>
    387 
    388 <p>The format of the GetLastImageInList method is:</p>
    389 
    390 <pre class="text">
    391 Image *GetLastImageInList(const Image *images)
    392 </pre>
    393 
    394 <p>A description of each parameter follows:</p>
    395 
    396 <dd>
    397 </dd>
    398 
    399 <dd> </dd>
    400 <dl class="dl-horizontal">
    401 <dt>images</dt>
    402 <dd>the image list. </dd>
    403 
    404 <dd>  </dd>
    405 </dl>
    406 <h2><a href="../../api/MagickCore/list_8c.html" id="GetNextImageInList">GetNextImageInList</a></h2>
    407 
    408 <p>GetNextImageInList() returns the next image in the list.</p>
    409 
    410 <p>The format of the GetNextImageInList method is:</p>
    411 
    412 <pre class="text">
    413 Image *GetNextImageInList(const Image *images)
    414 </pre>
    415 
    416 <p>A description of each parameter follows:</p>
    417 
    418 <dd>
    419 </dd>
    420 
    421 <dd> </dd>
    422 <dl class="dl-horizontal">
    423 <dt>images</dt>
    424 <dd>the image list. </dd>
    425 
    426 <dd>  </dd>
    427 </dl>
    428 <h2><a href="../../api/MagickCore/list_8c.html" id="GetPreviousImageInList">GetPreviousImageInList</a></h2>
    429 
    430 <p>GetPreviousImageInList() returns the previous image in the list.</p>
    431 
    432 <p>The format of the GetPreviousImageInList method is:</p>
    433 
    434 <pre class="text">
    435 Image *GetPreviousImageInList(const Image *images)
    436 </pre>
    437 
    438 <p>A description of each parameter follows:</p>
    439 
    440 <dd>
    441 </dd>
    442 
    443 <dd> </dd>
    444 <dl class="dl-horizontal">
    445 <dt>images</dt>
    446 <dd>the image list. </dd>
    447 
    448 <dd>  </dd>
    449 </dl>
    450 <h2><a href="../../api/MagickCore/list_8c.html" id="ImageListToArray">ImageListToArray</a></h2>
    451 
    452 <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>
    453 
    454 <p>The images remain part of the original image list, with the array providing an alternative means of indexing the image array.</p>
    455 
    456 <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>
    457 
    458 <p>The format of the ImageListToArray method is:</p>
    459 
    460 <pre class="text">
    461 Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
    462 </pre>
    463 
    464 <p>A description of each parameter follows:</p>
    465 
    466 <dd>
    467 </dd>
    468 
    469 <dd> </dd>
    470 <dl class="dl-horizontal">
    471 <dt>image</dt>
    472 <dd>the image list. </dd>
    473 
    474 <dd> </dd>
    475 <dt>exception</dt>
    476 <dd>return any errors or warnings in this structure. </dd>
    477 
    478 <dd>  </dd>
    479 </dl>
    480 <h2><a href="../../api/MagickCore/list_8c.html" id="InsertImageInList">InsertImageInList</a></h2>
    481 
    482 <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>
    483 
    484 <p>The format of the InsertImageInList method is:</p>
    485 
    486 <pre class="text">
    487 InsertImageInList(Image **images,Image *insert)
    488 </pre>
    489 
    490 <p>A description of each parameter follows:</p>
    491 
    492 <dd>
    493 </dd>
    494 
    495 <dd> </dd>
    496 <dl class="dl-horizontal">
    497 <dt>images</dt>
    498 <dd>the image list to insert into. </dd>
    499 
    500 <dd> </dd>
    501 <dt>insert</dt>
    502 <dd>the image list to insert. </dd>
    503 
    504 <dd>  </dd>
    505 </dl>
    506 <h2><a href="../../api/MagickCore/list_8c.html" id="NewImageList">NewImageList</a></h2>
    507 
    508 <p>NewImageList() creates an empty image list.</p>
    509 
    510 <p>The format of the NewImageList method is:</p>
    511 
    512 <pre class="text">
    513 Image *NewImageList(void)
    514 </pre>
    515 
    516 <h2><a href="../../api/MagickCore/list_8c.html" id="PrependImageToList">PrependImageToList</a></h2>
    517 
    518 <p>PrependImageToList() prepends the image to the beginning of the list.</p>
    519 
    520 <p>The format of the PrependImageToList method is:</p>
    521 
    522 <pre class="text">
    523 PrependImageToList(Image *images,Image *image)
    524 </pre>
    525 
    526 <p>A description of each parameter follows:</p>
    527 
    528 <dd>
    529 </dd>
    530 
    531 <dd> </dd>
    532 <dl class="dl-horizontal">
    533 <dt>images</dt>
    534 <dd>the image list. </dd>
    535 
    536 <dd> </dd>
    537 <dt>image</dt>
    538 <dd>the image. </dd>
    539 
    540 <dd>  </dd>
    541 </dl>
    542 <h2><a href="../../api/MagickCore/list_8c.html" id="RemoveImageFromList">RemoveImageFromList</a></h2>
    543 
    544 <p>RemoveImageFromList() removes and returns the image pointed to.</p>
    545 
    546 <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>
    547 
    548 <p>The format of the RemoveImageFromList method is:</p>
    549 
    550 <pre class="text">
    551 Image *RemoveImageFromList(Image **images)
    552 </pre>
    553 
    554 <p>A description of each parameter follows:</p>
    555 
    556 <dd>
    557 </dd>
    558 
    559 <dd> </dd>
    560 <dl class="dl-horizontal">
    561 <dt>images</dt>
    562 <dd>the image list. </dd>
    563 
    564 <dd>  </dd>
    565 </dl>
    566 <h2><a href="../../api/MagickCore/list_8c.html" id="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
    567 
    568 <p>RemoveFirstImageFromList() removes and returns the first image in the list.</p>
    569 
    570 <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>
    571 
    572 <p>The format of the RemoveFirstImageFromList method is:</p>
    573 
    574 <pre class="text">
    575 Image *RemoveFirstImageFromList(Image **images)
    576 </pre>
    577 
    578 <p>A description of each parameter follows:</p>
    579 
    580 <dd>
    581 </dd>
    582 
    583 <dd> </dd>
    584 <dl class="dl-horizontal">
    585 <dt>images</dt>
    586 <dd>the image list. </dd>
    587 
    588 <dd>  </dd>
    589 </dl>
    590 <h2><a href="../../api/MagickCore/list_8c.html" id="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
    591 
    592 <p>RemoveLastImageFromList() removes and returns the last image from the list.</p>
    593 
    594 <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>
    595 
    596 <p>The format of the RemoveLastImageFromList method is:</p>
    597 
    598 <pre class="text">
    599 Image *RemoveLastImageFromList(Image **images)
    600 </pre>
    601 
    602 <p>A description of each parameter follows:</p>
    603 
    604 <dd>
    605 </dd>
    606 
    607 <dd> </dd>
    608 <dl class="dl-horizontal">
    609 <dt>images</dt>
    610 <dd>the image list. </dd>
    611 
    612 <dd>  </dd>
    613 </dl>
    614 <h2><a href="../../api/MagickCore/list_8c.html" id="ReplaceImageInList">ReplaceImageInList</a></h2>
    615 
    616 <p>ReplaceImageInList() replaces an image in the list with the given image, or list of images.  Old image is destroyed.</p>
    617 
    618 <p>The images list pointer is set to point to the first image of the inserted list of images.</p>
    619 
    620 <p>The format of the ReplaceImageInList method is:</p>
    621 
    622 <pre class="text">
    623 ReplaceImageInList(Image **images,Image *replace)
    624 </pre>
    625 
    626 <p>A description of each parameter follows:</p>
    627 
    628 <dd>
    629 </dd>
    630 
    631 <dd> </dd>
    632 <dl class="dl-horizontal">
    633 <dt>images</dt>
    634 <dd>the list and pointer to image to replace </dd>
    635 
    636 <dd> </dd>
    637 <dt>replace</dt>
    638 <dd>the image or image list replacing the original </dd>
    639 
    640 <dd>  </dd>
    641 </dl>
    642 <h2><a href="../../api/MagickCore/list_8c.html" id="ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a></h2>
    643 
    644 <p>ReplaceImageInListReturnLast() is exactly as ReplaceImageInList() except the images pointer is set to the last image in the list of replacement images.</p>
    645 
    646 <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>
    647 
    648 <p>The format of the ReplaceImageInList method is:</p>
    649 
    650 <pre class="text">
    651 ReplaceImageInListReturnLast(Image **images,Image *replace)
    652 </pre>
    653 
    654 <p>A description of each parameter follows:</p>
    655 
    656 <dd>
    657 </dd>
    658 
    659 <dd> </dd>
    660 <dl class="dl-horizontal">
    661 <dt>images</dt>
    662 <dd>the list and pointer to image to replace </dd>
    663 
    664 <dd> </dd>
    665 <dt>replace</dt>
    666 <dd>the image or image list replacing the original </dd>
    667 
    668 <dd>  </dd>
    669 </dl>
    670 <h2><a href="../../api/MagickCore/list_8c.html" id="ReverseImageList">ReverseImageList</a></h2>
    671 
    672 <p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p>
    673 
    674 <p>The format of the ReverseImageList method is:</p>
    675 
    676 <pre class="text">
    677 void ReverseImageList(Image **images)
    678 </pre>
    679 
    680 <p>A description of each parameter follows:</p>
    681 
    682 <dd>
    683 </dd>
    684 
    685 <dd> </dd>
    686 <dl class="dl-horizontal">
    687 <dt>images</dt>
    688 <dd>the image list. </dd>
    689 
    690 <dd>  </dd>
    691 </dl>
    692 <h2><a href="../../api/MagickCore/list_8c.html" id="SpliceImageIntoList">SpliceImageIntoList</a></h2>
    693 
    694 <p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p>
    695 
    696 <p>The format of the SpliceImageIntoList method is:</p>
    697 
    698 <pre class="text">
    699 SpliceImageIntoList(Image **images,const size_t,
    700   const Image *splice)
    701 </pre>
    702 
    703 <p>A description of each parameter follows:</p>
    704 
    705 <dd>
    706 </dd>
    707 
    708 <dd> </dd>
    709 <dl class="dl-horizontal">
    710 <dt>images</dt>
    711 <dd>the image list. </dd>
    712 
    713 <dd> </dd>
    714 <dt>length</dt>
    715 <dd>the length of the image list to remove. </dd>
    716 
    717 <dd> </dd>
    718 <dt>splice</dt>
    719 <dd>Replace the removed image list with this list. </dd>
    720 
    721 <dd>  </dd>
    722 </dl>
    723 <h2><a href="../../api/MagickCore/list_8c.html" id="SplitImageList">SplitImageList</a></h2>
    724 
    725 <p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p>
    726 
    727 <p>The format of the SplitImageList method is:</p>
    728 
    729 <pre class="text">
    730 Image *SplitImageList(Image *images)
    731 </pre>
    732 
    733 <p>A description of each parameter follows:</p>
    734 
    735 <dd>
    736 </dd>
    737 
    738 <dd> </dd>
    739 <dl class="dl-horizontal">
    740 <dt>images</dt>
    741 <dd>the image list. </dd>
    742 
    743 <dd>  </dd>
    744 </dl>
    745 </div>
    746     </div>
    747   </main><!-- /.container -->
    748   <footer class="magick-footer">
    749     <p><a href="../../www/security-policy.html">Security</a> 
    750     <a href="../../www/architecture.html">Architecture</a> 
    751     <a href="../../www/links.html">Related</a> 
    752      <a href="../../www/sitemap.html">Sitemap</a>
    753        
    754     <a href="list.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../../images/wand.ico"/></a>
    755        
    756     <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 
    757     <a href="../../www/support.html">Donate</a> 
    758     <a href="../../www/contact.html">Contact Us</a>
    759     <br/>
    760     <small> 1999-2019 ImageMagick Studio LLC</small></p>
    761   </footer>
    762 
    763   <!-- Javascript assets -->
    764   <script src="../assets/magick.js" crossorigin="anonymous"></script>
    765   <script>window.jQuery || document.write('<script src="https://localhost/ajax/libs/jquery/3.3.1/jquery.min.js"><\/script>')</script>
    766 </body>
    767 </html>
    768 <!-- Magick Cache 3rd January 2019 20:45 -->