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> • <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> 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]->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