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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
   4 <head>\r
   5   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   6   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   7   <style type="text/css" media="screen,projection"><!--\r
   8     @import url("../../www/magick.css");\r
   9   --></style>\r
  10   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  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="Generator" content="PHP"/>
  16   <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"/>
  17   <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
  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-2009 ImageMagick Studio LLC"/>
  25   <meta name="Distribution" content="Global"/>
  26 </head>\r
  27 \r
  28 <body id="www-imagemagick-org">\r
  29 <div class="titlebar">\r
  30 <a href="../../index.html">\r
  31   <img src="../../images/script.png" alt="[ImageMagick]"\r
  32   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  33 <a href="http://www.networkredux.com">\r
  34   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  35   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  36 <a href="http://www.imagemagick.org/discourse-server/">\r
  37   <img src="../../images/logo.jpg" alt=""\r
  38   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  39 <a href="../../index.html">\r
  40   <img src="../../images/sprite.jpg" alt=""\r
  41   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  42 </div>\r
  43 \r
  44 <div class="eastbar">\r
  45 \r
  46 <div class="menu">
  47   <a href="../../index.html">About ImageMagick</a>
  48 </div>
  49 <div class="sep"></div>\r
  50 <div class="menu">
  51   <a href="../../www/command-line-tools.html">Command-line Tools</a>
  52 </div>
  53 <div class="sub">
  54     <a href="../../www/command-line-processing.html">Processing</a>
  55 </div>
  56 <div class="sub">
  57     <a href="../../www/command-line-options.html">Options</a>
  58 </div>
  59 <div class="sub">
  60     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  61 </div>
  62 <div class="menu">
  63   <a href="../../www/api.html">Program Interfaces</a>
  64 </div>
  65 <div class="sub">
  66     <a href="../../www/magick-wand.html">MagickWand</a>
  67 </div>
  68 <div class="sub">
  69     <a href="../../www/magick-core.html">MagickCore</a>
  70 </div>
  71 <div class="sub">
  72     <a href="../../www/perl-magick.html">PerlMagick</a>
  73 </div>
  74 <div class="sub">
  75     <a href="../../Magick++/">Magick++</a>
  76 </div>
  77 <div class="menu">
  78   <a href="../../www/architecture.html">Architecture</a>
  79 </div>
  80 <div class="sep"></div>\r
  81 <div  class="menu">
  82    <a href="../../www/install-source.html">Install from Source</a>
  83 </div>
  84 <div class="sub">
  85     <a href="../../www/install-source.html#unix">Unix</a>
  86 </div>
  87 <div class="sub">
  88     <a href="../../www/install-source.html#windows">Windows</a>
  89  </div>
  90 <div class="menu">
  91   <a href="../../www/binary-releases.html">Binary Releases</a>
  92 </div>
  93 <div class="sub">
  94     <a href="../../www/binary-releases.html#unix">Unix</a>
  95 </div>
  96 <div class="sub">
  97     <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
  98 </div>
  99 <div class="sub">
 100     <a href="../../www/binary-releases.html#windows">Windows</a>
 101 </div>
 102 <div class="menu">
 103   <a href="../../www/resources.html">Resources</a>
 104 </div>
 105 <div class="sep"></div>\r
 106 <div class="menu">
 107   <a href="../../www/download.html">Download</a>
 108 </div>
 109 <div class="sep"></div>\r
 110 <div class="menu">
 111   <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 112 </div>
 113 <div class="sep"></div>\r
 114 <div class="menu">
 115   <a href="../../www/sitemap.html">Site Map</a>
 116 </div>
 117 <div  class="sub">
 118     <a href="../../www/links.html">Links</a>
 119 </div>
 120 <div class="sep"></div>\r
 121 <div  class="menu">
 122   <a href="../../www/sponsors.html">Sponsors:</a>
 123
 124 <div class="sponsbox">
 125 <div  class="sponsor">
 126    <a href="http://www.buerodruck.de/stempel-service/index.html">Stempel bestellen</a><!-- 200910000035+ -->
 127 </div>
 128 <div  class="sponsor">
 129   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201003010120 Buchhorn -->
 130 </div>
 131 <div  class="sponsor">
 132   <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 133 </div>
 134 <div  class="sponsor">
 135    <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 136 </div>
 137 <div  class="sponsor">
 138    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 142 </div>
 143 <div  class="sponsor">
 144   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 145 </div>
 146 </div>
 147 </div>
 148 \r
 149 \r
 150 </div>\r
 151 \r
 152 <div class="main">\r
 153 \r
 154 <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>
 155
 156 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 157 _8c.html" target="source" name="AppendImageToList">AppendImageToList</a></h2>
 158 <div class="doc-section">
 159
 160 <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></ol>
 161
 162 <p>The format of the AppendImageToList method is:</p>
 163
 164 <pre class="code">
 165   AppendImageToList(Image *images,const Image *image)
 166 </pre>
 167
 168 <p>A description of each parameter follows:</p></ol>
 169
 170 <h5>images</h5>
 171 <ol><p>the image list to be appended to.</p></ol>
 172
 173 <h5>image</h5>
 174 <ol><p>the appended image or image list.</p></ol>
 175
 176  </div>
 177 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 178 _8c.html" target="source" name="CloneImageList">CloneImageList</a></h2>
 179 <div class="doc-section">
 180
 181 <p>CloneImageList() returns a duplicate of the image list.</p></ol>
 182
 183 <p>The format of the CloneImageList method is:</p>
 184
 185 <pre class="code">
 186   Image *CloneImageList(const Image *images,ExceptionInfo *exception)
 187 </pre>
 188
 189 <p>A description of each parameter follows:</p></ol>
 190
 191 <h5>images</h5>
 192 <ol><p>the image list.</p></ol>
 193
 194 <h5>exception</h5>
 195 <ol><p>return any errors or warnings in this structure.</p></ol>
 196
 197  </div>
 198 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 199 _8c.html" target="source" name="CloneImages">CloneImages</a></h2>
 200 <div class="doc-section">
 201
 202 <p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p></ol>
 203
 204 <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></ol>
 205
 206 <p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p></ol>
 207
 208 <p>The format of the CloneImages method is:</p>
 209
 210 <pre class="code">
 211   Image *CloneImages(const Image *images,const char *scenes,
 212     ExceptionInfo *exception)
 213 </pre>
 214
 215 <p>A description of each parameter follows:</p></ol>
 216
 217 <h5>images</h5>
 218 <ol><p>the image sequence.</p></ol>
 219
 220 <h5>scenes</h5>
 221 <ol><p>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2).</p></ol>
 222
 223 <h5>exception</h5>
 224 <ol><p>return any errors or warnings in this structure.</p></ol>
 225
 226  </div>
 227 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 228 _8c.html" target="source" name="DeleteImageFromList">DeleteImageFromList</a></h2>
 229 <div class="doc-section">
 230
 231 <p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p></ol>
 232
 233 <p>The format of the DeleteImageFromList method is:</p>
 234
 235 <pre class="code">
 236   DeleteImageFromList(Image **images)
 237 </pre>
 238
 239 <p>A description of each parameter follows:</p></ol>
 240
 241 <h5>images</h5>
 242 <ol><p>the image list.</p></ol>
 243
 244  </div>
 245 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 246 _8c.html" target="source" name="DeleteImages">DeleteImages</a></h2>
 247 <div class="doc-section">
 248
 249 <p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p></ol>
 250
 251 <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></ol>
 252
 253 <p>If the referenced images are in the reverse order, that range will be completely ignored.  Unlike CloneImages().</p></ol>
 254
 255 <p>The format of the DeleteImages method is:</p>
 256
 257 <pre class="code">
 258   DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
 259 </pre>
 260
 261 <p>A description of each parameter follows:</p></ol>
 262
 263 <h5>images</h5>
 264 <ol><p>the image sequence.</p></ol>
 265
 266 <h5>scenes</h5>
 267 <ol><p>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2).</p></ol>
 268
 269 <h5>exception</h5>
 270 <ol><p>return any errors or warnings in this structure.</p></ol>
 271
 272  </div>
 273 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 274 _8c.html" target="source" name="DestroyImageList">DestroyImageList</a></h2>
 275 <div class="doc-section">
 276
 277 <p>DestroyImageList() destroys an image list.</p></ol>
 278
 279 <p>The format of the DestroyImageList method is:</p>
 280
 281 <pre class="code">
 282   Image *DestroyImageList(Image *image)
 283 </pre>
 284
 285 <p>A description of each parameter follows:</p></ol>
 286
 287 <h5>image</h5>
 288 <ol><p>the image sequence.</p></ol>
 289
 290  </div>
 291 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 292 _8c.html" target="source" name="GetFirstImageInList">GetFirstImageInList</a></h2>
 293 <div class="doc-section">
 294
 295 <p>GetFirstImageInList() returns a pointer to the first image in the list.</p></ol>
 296
 297 <p>The format of the GetFirstImageInList method is:</p>
 298
 299 <pre class="code">
 300   Image *GetFirstImageInList(const Image *images)
 301 </pre>
 302
 303 <p>A description of each parameter follows:</p></ol>
 304
 305 <h5>images</h5>
 306 <ol><p>the image list.</p></ol>
 307
 308  </div>
 309 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 310 _8c.html" target="source" name="GetImageFromList">GetImageFromList</a></h2>
 311 <div class="doc-section">
 312
 313 <p>GetImageFromList() returns an image at the specified offset from the list.</p></ol>
 314
 315 <p>The format of the GetImageFromList method is:</p>
 316
 317 <pre class="code">
 318   Image *GetImageFromList(const Image *images,const long index)
 319 </pre>
 320
 321 <p>A description of each parameter follows:</p></ol>
 322
 323 <h5>images</h5>
 324 <ol><p>the image list.</p></ol>
 325
 326 <h5>index</h5>
 327 <ol><p>the position within the list.</p></ol>
 328
 329  </div>
 330 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 331 _8c.html" target="source" name="GetImageIndexInList">GetImageIndexInList</a></h2>
 332 <div class="doc-section">
 333
 334 <p>GetImageIndexInList() returns the offset in the list of the specified image.</p></ol>
 335
 336 <p>The format of the GetImageIndexInList method is:</p>
 337
 338 <pre class="code">
 339   long GetImageIndexInList(const Image *images)
 340 </pre>
 341
 342 <p>A description of each parameter follows:</p></ol>
 343
 344 <h5>images</h5>
 345 <ol><p>the image list.</p></ol>
 346
 347  </div>
 348 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 349 _8c.html" target="source" name="GetImageListLength">GetImageListLength</a></h2>
 350 <div class="doc-section">
 351
 352 <p>GetImageListLength() returns the length of the list (the number of images in the list).</p></ol>
 353
 354 <p>The format of the GetImageListLength method is:</p>
 355
 356 <pre class="code">
 357   unsigned long GetImageListLength(const Image *images)
 358 </pre>
 359
 360 <p>A description of each parameter follows:</p></ol>
 361
 362 <h5>images</h5>
 363 <ol><p>the image list.</p></ol>
 364
 365  </div>
 366 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 367 _8c.html" target="source" name="GetLastImageInList">GetLastImageInList</a></h2>
 368 <div class="doc-section">
 369
 370 <p>GetLastImageInList() returns a pointer to the last image in the list.</p></ol>
 371
 372 <p>The format of the GetLastImageInList method is:</p>
 373
 374 <pre class="code">
 375   Image *GetLastImageInList(const Image *images)
 376 </pre>
 377
 378 <p>A description of each parameter follows:</p></ol>
 379
 380 <h5>images</h5>
 381 <ol><p>the image list.</p></ol>
 382
 383  </div>
 384 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 385 _8c.html" target="source" name="GetNextImageInList">GetNextImageInList</a></h2>
 386 <div class="doc-section">
 387
 388 <p>GetNextImageInList() returns the next image in the list.</p></ol>
 389
 390 <p>The format of the GetNextImageInList method is:</p>
 391
 392 <pre class="code">
 393   Image *GetNextImageInList(const Image *images)
 394 </pre>
 395
 396 <p>A description of each parameter follows:</p></ol>
 397
 398 <h5>images</h5>
 399 <ol><p>the image list.</p></ol>
 400
 401  </div>
 402 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 403 _8c.html" target="source" name="GetPreviousImageInList">GetPreviousImageInList</a></h2>
 404 <div class="doc-section">
 405
 406 <p>GetPreviousImageInList() returns the previous image in the list.</p></ol>
 407
 408 <p>The format of the GetPreviousImageInList method is:</p>
 409
 410 <pre class="code">
 411   Image *GetPreviousImageInList(const Image *images)
 412 </pre>
 413
 414 <p>A description of each parameter follows:</p></ol>
 415
 416 <h5>images</h5>
 417 <ol><p>the image list.</p></ol>
 418
 419  </div>
 420 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 421 _8c.html" target="source" name="ImageListToArray">ImageListToArray</a></h2>
 422 <div class="doc-section">
 423
 424 <p>ImageListToArray() is a convenience method that converts an image list to a sequential array.  For example,</p></ol>
 425
 426 <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></ol>
 427
 428 <p>The format of the ImageListToArray method is:</p>
 429
 430 <pre class="code">
 431   Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
 432 </pre>
 433
 434 <p>A description of each parameter follows:</p></ol>
 435
 436 <h5>image</h5>
 437 <ol><p>the image list.</p></ol>
 438
 439 <h5>exception</h5>
 440 <ol><p>return any errors or warnings in this structure.</p></ol>
 441
 442  </div>
 443 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 444 _8c.html" target="source" name="InsertImageInList">InsertImageInList</a></h2>
 445 <div class="doc-section">
 446
 447 <p>InsertImageInList() inserts the second image or image list into the first image list immediatally after the image pointed to.  The given image list pointer is unchanged unless previously empty.</p></ol>
 448
 449 <p>The format of the InsertImageInList method is:</p>
 450
 451 <pre class="code">
 452   InsertImageInList(Image **images,Image *image)
 453 </pre>
 454
 455 <p>A description of each parameter follows:</p></ol>
 456
 457 <h5>images</h5>
 458 <ol><p>the image list to insert into.</p></ol>
 459
 460 <h5>image</h5>
 461 <ol><p>the image list to insert.</p></ol>
 462
 463  </div>
 464 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 465 _8c.html" target="source" name="NewImageList">NewImageList</a></h2>
 466 <div class="doc-section">
 467
 468 <p>NewImageList() creates an empty image list.</p></ol>
 469
 470 <p>The format of the NewImageList method is:</p>
 471
 472 <pre class="code">
 473   Image *NewImageList(void)
 474 </pre>
 475
 476  </div>
 477 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 478 _8c.html" target="source" name="PrependImageToList">PrependImageToList</a></h2>
 479 <div class="doc-section">
 480
 481 <p>PrependImageToList() prepends the image to the beginning of the list.</p></ol>
 482
 483 <p>The format of the PrependImageToList method is:</p>
 484
 485 <pre class="code">
 486   PrependImageToList(Image *images,Image *image)
 487 </pre>
 488
 489 <p>A description of each parameter follows:</p></ol>
 490
 491 <h5>images</h5>
 492 <ol><p>the image list.</p></ol>
 493
 494 <h5>image</h5>
 495 <ol><p>the image.</p></ol>
 496
 497  </div>
 498 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 499 _8c.html" target="source" name="RemoveImageFromList">RemoveImageFromList</a></h2>
 500 <div class="doc-section">
 501
 502 <p>RemoveImageFromList() removes and returns the image pointed to.</p></ol>
 503
 504 <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></ol>
 505
 506 <p>The format of the RemoveImageFromList method is:</p>
 507
 508 <pre class="code">
 509   Image *RemoveImageFromList(Image **images)
 510 </pre>
 511
 512 <p>A description of each parameter follows:</p></ol>
 513
 514 <h5>images</h5>
 515 <ol><p>the image list.</p></ol>
 516
 517  </div>
 518 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 519 _8c.html" target="source" name="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
 520 <div class="doc-section">
 521
 522 <p>RemoveFirstImageFromList() removes and returns the first image in the list.</p></ol>
 523
 524 <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></ol>
 525
 526 <p>The format of the RemoveFirstImageFromList method is:</p>
 527
 528 <pre class="code">
 529   Image *RemoveFirstImageFromList(Image **images)
 530 </pre>
 531
 532 <p>A description of each parameter follows:</p></ol>
 533
 534 <h5>images</h5>
 535 <ol><p>the image list.</p></ol>
 536
 537  </div>
 538 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 539 _8c.html" target="source" name="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
 540 <div class="doc-section">
 541
 542 <p>RemoveLastImageFromList() removes and returns the last image from the list.</p></ol>
 543
 544 <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></ol>
 545
 546 <p>The format of the RemoveLastImageFromList method is:</p>
 547
 548 <pre class="code">
 549   Image *RemoveLastImageFromList(Image **images)
 550 </pre>
 551
 552 <p>A description of each parameter follows:</p></ol>
 553
 554 <h5>images</h5>
 555 <ol><p>the image list.</p></ol>
 556
 557  </div>
 558 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 559 _8c.html" target="source" name="ReplaceImageInList">ReplaceImageInList</a></h2>
 560 <div class="doc-section">
 561
 562 <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></ol>
 563
 564 <p>The format of the ReplaceImageInList method is:</p>
 565
 566 <pre class="code">
 567   ReplaceImageInList(Image **images,Image *image)
 568 </pre>
 569
 570 <p>A description of each parameter follows:</p></ol>
 571
 572 <h5>images</h5>
 573 <ol><p>the image list.</p></ol>
 574
 575 <h5>image</h5>
 576 <ol><p>the image.</p></ol>
 577
 578  </div>
 579 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 580 _8c.html" target="source" name="ReverseImageList">ReverseImageList</a></h2>
 581 <div class="doc-section">
 582
 583 <p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p></ol>
 584
 585 <p>The format of the ReverseImageList method is:</p>
 586
 587 <pre class="code">
 588   void ReverseImageList(Image **images)
 589 </pre>
 590
 591 <p>A description of each parameter follows:</p></ol>
 592
 593 <h5>images</h5>
 594 <ol><p>the image list.</p></ol>
 595
 596  </div>
 597 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 598 _8c.html" target="source" name="SpliceImageIntoList">SpliceImageIntoList</a></h2>
 599 <div class="doc-section">
 600
 601 <p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p></ol>
 602
 603 <p>The format of the SpliceImageIntoList method is:</p>
 604
 605 <pre class="code">
 606   SpliceImageIntoList(Image **images,const unsigned long,
 607     const Image *splice)
 608 </pre>
 609
 610 <p>A description of each parameter follows:</p></ol>
 611
 612 <h5>images</h5>
 613 <ol><p>the image list.</p></ol>
 614
 615 <h5>length</h5>
 616 <ol><p>the length of the image list to remove.</p></ol>
 617
 618 <h5>splice</h5>
 619 <ol><p>Replace the removed image list with this list.</p></ol>
 620
 621  </div>
 622 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 623 _8c.html" target="source" name="SplitImageList">SplitImageList</a></h2>
 624 <div class="doc-section">
 625
 626 <p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p></ol>
 627
 628 <p>The format of the SplitImageList method is:</p>
 629
 630 <pre class="code">
 631   Image *SplitImageList(Image *images)
 632 </pre>
 633
 634 <p>A description of each parameter follows:</p></ol>
 635
 636 <h5>images</h5>
 637 <ol><p>the image list.</p></ol>
 638
 639  </div>
 640 \r
 641 </div>\r
 642 \r
 643 <div id="linkbar">\r
 644  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 645     <span id="linkbar-center">\r
 646       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 647       <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;\r
 648     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 649     </span>\r
 650     <span id="linkbar-east">&nbsp;</span>\r
 651   </div>\r
 652   <div class="footer">\r
 653     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
 654     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 655   </div>\r
 656   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 657 </body>\r
 658 </html>\r