granicus.if.org Git - imagemagick/blob - www/api/list.html

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4   <meta charset="utf-8">
   5   <meta http-equiv="X-UA-Compatible" content="IE=edge">
   6   <meta name="viewport" content="width=device-width, initial-scale=1">
   7   <title>ImageMagick: MagickCore, C API for ImageMagick: Working with Image Lists</title>
   8   <meta http-equiv="content-language" content="en-US">
   9   <meta http-equiv="content-type" content="text/html; charset=utf-8">
  10   <meta http-equiv="reply-to" content="magick-users@imagemagick.org">
  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 Bézier curves.">
  13   <meta name="application-url" content="http://www.imagemagick.org">
  14   <meta name="generator" content="PHP">
  15   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, 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-2015 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="../images/wand.png">
  26   <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon">
  27   <link rel="stylesheet" href="../css/bootstrap.min.css">
  28   <link rel="stylesheet" href="../css/magick.css">
  29 </head>
  30
  31 <body>
  32 <div class="main">
  33 <div class="magick-masthead">
  34   <div class="container">
  35     <script type="text/javascript">
  36     <!--
  37       google_ad_client = "pub-3129977114552745";
  38       google_ad_slot = "5439289906";
  39       google_ad_width = 728;
  40       google_ad_height = 90;
  41     //-->
  42     </script>
  43     <center><script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
  44     </script></center>
  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">Downloads</a>
  48       <a class="magick-nav-item " href="../command-line-tools.html">Tools</a>
  49       <a class="magick-nav-item " href="../command-line-options.html">Options</a>
  50       <a class="magick-nav-item " href="api.html">Development</a>
  51       <a class="magick-nav-item" href="http://www.imagemagick.org/discourse-server/">Community</a>
  52       <a class="magick-nav-item navbar-right " href="http://www.imagemagick.org/script/search.php">Search</a>
  53     </nav>
  54   </div>
  55 </div>
  56 <div class="container">
  57 <div class="magick-header">
  58 <p class="text-center"><a href="list.html#AppendImageToList">AppendImageToList</a> • <a href="list.html#CloneImageList">CloneImageList</a> • <a href="list.html#CloneImages">CloneImages</a> • <a href="list.html#DeleteImageFromList">DeleteImageFromList</a> • <a href="list.html#DeleteImages">DeleteImages</a> • <a href="list.html#DestroyImageList">DestroyImageList</a> • <a href="list.html#DuplicateImages">DuplicateImages</a> • <a href="list.html#GetFirstImageInList">GetFirstImageInList</a> • <a href="list.html#GetImageFromList">GetImageFromList</a> • <a href="list.html#GetImageIndexInList">GetImageIndexInList</a> • <a href="list.html#GetImageListLength">GetImageListLength</a> • <a href="list.html#GetLastImageInList">GetLastImageInList</a> • <a href="list.html#GetNextImageInList">GetNextImageInList</a> • <a href="list.html#GetPreviousImageInList">GetPreviousImageInList</a> • <a href="list.html#ImageListToArray">ImageListToArray</a> • <a href="list.html#InsertImageInList">InsertImageInList</a> • <a href="list.html#NewImageList">NewImageList</a> • <a href="list.html#PrependImageToList">PrependImageToList</a> • <a href="list.html#RemoveImageFromList">RemoveImageFromList</a> • <a href="list.html#RemoveFirstImageFromList">RemoveFirstImageFromList</a> • <a href="list.html#RemoveLastImageFromList">RemoveLastImageFromList</a> • <a href="list.html#ReplaceImageInList">ReplaceImageInList</a> • <a href="list.html#ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a> • <a href="list.html#ReverseImageList">ReverseImageList</a> • <a href="list.html#SpliceImageIntoList">SpliceImageIntoList</a> • <a href="list.html#SplitImageList">SplitImageList</a></p>
  59
  60 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="AppendImageToList">AppendImageToList</a></h2>
  61
  62 <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>
  63
  64 <p>The format of the AppendImageToList method is:</p>
  65
  66 <pre class="text">
  67 AppendImageToList(Image *images,const Image *image)
  68 </pre>
  69
  70 <p>A description of each parameter follows:</p>
  71
  72 <dd>
  73 </dd>
  74
  75 <dd> </dd>
  76 <dl class="dl-horizontal">
  77 <dt>images</dt>
  78 <dd>the image list to be appended to. </dd>
  79
  80 <dd> </dd>
  81 <dt>image</dt>
  82 <dd>the appended image or image list. </dd>
  83
  84 <dd>  </dd>
  85 </dl>
  86 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="CloneImageList">CloneImageList</a></h2>
  87
  88 <p>CloneImageList() returns a duplicate of the image list.</p>
  89
  90 <p>The format of the CloneImageList method is:</p>
  91
  92 <pre class="text">
  93 Image *CloneImageList(const Image *images,ExceptionInfo *exception)
  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. </dd>
 105
 106 <dd> </dd>
 107 <dt>exception</dt>
 108 <dd>return any errors or warnings in this structure. </dd>
 109
 110 <dd>  </dd>
 111 </dl>
 112 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="CloneImages">CloneImages</a></h2>
 113
 114 <p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
 115
 116 <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>
 117
 118 <p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p>
 119
 120 <p>The format of the CloneImages method is:</p>
 121
 122 <pre class="text">
 123 Image *CloneImages(const Image *images,const char *scenes,
 124   ExceptionInfo *exception)
 125 </pre>
 126
 127 <p>A description of each parameter follows:</p>
 128
 129 <dd>
 130 </dd>
 131
 132 <dd> </dd>
 133 <dl class="dl-horizontal">
 134 <dt>images</dt>
 135 <dd>the image sequence. </dd>
 136
 137 <dd> </dd>
 138 <dt>scenes</dt>
 139 <dd>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2). </dd>
 140
 141 <dd> </dd>
 142 <dt>exception</dt>
 143 <dd>return any errors or warnings in this structure. </dd>
 144
 145 <dd>  </dd>
 146 </dl>
 147 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DeleteImageFromList">DeleteImageFromList</a></h2>
 148
 149 <p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p>
 150
 151 <p>The format of the DeleteImageFromList method is:</p>
 152
 153 <pre class="text">
 154 DeleteImageFromList(Image **images)
 155 </pre>
 156
 157 <p>A description of each parameter follows:</p>
 158
 159 <dd>
 160 </dd>
 161
 162 <dd> </dd>
 163 <dl class="dl-horizontal">
 164 <dt>images</dt>
 165 <dd>the image list. </dd>
 166
 167 <dd>  </dd>
 168 </dl>
 169 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DeleteImages">DeleteImages</a></h2>
 170
 171 <p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
 172
 173 <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>
 174
 175 <p>If the referenced images are in the reverse order, that range will be completely ignored, unlike CloneImages().</p>
 176
 177 <p>The format of the DeleteImages method is:</p>
 178
 179 <pre class="text">
 180 DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
 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 sequence. </dd>
 192
 193 <dd> </dd>
 194 <dt>scenes</dt>
 195 <dd>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2). </dd>
 196
 197 <dd> </dd>
 198 <dt>exception</dt>
 199 <dd>return any errors or warnings in this structure. </dd>
 200
 201 <dd>  </dd>
 202 </dl>
 203 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DestroyImageList">DestroyImageList</a></h2>
 204
 205 <p>DestroyImageList() destroys an image list.</p>
 206
 207 <p>The format of the DestroyImageList method is:</p>
 208
 209 <pre class="text">
 210 Image *DestroyImageList(Image *image)
 211 </pre>
 212
 213 <p>A description of each parameter follows:</p>
 214
 215 <dd>
 216 </dd>
 217
 218 <dd> </dd>
 219 <dl class="dl-horizontal">
 220 <dt>image</dt>
 221 <dd>the image sequence. </dd>
 222
 223 <dd>  </dd>
 224 </dl>
 225 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DuplicateImages">DuplicateImages</a></h2>
 226
 227 <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>
 228
 229 <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>
 230
 231 <p>The format of the DuplicateImages method is:</p>
 232
 233 <pre class="text">
 234 Image *DuplicateImages(Image *images,const size_t number_duplicates,
 235   const char *scenes,ExceptionInfo *exception)
 236 </pre>
 237
 238 <p>A description of each parameter follows:</p>
 239
 240 <dd>
 241 </dd>
 242
 243 <dd> </dd>
 244 <dl class="dl-horizontal">
 245 <dt>images</dt>
 246 <dd>the image sequence. </dd>
 247
 248 <dd> </dd>
 249 <dt>number_duplicates</dt>
 250 <dd>duplicate the image sequence this number of times. </dd>
 251
 252 <dd> </dd>
 253 <dt>scenes</dt>
 254 <dd>This character string specifies which scenes to duplicate (e.g. 1,3-5,-2-6,2). </dd>
 255
 256 <dd> </dd>
 257 <dt>exception</dt>
 258 <dd>return any errors or warnings in this structure. </dd>
 259
 260 <dd>  </dd>
 261 </dl>
 262 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetFirstImageInList">GetFirstImageInList</a></h2>
 263
 264 <p>GetFirstImageInList() returns a pointer to the first image in the list.</p>
 265
 266 <p>The format of the GetFirstImageInList method is:</p>
 267
 268 <pre class="text">
 269 Image *GetFirstImageInList(const Image *images)
 270 </pre>
 271
 272 <p>A description of each parameter follows:</p>
 273
 274 <dd>
 275 </dd>
 276
 277 <dd> </dd>
 278 <dl class="dl-horizontal">
 279 <dt>images</dt>
 280 <dd>the image list. </dd>
 281
 282 <dd>  </dd>
 283 </dl>
 284 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageFromList">GetImageFromList</a></h2>
 285
 286 <p>GetImageFromList() returns an image at the specified index from the image list. Starting with 0 as the first image in the list.</p>
 287
 288 <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>
 289
 290 <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>
 291
 292 <p>The format of the GetImageFromList method is:</p>
 293
 294 <pre class="text">
 295 Image *GetImageFromList(const Image *images,const ssize_t index)
 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 <dt>index</dt>
 310 <dd>the position within the list. </dd>
 311
 312 <dd>  </dd>
 313 </dl>
 314 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageIndexInList">GetImageIndexInList</a></h2>
 315
 316 <p>GetImageIndexInList() returns the offset in the list of the specified image.</p>
 317
 318 <p>The format of the GetImageIndexInList method is:</p>
 319
 320 <pre class="text">
 321 ssize_t GetImageIndexInList(const Image *images)
 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 </dl>
 336 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageListLength">GetImageListLength</a></h2>
 337
 338 <p>GetImageListLength() returns the length of the list (the number of images in the list).</p>
 339
 340 <p>The format of the GetImageListLength method is:</p>
 341
 342 <pre class="text">
 343 size_t GetImageListLength(const Image *images)
 344 </pre>
 345
 346 <p>A description of each parameter follows:</p>
 347
 348 <dd>
 349 </dd>
 350
 351 <dd> </dd>
 352 <dl class="dl-horizontal">
 353 <dt>images</dt>
 354 <dd>the image list. </dd>
 355
 356 <dd>  </dd>
 357 </dl>
 358 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetLastImageInList">GetLastImageInList</a></h2>
 359
 360 <p>GetLastImageInList() returns a pointer to the last image in the list.</p>
 361
 362 <p>The format of the GetLastImageInList method is:</p>
 363
 364 <pre class="text">
 365 Image *GetLastImageInList(const Image *images)
 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>images</dt>
 376 <dd>the image list. </dd>
 377
 378 <dd>  </dd>
 379 </dl>
 380 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetNextImageInList">GetNextImageInList</a></h2>
 381
 382 <p>GetNextImageInList() returns the next image in the list.</p>
 383
 384 <p>The format of the GetNextImageInList method is:</p>
 385
 386 <pre class="text">
 387 Image *GetNextImageInList(const Image *images)
 388 </pre>
 389
 390 <p>A description of each parameter follows:</p>
 391
 392 <dd>
 393 </dd>
 394
 395 <dd> </dd>
 396 <dl class="dl-horizontal">
 397 <dt>images</dt>
 398 <dd>the image list. </dd>
 399
 400 <dd>  </dd>
 401 </dl>
 402 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetPreviousImageInList">GetPreviousImageInList</a></h2>
 403
 404 <p>GetPreviousImageInList() returns the previous image in the list.</p>
 405
 406 <p>The format of the GetPreviousImageInList method is:</p>
 407
 408 <pre class="text">
 409 Image *GetPreviousImageInList(const Image *images)
 410 </pre>
 411
 412 <p>A description of each parameter follows:</p>
 413
 414 <dd>
 415 </dd>
 416
 417 <dd> </dd>
 418 <dl class="dl-horizontal">
 419 <dt>images</dt>
 420 <dd>the image list. </dd>
 421
 422 <dd>  </dd>
 423 </dl>
 424 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ImageListToArray">ImageListToArray</a></h2>
 425
 426 <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>
 427
 428 <p>The images remain part of the original image list, with the array providing an alternative means of indexing the image array.</p>
 429
 430 <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>
 431
 432 <p>The format of the ImageListToArray method is:</p>
 433
 434 <pre class="text">
 435 Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
 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>image</dt>
 446 <dd>the image list. </dd>
 447
 448 <dd> </dd>
 449 <dt>exception</dt>
 450 <dd>return any errors or warnings in this structure. </dd>
 451
 452 <dd>  </dd>
 453 </dl>
 454 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="InsertImageInList">InsertImageInList</a></h2>
 455
 456 <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>
 457
 458 <p>The format of the InsertImageInList method is:</p>
 459
 460 <pre class="text">
 461 InsertImageInList(Image **images,Image *insert)
 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>images</dt>
 472 <dd>the image list to insert into. </dd>
 473
 474 <dd> </dd>
 475 <dt>insert</dt>
 476 <dd>the image list to insert. </dd>
 477
 478 <dd>  </dd>
 479 </dl>
 480 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="NewImageList">NewImageList</a></h2>
 481
 482 <p>NewImageList() creates an empty image list.</p>
 483
 484 <p>The format of the NewImageList method is:</p>
 485
 486 <pre class="text">
 487 Image *NewImageList(void)
 488 </pre>
 489
 490 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="PrependImageToList">PrependImageToList</a></h2>
 491
 492 <p>PrependImageToList() prepends the image to the beginning of the list.</p>
 493
 494 <p>The format of the PrependImageToList method is:</p>
 495
 496 <pre class="text">
 497 PrependImageToList(Image *images,Image *image)
 498 </pre>
 499
 500 <p>A description of each parameter follows:</p>
 501
 502 <dd>
 503 </dd>
 504
 505 <dd> </dd>
 506 <dl class="dl-horizontal">
 507 <dt>images</dt>
 508 <dd>the image list. </dd>
 509
 510 <dd> </dd>
 511 <dt>image</dt>
 512 <dd>the image. </dd>
 513
 514 <dd>  </dd>
 515 </dl>
 516 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveImageFromList">RemoveImageFromList</a></h2>
 517
 518 <p>RemoveImageFromList() removes and returns the image pointed to.</p>
 519
 520 <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>
 521
 522 <p>The format of the RemoveImageFromList method is:</p>
 523
 524 <pre class="text">
 525 Image *RemoveImageFromList(Image **images)
 526 </pre>
 527
 528 <p>A description of each parameter follows:</p>
 529
 530 <dd>
 531 </dd>
 532
 533 <dd> </dd>
 534 <dl class="dl-horizontal">
 535 <dt>images</dt>
 536 <dd>the image list. </dd>
 537
 538 <dd>  </dd>
 539 </dl>
 540 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
 541
 542 <p>RemoveFirstImageFromList() removes and returns the first image in the list.</p>
 543
 544 <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>
 545
 546 <p>The format of the RemoveFirstImageFromList method is:</p>
 547
 548 <pre class="text">
 549 Image *RemoveFirstImageFromList(Image **images)
 550 </pre>
 551
 552 <p>A description of each parameter follows:</p>
 553
 554 <dd>
 555 </dd>
 556
 557 <dd> </dd>
 558 <dl class="dl-horizontal">
 559 <dt>images</dt>
 560 <dd>the image list. </dd>
 561
 562 <dd>  </dd>
 563 </dl>
 564 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
 565
 566 <p>RemoveLastImageFromList() removes and returns the last image from the list.</p>
 567
 568 <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>
 569
 570 <p>The format of the RemoveLastImageFromList method is:</p>
 571
 572 <pre class="text">
 573 Image *RemoveLastImageFromList(Image **images)
 574 </pre>
 575
 576 <p>A description of each parameter follows:</p>
 577
 578 <dd>
 579 </dd>
 580
 581 <dd> </dd>
 582 <dl class="dl-horizontal">
 583 <dt>images</dt>
 584 <dd>the image list. </dd>
 585
 586 <dd>  </dd>
 587 </dl>
 588 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReplaceImageInList">ReplaceImageInList</a></h2>
 589
 590 <p>ReplaceImageInList() replaces an image in the list with the given image, or list of images.  Old image is destroyed.</p>
 591
 592 <p>The images list pointer is set to point to the first image of the inserted list of images.</p>
 593
 594 <p>The format of the ReplaceImageInList method is:</p>
 595
 596 <pre class="text">
 597 ReplaceImageInList(Image **images,Image *replace)
 598 </pre>
 599
 600 <p>A description of each parameter follows:</p>
 601
 602 <dd>
 603 </dd>
 604
 605 <dd> </dd>
 606 <dl class="dl-horizontal">
 607 <dt>images</dt>
 608 <dd>the list and pointer to image to replace </dd>
 609
 610 <dd> </dd>
 611 <dt>replace</dt>
 612 <dd>the image or image list replacing the original </dd>
 613
 614 <dd>  </dd>
 615 </dl>
 616 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a></h2>
 617
 618 <p>ReplaceImageInListReturnLast() is exactly as ReplaceImageInList() except the images pointer is set to the last image in the list of replacemen images.</p>
 619
 620 <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>
 621
 622 <p>The format of the ReplaceImageInList method is:</p>
 623
 624 <pre class="text">
 625 ReplaceImageInListReturnLast(Image **images,Image *replace)
 626 </pre>
 627
 628 <p>A description of each parameter follows:</p>
 629
 630 <dd>
 631 </dd>
 632
 633 <dd> </dd>
 634 <dl class="dl-horizontal">
 635 <dt>images</dt>
 636 <dd>the list and pointer to image to replace </dd>
 637
 638 <dd> </dd>
 639 <dt>replace</dt>
 640 <dd>the image or image list replacing the original </dd>
 641
 642 <dd>  </dd>
 643 </dl>
 644 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReverseImageList">ReverseImageList</a></h2>
 645
 646 <p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p>
 647
 648 <p>The format of the ReverseImageList method is:</p>
 649
 650 <pre class="text">
 651 void ReverseImageList(Image **images)
 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 image list. </dd>
 663
 664 <dd>  </dd>
 665 </dl>
 666 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="SpliceImageIntoList">SpliceImageIntoList</a></h2>
 667
 668 <p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p>
 669
 670 <p>The format of the SpliceImageIntoList method is:</p>
 671
 672 <pre class="text">
 673 SpliceImageIntoList(Image **images,const size_t,
 674   const Image *splice)
 675 </pre>
 676
 677 <p>A description of each parameter follows:</p>
 678
 679 <dd>
 680 </dd>
 681
 682 <dd> </dd>
 683 <dl class="dl-horizontal">
 684 <dt>images</dt>
 685 <dd>the image list. </dd>
 686
 687 <dd> </dd>
 688 <dt>length</dt>
 689 <dd>the length of the image list to remove. </dd>
 690
 691 <dd> </dd>
 692 <dt>splice</dt>
 693 <dd>Replace the removed image list with this list. </dd>
 694
 695 <dd>  </dd>
 696 </dl>
 697 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="SplitImageList">SplitImageList</a></h2>
 698
 699 <p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p>
 700
 701 <p>The format of the SplitImageList method is:</p>
 702
 703 <pre class="text">
 704 Image *SplitImageList(Image *images)
 705 </pre>
 706
 707 <p>A description of each parameter follows:</p>
 708
 709 <dd>
 710 </dd>
 711
 712 <dd> </dd>
 713 <dl class="dl-horizontal">
 714 <dt>images</dt>
 715 <dd>the image list. </dd>
 716
 717 <dd>  </dd>
 718 </dl>
 719 </div>
 720   <footer class="magick-footer">
 721     <div class="magick-nav-item navbar-left">
 722       <a href="../support.html">Donate</a>
 723     </div>
 724     <p><a href="../sitemap.html">Sitemap</a> •
 725     <a href="../links.html">Related</a> •
 726     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Image Studio</a> •
 727     <a href="http://jqmagick.imagemagick.org/">JqMagick</a> •
 728     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a>
 729 </p>
 730     <p><a href="list.html#">Back to top</a> •
 731     <a href="http://www.imagemagick.org/script/contact.php">Contact Us</a></p>
 732     <p class="small">©  1999-2015 ImageMagick Studio LLC</p>
 733   </footer>
 734 </div><!-- /.container -->
 735
 736   <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
 737   <script src="../js/bootstrap.min.js"></script>
 738   <script type="text/javascript">
 739     /*  */
 740     (function() {
 741         var s = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
 742         s.type = 'text/javascript';
 743         s.async = true;
 744         s.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
 745         t.parentNode.insertBefore(s, t);
 746     })();
 747     /*  */
 748   </script>
 749 </div>
 750 </body>
 751 </html>