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, initial-scale=1" /> 10 <title>ImageMagick - MagickCore, C API: Working with Image Lists</title> 11 <meta name="application-name" content="ImageMagick" /> 12 <meta name="description" content="Use ImageMagick® to create, edit, compose, and convert digital images. Resize an image, crop it, change its shades and colors, add captions, and more." /> 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, image processing software" /> 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-2020 ImageMagick Studio LLC" /> 23 <meta name="distribution" content="Global" /> 24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" /> 25 <meta property='og:url' content='../../' /> 26 <meta property='og:title' content='ImageMagick' /> 27 <meta property='og:image' content='../../../images/logo.png' /> 28 <meta property='og:type' content='website' /> 29 <meta property='og:site_name' content='ImageMagick' /> 30 <meta property='og:description' content="Create, Edit, Compose, or Convert Digital Images" /> 31 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> 32 <link href="list.html" rel="canonical" /> 33 <link href="../../../images/wand.png" rel="icon" /> 34 <link href="../../../images/wand.ico" rel="shortcut icon" /> 35 <link href="../../assets/magick.css" rel="stylesheet" /> 36</head> 37<body> 38 <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top"> 39 <div class="container-fluid"> 40 <a class="navbar-brand" href="../../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../../../images/wand.ico"/></a> 41 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-controls="magick-navbars" aria-expanded="false" aria-label="Toggle navigation"> 42 <span class="navbar-toggler-icon"></span> 43 </button> 44 45 <div class="collapse navbar-collapse" id="magick-navbars"> 46 <ul class="navbar-nav me-auto mb-2 mb-md-0"> 47 <li class="nav-item"> 48 <a class="nav-link " href="../../www/index.html">Home</a> 49 </li> 50 <li class="nav-item"> 51 <a class="nav-link " href="../../www/download.html">Download</a> 52 </li> 53 <li class="nav-item"> 54 <a class="nav-link " href="../../www/command-line-tools.html">Tools</a> 55 </li> 56 <li class="nav-item"> 57 <a class="nav-link " href="../../www/command-line-processing.html">CLI</a> 58 </li> 59 <li class="nav-item"> 60 <a class="nav-link " href="../../www/develop.html">Develop</a> 61 </li> 62 <li class="nav-item"> 63 <a class="nav-link" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">Community</a> 64 </li> 65 <li class="nav-item"> 66 <iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe> 67 </li> 68 </ul> 69 <form class="d-flex form-inline" action="https://imagemagick.org/script/search.php"> 70 <input class="form-control me-2" type="text" name="q" placeholder="Search" aria-label="Search"> 71 <button class="btn btn-outline-success" type="submit" name="sa">Search</button> 72 </form> 73 </div> 74 </div> 75 </nav> 76 77 <div class="container"> 78 <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script> 79 <ins class="adsbygoogle" 80 style="display:block" 81 data-ad-client="ca-pub-3129977114552745" 82 data-ad-slot="6345125851" 83 data-full-width-responsive="true" 84 data-ad-format="horizontal"></ins> 85 <script> 86 (adsbygoogle = window.adsbygoogle || []).push({}); 87 </script> 88 89 </div> 90 91 <main class="container"> 92 <div class="magick-template"> 93<div class="magick-header"> 94<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> 95 96<h2><a href="../../api/MagickCore/list_8c.html" id="AppendImageToList">AppendImageToList</a></h2> 97 98<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> 99 100<p>The format of the AppendImageToList method is:</p> 101 102<pre class="text"> 103AppendImageToList(Image *images,const Image *image) 104</pre> 105 106<p>A description of each parameter follows:</p> 107 108<dd> 109</dd> 110 111<dd> </dd> 112<dl class="dl-horizontal"> 113<dt>images</dt> 114<dd>the image list to be appended to. </dd> 115 116<dd> </dd> 117<dt>image</dt> 118<dd>the appended image or image list. </dd> 119 120<dd> </dd> 121</dl> 122<h2><a href="../../api/MagickCore/list_8c.html" id="CloneImageList">CloneImageList</a></h2> 123 124<p>CloneImageList() returns a duplicate of the image list.</p> 125 126<p>The format of the CloneImageList method is:</p> 127 128<pre class="text"> 129Image *CloneImageList(const Image *images,ExceptionInfo *exception) 130</pre> 131 132<p>A description of each parameter follows:</p> 133 134<dd> 135</dd> 136 137<dd> </dd> 138<dl class="dl-horizontal"> 139<dt>images</dt> 140<dd>the image list. </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="../../api/MagickCore/list_8c.html" id="CloneImages">CloneImages</a></h2> 149 150<p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p> 151 152<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> 153 154<p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p> 155 156<p>The format of the CloneImages method is:</p> 157 158<pre class="text"> 159Image *CloneImages(const Image *images,const char *scenes, 160 ExceptionInfo *exception) 161</pre> 162 163<p>A description of each parameter follows:</p> 164 165<dd> 166</dd> 167 168<dd> </dd> 169<dl class="dl-horizontal"> 170<dt>images</dt> 171<dd>the image sequence. </dd> 172 173<dd> </dd> 174<dt>scenes</dt> 175<dd>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2). </dd> 176 177<dd> </dd> 178<dt>exception</dt> 179<dd>return any errors or warnings in this structure. </dd> 180 181<dd> </dd> 182</dl> 183<h2><a href="../../api/MagickCore/list_8c.html" id="DeleteImageFromList">DeleteImageFromList</a></h2> 184 185<p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p> 186 187<p>The format of the DeleteImageFromList method is:</p> 188 189<pre class="text"> 190DeleteImageFromList(Image **images) 191</pre> 192 193<p>A description of each parameter follows:</p> 194 195<dd> 196</dd> 197 198<dd> </dd> 199<dl class="dl-horizontal"> 200<dt>images</dt> 201<dd>the image list. </dd> 202 203<dd> </dd> 204</dl> 205<h2><a href="../../api/MagickCore/list_8c.html" id="DeleteImages">DeleteImages</a></h2> 206 207<p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p> 208 209<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> 210 211<p>If the referenced images are in the reverse order, that range will be completely ignored, unlike CloneImages().</p> 212 213<p>The format of the DeleteImages method is:</p> 214 215<pre class="text"> 216DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception) 217</pre> 218 219<p>A description of each parameter follows:</p> 220 221<dd> 222</dd> 223 224<dd> </dd> 225<dl class="dl-horizontal"> 226<dt>images</dt> 227<dd>the image sequence. </dd> 228 229<dd> </dd> 230<dt>scenes</dt> 231<dd>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2). </dd> 232 233<dd> </dd> 234<dt>exception</dt> 235<dd>return any errors or warnings in this structure. </dd> 236 237<dd> </dd> 238</dl> 239<h2><a href="../../api/MagickCore/list_8c.html" id="DestroyImageList">DestroyImageList</a></h2> 240 241<p>DestroyImageList() destroys an image list.</p> 242 243<p>The format of the DestroyImageList method is:</p> 244 245<pre class="text"> 246Image *DestroyImageList(Image *image) 247</pre> 248 249<p>A description of each parameter follows:</p> 250 251<dd> 252</dd> 253 254<dd> </dd> 255<dl class="dl-horizontal"> 256<dt>image</dt> 257<dd>the image sequence. </dd> 258 259<dd> </dd> 260</dl> 261<h2><a href="../../api/MagickCore/list_8c.html" id="DuplicateImages">DuplicateImages</a></h2> 262 263<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> 264 265<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> 266 267<p>The format of the DuplicateImages method is:</p> 268 269<pre class="text"> 270Image *DuplicateImages(Image *images,const size_t number_duplicates, 271 const char *scenes,ExceptionInfo *exception) 272</pre> 273 274<p>A description of each parameter follows:</p> 275 276<dd> 277</dd> 278 279<dd> </dd> 280<dl class="dl-horizontal"> 281<dt>images</dt> 282<dd>the image sequence. </dd> 283 284<dd> </dd> 285<dt>number_duplicates</dt> 286<dd>duplicate the image sequence this number of times. </dd> 287 288<dd> </dd> 289<dt>scenes</dt> 290<dd>This character string specifies which scenes to duplicate (e.g. 1,3-5,-2-6,2). </dd> 291 292<dd> </dd> 293<dt>exception</dt> 294<dd>return any errors or warnings in this structure. </dd> 295 296<dd> </dd> 297</dl> 298<h2><a href="../../api/MagickCore/list_8c.html" id="GetFirstImageInList">GetFirstImageInList</a></h2> 299 300<p>GetFirstImageInList() returns a pointer to the first image in the list.</p> 301 302<p>The format of the GetFirstImageInList method is:</p> 303 304<pre class="text"> 305Image *GetFirstImageInList(const Image *images) 306</pre> 307 308<p>A description of each parameter follows:</p> 309 310<dd> 311</dd> 312 313<dd> </dd> 314<dl class="dl-horizontal"> 315<dt>images</dt> 316<dd>the image list. </dd> 317 318<dd> </dd> 319</dl> 320<h2><a href="../../api/MagickCore/list_8c.html" id="GetImageFromList">GetImageFromList</a></h2> 321 322<p>GetImageFromList() returns an image at the specified index from the image list. Starting with 0 as the first image in the list.</p> 323 324<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> 325 326<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> 327 328<p>The format of the GetImageFromList method is:</p> 329 330<pre class="text"> 331Image *GetImageFromList(const Image *images,const ssize_t index) 332</pre> 333 334<p>A description of each parameter follows:</p> 335 336<dd> 337</dd> 338 339<dd> </dd> 340<dl class="dl-horizontal"> 341<dt>images</dt> 342<dd>the image list. </dd> 343 344<dd> </dd> 345<dt>index</dt> 346<dd>the position within the list. </dd> 347 348<dd> </dd> 349</dl> 350<h2><a href="../../api/MagickCore/list_8c.html" id="GetImageIndexInList">GetImageIndexInList</a></h2> 351 352<p>GetImageIndexInList() returns the offset in the list of the specified image.</p> 353 354<p>The format of the GetImageIndexInList method is:</p> 355 356<pre class="text"> 357ssize_t GetImageIndexInList(const Image *images) 358</pre> 359 360<p>A description of each parameter follows:</p> 361 362<dd> 363</dd> 364 365<dd> </dd> 366<dl class="dl-horizontal"> 367<dt>images</dt> 368<dd>the image list. </dd> 369 370<dd> </dd> 371</dl> 372<h2><a href="../../api/MagickCore/list_8c.html" id="GetImageListLength">GetImageListLength</a></h2> 373 374<p>GetImageListLength() returns the length of the list (the number of images in the list).</p> 375 376<p>The format of the GetImageListLength method is:</p> 377 378<pre class="text"> 379size_t GetImageListLength(const Image *images) 380</pre> 381 382<p>A description of each parameter follows:</p> 383 384<dd> 385</dd> 386 387<dd> </dd> 388<dl class="dl-horizontal"> 389<dt>images</dt> 390<dd>the image list. </dd> 391 392<dd> </dd> 393</dl> 394<h2><a href="../../api/MagickCore/list_8c.html" id="GetLastImageInList">GetLastImageInList</a></h2> 395 396<p>GetLastImageInList() returns a pointer to the last image in the list.</p> 397 398<p>The format of the GetLastImageInList method is:</p> 399 400<pre class="text"> 401Image *GetLastImageInList(const Image *images) 402</pre> 403 404<p>A description of each parameter follows:</p> 405 406<dd> 407</dd> 408 409<dd> </dd> 410<dl class="dl-horizontal"> 411<dt>images</dt> 412<dd>the image list. </dd> 413 414<dd> </dd> 415</dl> 416<h2><a href="../../api/MagickCore/list_8c.html" id="GetNextImageInList">GetNextImageInList</a></h2> 417 418<p>GetNextImageInList() returns the next image in the list.</p> 419 420<p>The format of the GetNextImageInList method is:</p> 421 422<pre class="text"> 423Image *GetNextImageInList(const Image *images) 424</pre> 425 426<p>A description of each parameter follows:</p> 427 428<dd> 429</dd> 430 431<dd> </dd> 432<dl class="dl-horizontal"> 433<dt>images</dt> 434<dd>the image list. </dd> 435 436<dd> </dd> 437</dl> 438<h2><a href="../../api/MagickCore/list_8c.html" id="GetPreviousImageInList">GetPreviousImageInList</a></h2> 439 440<p>GetPreviousImageInList() returns the previous image in the list.</p> 441 442<p>The format of the GetPreviousImageInList method is:</p> 443 444<pre class="text"> 445Image *GetPreviousImageInList(const Image *images) 446</pre> 447 448<p>A description of each parameter follows:</p> 449 450<dd> 451</dd> 452 453<dd> </dd> 454<dl class="dl-horizontal"> 455<dt>images</dt> 456<dd>the image list. </dd> 457 458<dd> </dd> 459</dl> 460<h2><a href="../../api/MagickCore/list_8c.html" id="ImageListToArray">ImageListToArray</a></h2> 461 462<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> 463 464<p>The images remain part of the original image list, with the array providing an alternative means of indexing the image array.</p> 465 466<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> 467 468<p>The format of the ImageListToArray method is:</p> 469 470<pre class="text"> 471Image **ImageListToArray(const Image *images,ExceptionInfo *exception) 472</pre> 473 474<p>A description of each parameter follows:</p> 475 476<dd> 477</dd> 478 479<dd> </dd> 480<dl class="dl-horizontal"> 481<dt>image</dt> 482<dd>the image list. </dd> 483 484<dd> </dd> 485<dt>exception</dt> 486<dd>return any errors or warnings in this structure. </dd> 487 488<dd> </dd> 489</dl> 490<h2><a href="../../api/MagickCore/list_8c.html" id="InsertImageInList">InsertImageInList</a></h2> 491 492<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> 493 494<p>The format of the InsertImageInList method is:</p> 495 496<pre class="text"> 497InsertImageInList(Image **images,Image *insert) 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 to insert into. </dd> 509 510<dd> </dd> 511<dt>insert</dt> 512<dd>the image list to insert. </dd> 513 514<dd> </dd> 515</dl> 516<h2><a href="../../api/MagickCore/list_8c.html" id="NewImageList">NewImageList</a></h2> 517 518<p>NewImageList() creates an empty image list.</p> 519 520<p>The format of the NewImageList method is:</p> 521 522<pre class="text"> 523Image *NewImageList(void) 524</pre> 525 526<h2><a href="../../api/MagickCore/list_8c.html" id="PrependImageToList">PrependImageToList</a></h2> 527 528<p>PrependImageToList() prepends the image to the beginning of the list.</p> 529 530<p>The format of the PrependImageToList method is:</p> 531 532<pre class="text"> 533PrependImageToList(Image *images,Image *image) 534</pre> 535 536<p>A description of each parameter follows:</p> 537 538<dd> 539</dd> 540 541<dd> </dd> 542<dl class="dl-horizontal"> 543<dt>images</dt> 544<dd>the image list. </dd> 545 546<dd> </dd> 547<dt>image</dt> 548<dd>the image. </dd> 549 550<dd> </dd> 551</dl> 552<h2><a href="../../api/MagickCore/list_8c.html" id="RemoveImageFromList">RemoveImageFromList</a></h2> 553 554<p>RemoveImageFromList() removes and returns the image pointed to.</p> 555 556<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> 557 558<p>The format of the RemoveImageFromList method is:</p> 559 560<pre class="text"> 561Image *RemoveImageFromList(Image **images) 562</pre> 563 564<p>A description of each parameter follows:</p> 565 566<dd> 567</dd> 568 569<dd> </dd> 570<dl class="dl-horizontal"> 571<dt>images</dt> 572<dd>the image list. </dd> 573 574<dd> </dd> 575</dl> 576<h2><a href="../../api/MagickCore/list_8c.html" id="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2> 577 578<p>RemoveFirstImageFromList() removes and returns the first image in the list.</p> 579 580<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> 581 582<p>The format of the RemoveFirstImageFromList method is:</p> 583 584<pre class="text"> 585Image *RemoveFirstImageFromList(Image **images) 586</pre> 587 588<p>A description of each parameter follows:</p> 589 590<dd> 591</dd> 592 593<dd> </dd> 594<dl class="dl-horizontal"> 595<dt>images</dt> 596<dd>the image list. </dd> 597 598<dd> </dd> 599</dl> 600<h2><a href="../../api/MagickCore/list_8c.html" id="RemoveLastImageFromList">RemoveLastImageFromList</a></h2> 601 602<p>RemoveLastImageFromList() removes and returns the last image from the list.</p> 603 604<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> 605 606<p>The format of the RemoveLastImageFromList method is:</p> 607 608<pre class="text"> 609Image *RemoveLastImageFromList(Image **images) 610</pre> 611 612<p>A description of each parameter follows:</p> 613 614<dd> 615</dd> 616 617<dd> </dd> 618<dl class="dl-horizontal"> 619<dt>images</dt> 620<dd>the image list. </dd> 621 622<dd> </dd> 623</dl> 624<h2><a href="../../api/MagickCore/list_8c.html" id="ReplaceImageInList">ReplaceImageInList</a></h2> 625 626<p>ReplaceImageInList() replaces an image in the list with the given image, or list of images. Old image is destroyed.</p> 627 628<p>The images list pointer is set to point to the first image of the inserted list of images.</p> 629 630<p>The format of the ReplaceImageInList method is:</p> 631 632<pre class="text"> 633ReplaceImageInList(Image **images,Image *replace) 634</pre> 635 636<p>A description of each parameter follows:</p> 637 638<dd> 639</dd> 640 641<dd> </dd> 642<dl class="dl-horizontal"> 643<dt>images</dt> 644<dd>the list and pointer to image to replace </dd> 645 646<dd> </dd> 647<dt>replace</dt> 648<dd>the image or image list replacing the original </dd> 649 650<dd> </dd> 651</dl> 652<h2><a href="../../api/MagickCore/list_8c.html" id="ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a></h2> 653 654<p>ReplaceImageInListReturnLast() is exactly as ReplaceImageInList() except the images pointer is set to the last image in the list of replacement images.</p> 655 656<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> 657 658<p>The format of the ReplaceImageInList method is:</p> 659 660<pre class="text"> 661ReplaceImageInListReturnLast(Image **images,Image *replace) 662</pre> 663 664<p>A description of each parameter follows:</p> 665 666<dd> 667</dd> 668 669<dd> </dd> 670<dl class="dl-horizontal"> 671<dt>images</dt> 672<dd>the list and pointer to image to replace </dd> 673 674<dd> </dd> 675<dt>replace</dt> 676<dd>the image or image list replacing the original </dd> 677 678<dd> </dd> 679</dl> 680<h2><a href="../../api/MagickCore/list_8c.html" id="ReverseImageList">ReverseImageList</a></h2> 681 682<p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p> 683 684<p>The format of the ReverseImageList method is:</p> 685 686<pre class="text"> 687void ReverseImageList(Image **images) 688</pre> 689 690<p>A description of each parameter follows:</p> 691 692<dd> 693</dd> 694 695<dd> </dd> 696<dl class="dl-horizontal"> 697<dt>images</dt> 698<dd>the image list. </dd> 699 700<dd> </dd> 701</dl> 702<h2><a href="../../api/MagickCore/list_8c.html" id="SpliceImageIntoList">SpliceImageIntoList</a></h2> 703 704<p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p> 705 706<p>The format of the SpliceImageIntoList method is:</p> 707 708<pre class="text"> 709SpliceImageIntoList(Image **images,const size_t, 710 const Image *splice) 711</pre> 712 713<p>A description of each parameter follows:</p> 714 715<dd> 716</dd> 717 718<dd> </dd> 719<dl class="dl-horizontal"> 720<dt>images</dt> 721<dd>the image list. </dd> 722 723<dd> </dd> 724<dt>length</dt> 725<dd>the length of the image list to remove. </dd> 726 727<dd> </dd> 728<dt>splice</dt> 729<dd>Replace the removed image list with this list. </dd> 730 731<dd> </dd> 732</dl> 733<h2><a href="../../api/MagickCore/list_8c.html" id="SplitImageList">SplitImageList</a></h2> 734 735<p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p> 736 737<p>The format of the SplitImageList method is:</p> 738 739<pre class="text"> 740Image *SplitImageList(Image *images) 741</pre> 742 743<p>A description of each parameter follows:</p> 744 745<dd> 746</dd> 747 748<dd> </dd> 749<dl class="dl-horizontal"> 750<dt>images</dt> 751<dd>the image list. </dd> 752 753<dd> </dd> 754</dl> 755</div> 756 </div> 757 </main><!-- /.container --> 758 <footer class="magick-footer"> 759 <div class="container-fluid"> 760 <a href="../../www/security-policy.html">Security</a> • 761 <a href="../../www/news.html">News</a> 762 763 <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> 764 765 <a href="../../www/links.html">Related</a> • 766 <a href="../../www/sitemap.html">Sitemap</a> 767 <br/> 768 <a href="../../www/support.html">Sponsor</a> • 769 <a href="../../www/cite.html">Cite</a> • 770 <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> • 771 <a href="../../www/contact.html">Contact Us</a> 772 <br/> 773 <a href="https://github.com/imagemagick/imagemagick" target="_blank" rel="noopener" aria-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 499.36" width="2%" height="2%" role="img" focusable="false"><title>GitHub</title><path fill="currentColor" fill-rule="evenodd" d="M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z"/></svg></a> • 774 <a href="https://twitter.com/imagemagick" target="_blank" rel="noopener" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 416.32" width="2%" height="2%" role="img" focusable="false"><title>Twitter</title><path fill="currentColor" d="M160.83 416.32c193.2 0 298.92-160.22 298.92-298.92 0-4.51 0-9-.2-13.52A214 214 0 0 0 512 49.38a212.93 212.93 0 0 1-60.44 16.6 105.7 105.7 0 0 0 46.3-58.19 209 209 0 0 1-66.79 25.37 105.09 105.09 0 0 0-181.73 71.91 116.12 116.12 0 0 0 2.66 24c-87.28-4.3-164.73-46.3-216.56-109.82A105.48 105.48 0 0 0 68 159.6a106.27 106.27 0 0 1-47.53-13.11v1.43a105.28 105.28 0 0 0 84.21 103.06 105.67 105.67 0 0 1-47.33 1.84 105.06 105.06 0 0 0 98.14 72.94A210.72 210.72 0 0 1 25 370.84a202.17 202.17 0 0 1-25-1.43 298.85 298.85 0 0 0 160.83 46.92"/></svg></a> 775 <br/> 776 <small>© 1999-2021 ImageMagick Studio LLC</small> 777 </div> 778 </footer> 779 780 <!-- Javascript assets --> 781 <script src="../../assets/magick.js" ></script> 782 </body> 783</html> 784
