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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" \r
   2   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   3 <html version="-//W3C//DTD XHTML 1.1//EN"\r
   4       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"\r
   5       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\r
   6       xsi:schemaLocation="http://www.w3.org/1999/xhtml\r
   7                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">\r
   8 <head>\r
   9   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
  10   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>\r
  11   <title>ImageMagick: MagickCore, C API for ImageMagick: Working with Image Lists</title>
  12   <meta http-equiv="Content-Language" content="en-US"/>
  13   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  14   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  15   <meta name="Application-name" content="ImageMagick"/>
  16   <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition resize, rotate, shear, distort and transform images."/>
  17   <meta name="Application-url" content="http://www.imagemagick.org"/>
  18   <meta name="Generator" content="PHP"/>
  19   <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, working, with, image, lists, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  20   <meta name="Rating" content="GENERAL"/>
  21   <meta name="Robots" content="INDEX, FOLLOW"/>
  22   <meta name="Generator" content="ImageMagick Studio LLC"/>
  23   <meta name="Author" content="ImageMagick Studio LLC"/>
  24   <meta name="Revisit-after" content="2 DAYS"/>
  25   <meta name="Resource-type" content="document"/>
  26   <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
  27   <meta name="Distribution" content="Global"/>
  28   <link rel="icon" href="../../images/wand.png"/>
  29   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/x-icon"/>
  30   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
  31   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />\r
  32   <style type="text/css" media="all">\r
  33     @import url("../../www/magick.css");\r
  34   </style>\r
  35   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>\r
  36   <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>\r
  37   <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />\r
  38   <script type="text/javascript">\r
  39     $(document).ready(function() {\r
  40       $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({\r
  41         'transitionIn'  : 'elastic',\r
  42         'transitionOut' : 'elastic',\r
  43         'overlayShow'   : false,\r
  44         'opacity'       : true\r
  45       });\r
  46     });\r
  47   </script>\r
  48 </head>\r
  49 \r
  50 <body id="www-imagemagick-org">\r
  51 <div class="titlebar">\r
  52 <a href="../../index.html">\r
  53   <img src="../../images/script.png" alt="[ImageMagick]"\r
  54   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  55 <a href="http://www.networkredux.com">\r
  56   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  57   style="margin-top: 42px; border: 0px; float: left;" /></a>\r
  58 <a href="http://www.imagemagick.org/discourse-server/">\r
  59   <img src="../../images/logo.jpg"\r
  60   alt="ImageMagick Logo"\r
  61   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>\r
  62 <a href="../../index.html">\r
  63   <img src="../../images/sprite.jpg"\r
  64   alt="ImageMagick Sprite"\r
  65   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  66 </div>\r
  67 \r
  68 <div class="westbar">\r
  69 \r
  70 <div class="menu">
  71   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  72 </div>
  73 <div class="sep"></div>\r
  74 <div class="menu">
  75   <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
  76 </div>
  77 <div class="sub">
  78     <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
  79 </div>
  80 <div class="sub">
  81     <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
  82 </div>
  83 <div class="sub">
  84     <a title="Binary Release: iPhone" href="../../www/binary-releases.html#iPhone">iPhone</a>
  85 </div>
  86 <div class="sub">
  87     <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
  88 </div>
  89 <div class="sep"></div>\r
  90 <div class="menu">
  91   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  92 </div>
  93 <div class="sub">
  94     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  95 </div>
  96 <div class="sub">
  97     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  98 </div>
  99 <div class="sub">
 100     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 101 </div>
 102 <div class="menu">
 103   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
 104 </div>
 105 <div class="sub">
 106     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
 107 </div>
 108 <div class="sub">
 109     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
 110 </div>
 111 <div class="sub">
 112     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
 113 </div>
 114 <div class="sub">
 115     <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
 116 </div>
 117 <div class="sep"></div>\r
 118 <div  class="menu">
 119    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
 120 </div>
 121 <div class="sub">
 122     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
 123 </div>
 124 <div class="sub">
 125     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 126  </div>
 127 <div class="menu">
 128   <a title="Resources" href="../../www/resources.html">Resources</a>
 129 </div>
 130 <div class="menu">
 131   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 132 </div>
 133 <div class="menu">
 134   <a title="Download" href="../../www/download.html">Download</a>
 135 </div>
 136 <div class="sep"></div>\r
 137 <div class="menu">
 138   <a title="Search" href="../../www/search.html">Search</a>
 139 </div>
 140 <div class="sep"></div>\r
 141 <div class="menu">
 142   <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
 143 </div>
 144 <div  class="sub">
 145   <a title="Site Map: Links" href="../../www/links.html">Links</a>
 146 </div>
 147 <div class="sep"></div>\r
 148 <div  class="menu">
 149   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 150
 151 <div class="sponsbox">
 152 <div  class="sponsor">
 153   <a title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
 154 </div>
 155 <div  class="sponsor">
 156   <a title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201106010090 alexanian media -->
 157 </div>
 158 <div  class="sponsor">
 159   <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201107010240 r.leo -->
 160 </div>
 161 <div  class="sponsor">
 162   <a title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
 163 </div>
 164 <div  class="sponsor">
 165   <a title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
 166 </div>
 167 <div  class="sponsor">
 168   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 169 </div>
 170 <div class="sponsor">
 171   <a title="Sponsor: Web Hosting" href="http://www.bodhost.com/hosting.shtml">Web Hosting</a><!-- 201104010090 -->
 172 </div>
 173 <div  class="sponsor">
 174   <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
 175 </div>
 176 <div  class="sponsor">
 177    <a title="Sponsor: alaTest.com" href="http://alatest.com">alaTest.com</a><!-- 20110801000300 -->
 178 </div>
 179 </div>
 180 </div>
 181 </div>\r
 182 \r
 183 <div class="eastbar">\r
 184   <script type="text/javascript">\r
 185   <!--\r
 186     google_ad_client = "pub-3129977114552745";\r
 187     google_ad_slot = "0574824969";\r
 188     google_ad_width = 160;\r
 189     google_ad_height = 600;\r
 190   //-->\r
 191   </script>\r
 192   <script type="text/javascript"\r
 193     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 194   </script>\r
 195 </div>\r
 196 \r
 197 <div class="main">\r
 198 \r
 199 <h1>Module list Methods</h1>
 200 <p class="navigation-index">[<a href="#AppendImageToList">AppendImageToList</a> &bull; <a href="#CloneImageList">CloneImageList</a> &bull; <a href="#CloneImages">CloneImages</a> &bull; <a href="#DeleteImageFromList">DeleteImageFromList</a> &bull; <a href="#DeleteImages">DeleteImages</a> &bull; <a href="#DestroyImageList">DestroyImageList</a> &bull; <a href="#GetFirstImageInList">GetFirstImageInList</a> &bull; <a href="#GetImageFromList">GetImageFromList</a> &bull; <a href="#GetImageIndexInList">GetImageIndexInList</a> &bull; <a href="#GetImageListLength">GetImageListLength</a> &bull; <a href="#GetLastImageInList">GetLastImageInList</a> &bull; <a href="#GetNextImageInList">GetNextImageInList</a> &bull; <a href="#GetPreviousImageInList">GetPreviousImageInList</a> &bull; <a href="#ImageListToArray">ImageListToArray</a> &bull; <a href="#InsertImageInList">InsertImageInList</a> &bull; <a href="#NewImageList">NewImageList</a> &bull; <a href="#PrependImageToList">PrependImageToList</a> &bull; <a href="#RemoveImageFromList">RemoveImageFromList</a> &bull; <a href="#RemoveFirstImageFromList">RemoveFirstImageFromList</a> &bull; <a href="#RemoveLastImageFromList">RemoveLastImageFromList</a> &bull; <a href="#ReplaceImageInList">ReplaceImageInList</a> &bull; <a href="#ReverseImageList">ReverseImageList</a> &bull; <a href="#SpliceImageIntoList">SpliceImageIntoList</a> &bull; <a href="#SplitImageList">SplitImageList</a>]</p>
 201
 202 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="AppendImageToList">AppendImageToList</a></h2>
 203 <div class="doc-section">
 204
 205 <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>
 206
 207 <p>The format of the AppendImageToList method is:</p>
 208
 209 <pre class="code">
 210   AppendImageToList(Image *images,const Image *image)
 211 </pre>
 212
 213 <p>A description of each parameter follows:</p>
 214
 215 <h5>images</h5>
 216 <p>the image list to be appended to.</p>
 217
 218 <h5>image</h5>
 219 <p>the appended image or image list.</p>
 220
 221  </div>
 222 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="CloneImageList">CloneImageList</a></h2>
 223 <div class="doc-section">
 224
 225 <p>CloneImageList() returns a duplicate of the image list.</p>
 226
 227 <p>The format of the CloneImageList method is:</p>
 228
 229 <pre class="code">
 230   Image *CloneImageList(const Image *images,ExceptionInfo *exception)
 231 </pre>
 232
 233 <p>A description of each parameter follows:</p>
 234
 235 <h5>images</h5>
 236 <p>the image list.</p>
 237
 238 <h5>exception</h5>
 239 <p>return any errors or warnings in this structure.</p>
 240
 241  </div>
 242 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="CloneImages">CloneImages</a></h2>
 243 <div class="doc-section">
 244
 245 <p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
 246
 247 <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>
 248
 249 <p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p>
 250
 251 <p>The format of the CloneImages method is:</p>
 252
 253 <pre class="code">
 254   Image *CloneImages(const Image *images,const char *scenes,
 255     ExceptionInfo *exception)
 256 </pre>
 257
 258 <p>A description of each parameter follows:</p>
 259
 260 <h5>images</h5>
 261 <p>the image sequence.</p>
 262
 263 <h5>scenes</h5>
 264 <p>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2).</p>
 265
 266 <h5>exception</h5>
 267 <p>return any errors or warnings in this structure.</p>
 268
 269  </div>
 270 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DeleteImageFromList">DeleteImageFromList</a></h2>
 271 <div class="doc-section">
 272
 273 <p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p>
 274
 275 <p>The format of the DeleteImageFromList method is:</p>
 276
 277 <pre class="code">
 278   DeleteImageFromList(Image **images)
 279 </pre>
 280
 281 <p>A description of each parameter follows:</p>
 282
 283 <h5>images</h5>
 284 <p>the image list.</p>
 285
 286  </div>
 287 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DeleteImages">DeleteImages</a></h2>
 288 <div class="doc-section">
 289
 290 <p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
 291
 292 <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>
 293
 294 <p>If the referenced images are in the reverse order, that range will be completely ignored.  Unlike CloneImages().</p>
 295
 296 <p>The format of the DeleteImages method is:</p>
 297
 298 <pre class="code">
 299   DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
 300 </pre>
 301
 302 <p>A description of each parameter follows:</p>
 303
 304 <h5>images</h5>
 305 <p>the image sequence.</p>
 306
 307 <h5>scenes</h5>
 308 <p>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2).</p>
 309
 310 <h5>exception</h5>
 311 <p>return any errors or warnings in this structure.</p>
 312
 313  </div>
 314 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="DestroyImageList">DestroyImageList</a></h2>
 315 <div class="doc-section">
 316
 317 <p>DestroyImageList() destroys an image list.</p>
 318
 319 <p>The format of the DestroyImageList method is:</p>
 320
 321 <pre class="code">
 322   Image *DestroyImageList(Image *image)
 323 </pre>
 324
 325 <p>A description of each parameter follows:</p>
 326
 327 <h5>image</h5>
 328 <p>the image sequence.</p>
 329
 330  </div>
 331 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetFirstImageInList">GetFirstImageInList</a></h2>
 332 <div class="doc-section">
 333
 334 <p>GetFirstImageInList() returns a pointer to the first image in the list.</p>
 335
 336 <p>The format of the GetFirstImageInList method is:</p>
 337
 338 <pre class="code">
 339   Image *GetFirstImageInList(const Image *images)
 340 </pre>
 341
 342 <p>A description of each parameter follows:</p>
 343
 344 <h5>images</h5>
 345 <p>the image list.</p>
 346
 347  </div>
 348 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageFromList">GetImageFromList</a></h2>
 349 <div class="doc-section">
 350
 351 <p>GetImageFromList() returns an image at the specified offset from the list.</p>
 352
 353 <p>The format of the GetImageFromList method is:</p>
 354
 355 <pre class="code">
 356   Image *GetImageFromList(const Image *images,const ssize_t index)
 357 </pre>
 358
 359 <p>A description of each parameter follows:</p>
 360
 361 <h5>images</h5>
 362 <p>the image list.</p>
 363
 364 <h5>index</h5>
 365 <p>the position within the list.</p>
 366
 367  </div>
 368 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageIndexInList">GetImageIndexInList</a></h2>
 369 <div class="doc-section">
 370
 371 <p>GetImageIndexInList() returns the offset in the list of the specified image.</p>
 372
 373 <p>The format of the GetImageIndexInList method is:</p>
 374
 375 <pre class="code">
 376   ssize_t GetImageIndexInList(const Image *images)
 377 </pre>
 378
 379 <p>A description of each parameter follows:</p>
 380
 381 <h5>images</h5>
 382 <p>the image list.</p>
 383
 384  </div>
 385 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetImageListLength">GetImageListLength</a></h2>
 386 <div class="doc-section">
 387
 388 <p>GetImageListLength() returns the length of the list (the number of images in the list).</p>
 389
 390 <p>The format of the GetImageListLength method is:</p>
 391
 392 <pre class="code">
 393   size_t GetImageListLength(const Image *images)
 394 </pre>
 395
 396 <p>A description of each parameter follows:</p>
 397
 398 <h5>images</h5>
 399 <p>the image list.</p>
 400
 401  </div>
 402 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetLastImageInList">GetLastImageInList</a></h2>
 403 <div class="doc-section">
 404
 405 <p>GetLastImageInList() returns a pointer to the last image in the list.</p>
 406
 407 <p>The format of the GetLastImageInList method is:</p>
 408
 409 <pre class="code">
 410   Image *GetLastImageInList(const Image *images)
 411 </pre>
 412
 413 <p>A description of each parameter follows:</p>
 414
 415 <h5>images</h5>
 416 <p>the image list.</p>
 417
 418  </div>
 419 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetNextImageInList">GetNextImageInList</a></h2>
 420 <div class="doc-section">
 421
 422 <p>GetNextImageInList() returns the next image in the list.</p>
 423
 424 <p>The format of the GetNextImageInList method is:</p>
 425
 426 <pre class="code">
 427   Image *GetNextImageInList(const Image *images)
 428 </pre>
 429
 430 <p>A description of each parameter follows:</p>
 431
 432 <h5>images</h5>
 433 <p>the image list.</p>
 434
 435  </div>
 436 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="GetPreviousImageInList">GetPreviousImageInList</a></h2>
 437 <div class="doc-section">
 438
 439 <p>GetPreviousImageInList() returns the previous image in the list.</p>
 440
 441 <p>The format of the GetPreviousImageInList method is:</p>
 442
 443 <pre class="code">
 444   Image *GetPreviousImageInList(const Image *images)
 445 </pre>
 446
 447 <p>A description of each parameter follows:</p>
 448
 449 <h5>images</h5>
 450 <p>the image list.</p>
 451
 452  </div>
 453 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ImageListToArray">ImageListToArray</a></h2>
 454 <div class="doc-section">
 455
 456 <p>ImageListToArray() is a convenience method that converts an image list to a sequential array.  For example,</p>
 457
 458 <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>
 459
 460 <p>The format of the ImageListToArray method is:</p>
 461
 462 <pre class="code">
 463   Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
 464 </pre>
 465
 466 <p>A description of each parameter follows:</p>
 467
 468 <h5>image</h5>
 469 <p>the image list.</p>
 470
 471 <h5>exception</h5>
 472 <p>return any errors or warnings in this structure.</p>
 473
 474  </div>
 475 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="InsertImageInList">InsertImageInList</a></h2>
 476 <div class="doc-section">
 477
 478 <p>InsertImageInList() inserts the second image or image list into the first image list immediately after the image pointed to.  The given image list pointer is unchanged unless previously empty.</p>
 479
 480 <p>The format of the InsertImageInList method is:</p>
 481
 482 <pre class="code">
 483   InsertImageInList(Image **images,Image *image)
 484 </pre>
 485
 486 <p>A description of each parameter follows:</p>
 487
 488 <h5>images</h5>
 489 <p>the image list to insert into.</p>
 490
 491 <h5>image</h5>
 492 <p>the image list to insert.</p>
 493
 494  </div>
 495 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="NewImageList">NewImageList</a></h2>
 496 <div class="doc-section">
 497
 498 <p>NewImageList() creates an empty image list.</p>
 499
 500 <p>The format of the NewImageList method is:</p>
 501
 502 <pre class="code">
 503   Image *NewImageList(void)
 504 </pre>
 505
 506  </div>
 507 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="PrependImageToList">PrependImageToList</a></h2>
 508 <div class="doc-section">
 509
 510 <p>PrependImageToList() prepends the image to the beginning of the list.</p>
 511
 512 <p>The format of the PrependImageToList method is:</p>
 513
 514 <pre class="code">
 515   PrependImageToList(Image *images,Image *image)
 516 </pre>
 517
 518 <p>A description of each parameter follows:</p>
 519
 520 <h5>images</h5>
 521 <p>the image list.</p>
 522
 523 <h5>image</h5>
 524 <p>the image.</p>
 525
 526  </div>
 527 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveImageFromList">RemoveImageFromList</a></h2>
 528 <div class="doc-section">
 529
 530 <p>RemoveImageFromList() removes and returns the image pointed to.</p>
 531
 532 <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>
 533
 534 <p>The format of the RemoveImageFromList method is:</p>
 535
 536 <pre class="code">
 537   Image *RemoveImageFromList(Image **images)
 538 </pre>
 539
 540 <p>A description of each parameter follows:</p>
 541
 542 <h5>images</h5>
 543 <p>the image list.</p>
 544
 545  </div>
 546 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
 547 <div class="doc-section">
 548
 549 <p>RemoveFirstImageFromList() removes and returns the first image in the list.</p>
 550
 551 <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>
 552
 553 <p>The format of the RemoveFirstImageFromList method is:</p>
 554
 555 <pre class="code">
 556   Image *RemoveFirstImageFromList(Image **images)
 557 </pre>
 558
 559 <p>A description of each parameter follows:</p>
 560
 561 <h5>images</h5>
 562 <p>the image list.</p>
 563
 564  </div>
 565 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
 566 <div class="doc-section">
 567
 568 <p>RemoveLastImageFromList() removes and returns the last image from the list.</p>
 569
 570 <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>
 571
 572 <p>The format of the RemoveLastImageFromList method is:</p>
 573
 574 <pre class="code">
 575   Image *RemoveLastImageFromList(Image **images)
 576 </pre>
 577
 578 <p>A description of each parameter follows:</p>
 579
 580 <h5>images</h5>
 581 <p>the image list.</p>
 582
 583  </div>
 584 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReplaceImageInList">ReplaceImageInList</a></h2>
 585 <div class="doc-section">
 586
 587 <p>ReplaceImageInList() replaces an image in the list. Old image is destroyed. The given image list pointer is set to point to the just inserted image.</p>
 588
 589 <p>The format of the ReplaceImageInList method is:</p>
 590
 591 <pre class="code">
 592   ReplaceImageInList(Image **images,Image *image)
 593 </pre>
 594
 595 <p>A description of each parameter follows:</p>
 596
 597 <h5>images</h5>
 598 <p>the image list.</p>
 599
 600 <h5>image</h5>
 601 <p>the image.</p>
 602
 603  </div>
 604 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="ReverseImageList">ReverseImageList</a></h2>
 605 <div class="doc-section">
 606
 607 <p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p>
 608
 609 <p>The format of the ReverseImageList method is:</p>
 610
 611 <pre class="code">
 612   void ReverseImageList(Image **images)
 613 </pre>
 614
 615 <p>A description of each parameter follows:</p>
 616
 617 <h5>images</h5>
 618 <p>the image list.</p>
 619
 620  </div>
 621 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="SpliceImageIntoList">SpliceImageIntoList</a></h2>
 622 <div class="doc-section">
 623
 624 <p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p>
 625
 626 <p>The format of the SpliceImageIntoList method is:</p>
 627
 628 <pre class="code">
 629   SpliceImageIntoList(Image **images,const size_t,
 630     const Image *splice)
 631 </pre>
 632
 633 <p>A description of each parameter follows:</p>
 634
 635 <h5>images</h5>
 636 <p>the image list.</p>
 637
 638 <h5>length</h5>
 639 <p>the length of the image list to remove.</p>
 640
 641 <h5>splice</h5>
 642 <p>Replace the removed image list with this list.</p>
 643
 644  </div>
 645 <h2><a href="http://www.imagemagick.org/api/MagickCore/list_8c.html" id="SplitImageList">SplitImageList</a></h2>
 646 <div class="doc-section">
 647
 648 <p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p>
 649
 650 <p>The format of the SplitImageList method is:</p>
 651
 652 <pre class="code">
 653   Image *SplitImageList(Image *images)
 654 </pre>
 655
 656 <p>A description of each parameter follows:</p>
 657
 658 <h5>images</h5>
 659 <p>the image list.</p>
 660
 661  </div>
 662 \r
 663 </div>\r
 664 \r
 665 <div id="linkbar">\r
 666     <span id="linkbar-west">&nbsp;</span>\r
 667     <span id="linkbar-center">\r
 668       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 669       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 670     </span>\r
 671     <span id="linkbar-east">&nbsp;</span>\r
 672   </div>\r
 673   <div class="footer">\r
 674     <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>\r
 675     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 676   </div>\r
 677   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 678   <script type="text/javascript">\r
 679     var _gaq = _gaq || [];\r
 680     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 681     _gaq.push(['_trackPageview']);\r
 682 \r
 683     (function() {\r
 684       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 685       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 686       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 687     })();\r
 688   </script>\r
 689 </body>\r
 690 </html>\r