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.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 127 </div>
 128 <div  class="sponsor">
 129    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 130 </div>
 131 <div  class="sponsor">
 132   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 133 </div>
 134 <div  class="sponsor">
 135   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 136 </div>
 137 <div  class="sponsor">
 138   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
 142 </div>
 143 </div>
 144 </div>
 145 \r
 146 \r
 147 </div>\r
 148 \r
 149 <div class="main">\r
 150 \r
 151 <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>
 152
 153 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 154 _8c.html" target="source" name="AppendImageToList">AppendImageToList</a></h2>
 155 <div class="doc-section">
 156
 157 <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>
 158
 159 <p>The format of the AppendImageToList method is:</p>
 160
 161 <pre class="code">
 162   AppendImageToList(Image *images,const Image *image)
 163 </pre>
 164
 165 <p>A description of each parameter follows:</p></ol>
 166
 167 <h5>images</h5>
 168 <ol><p>the image list to be appended to.</p></ol>
 169
 170 <h5>image</h5>
 171 <ol><p>the appended image or image list.</p></ol>
 172
 173  </div>
 174 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 175 _8c.html" target="source" name="CloneImageList">CloneImageList</a></h2>
 176 <div class="doc-section">
 177
 178 <p>CloneImageList() returns a duplicate of the image list.</p></ol>
 179
 180 <p>The format of the CloneImageList method is:</p>
 181
 182 <pre class="code">
 183   Image *CloneImageList(const Image *images,ExceptionInfo *exception)
 184 </pre>
 185
 186 <p>A description of each parameter follows:</p></ol>
 187
 188 <h5>images</h5>
 189 <ol><p>the image list.</p></ol>
 190
 191 <h5>exception</h5>
 192 <ol><p>return any errors or warnings in this structure.</p></ol>
 193
 194  </div>
 195 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 196 _8c.html" target="source" name="CloneImages">CloneImages</a></h2>
 197 <div class="doc-section">
 198
 199 <p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p></ol>
 200
 201 <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>
 202
 203 <p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p></ol>
 204
 205 <p>The format of the CloneImages method is:</p>
 206
 207 <pre class="code">
 208   Image *CloneImages(const Image *images,const char *scenes,
 209     ExceptionInfo *exception)
 210 </pre>
 211
 212 <p>A description of each parameter follows:</p></ol>
 213
 214 <h5>images</h5>
 215 <ol><p>the image sequence.</p></ol>
 216
 217 <h5>scenes</h5>
 218 <ol><p>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2).</p></ol>
 219
 220 <h5>exception</h5>
 221 <ol><p>return any errors or warnings in this structure.</p></ol>
 222
 223  </div>
 224 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 225 _8c.html" target="source" name="DeleteImageFromList">DeleteImageFromList</a></h2>
 226 <div class="doc-section">
 227
 228 <p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p></ol>
 229
 230 <p>The format of the DeleteImageFromList method is:</p>
 231
 232 <pre class="code">
 233   DeleteImageFromList(Image **images)
 234 </pre>
 235
 236 <p>A description of each parameter follows:</p></ol>
 237
 238 <h5>images</h5>
 239 <ol><p>the image list.</p></ol>
 240
 241  </div>
 242 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 243 _8c.html" target="source" name="DeleteImages">DeleteImages</a></h2>
 244 <div class="doc-section">
 245
 246 <p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p></ol>
 247
 248 <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>
 249
 250 <p>If the referenced images are in the reverse order, that range will be completely ignored.  Unlike CloneImages().</p></ol>
 251
 252 <p>The format of the DeleteImages method is:</p>
 253
 254 <pre class="code">
 255   DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
 256 </pre>
 257
 258 <p>A description of each parameter follows:</p></ol>
 259
 260 <h5>images</h5>
 261 <ol><p>the image sequence.</p></ol>
 262
 263 <h5>scenes</h5>
 264 <ol><p>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2).</p></ol>
 265
 266 <h5>exception</h5>
 267 <ol><p>return any errors or warnings in this structure.</p></ol>
 268
 269  </div>
 270 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 271 _8c.html" target="source" name="DestroyImageList">DestroyImageList</a></h2>
 272 <div class="doc-section">
 273
 274 <p>DestroyImageList() destroys an image list.</p></ol>
 275
 276 <p>The format of the DestroyImageList method is:</p>
 277
 278 <pre class="code">
 279   Image *DestroyImageList(Image *image)
 280 </pre>
 281
 282 <p>A description of each parameter follows:</p></ol>
 283
 284 <h5>image</h5>
 285 <ol><p>the image sequence.</p></ol>
 286
 287  </div>
 288 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 289 _8c.html" target="source" name="GetFirstImageInList">GetFirstImageInList</a></h2>
 290 <div class="doc-section">
 291
 292 <p>GetFirstImageInList() returns a pointer to the first image in the list.</p></ol>
 293
 294 <p>The format of the GetFirstImageInList method is:</p>
 295
 296 <pre class="code">
 297   Image *GetFirstImageInList(const Image *images)
 298 </pre>
 299
 300 <p>A description of each parameter follows:</p></ol>
 301
 302 <h5>images</h5>
 303 <ol><p>the image list.</p></ol>
 304
 305  </div>
 306 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 307 _8c.html" target="source" name="GetImageFromList">GetImageFromList</a></h2>
 308 <div class="doc-section">
 309
 310 <p>GetImageFromList() returns an image at the specified offset from the list.</p></ol>
 311
 312 <p>The format of the GetImageFromList method is:</p>
 313
 314 <pre class="code">
 315   Image *GetImageFromList(const Image *images,const long index)
 316 </pre>
 317
 318 <p>A description of each parameter follows:</p></ol>
 319
 320 <h5>images</h5>
 321 <ol><p>the image list.</p></ol>
 322
 323 <h5>index</h5>
 324 <ol><p>the position within the list.</p></ol>
 325
 326  </div>
 327 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 328 _8c.html" target="source" name="GetImageIndexInList">GetImageIndexInList</a></h2>
 329 <div class="doc-section">
 330
 331 <p>GetImageIndexInList() returns the offset in the list of the specified image.</p></ol>
 332
 333 <p>The format of the GetImageIndexInList method is:</p>
 334
 335 <pre class="code">
 336   long GetImageIndexInList(const Image *images)
 337 </pre>
 338
 339 <p>A description of each parameter follows:</p></ol>
 340
 341 <h5>images</h5>
 342 <ol><p>the image list.</p></ol>
 343
 344  </div>
 345 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 346 _8c.html" target="source" name="GetImageListLength">GetImageListLength</a></h2>
 347 <div class="doc-section">
 348
 349 <p>GetImageListLength() returns the length of the list (the number of images in the list).</p></ol>
 350
 351 <p>The format of the GetImageListLength method is:</p>
 352
 353 <pre class="code">
 354   unsigned long GetImageListLength(const Image *images)
 355 </pre>
 356
 357 <p>A description of each parameter follows:</p></ol>
 358
 359 <h5>images</h5>
 360 <ol><p>the image list.</p></ol>
 361
 362  </div>
 363 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 364 _8c.html" target="source" name="GetLastImageInList">GetLastImageInList</a></h2>
 365 <div class="doc-section">
 366
 367 <p>GetLastImageInList() returns a pointer to the last image in the list.</p></ol>
 368
 369 <p>The format of the GetLastImageInList method is:</p>
 370
 371 <pre class="code">
 372   Image *GetLastImageInList(const Image *images)
 373 </pre>
 374
 375 <p>A description of each parameter follows:</p></ol>
 376
 377 <h5>images</h5>
 378 <ol><p>the image list.</p></ol>
 379
 380  </div>
 381 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 382 _8c.html" target="source" name="GetNextImageInList">GetNextImageInList</a></h2>
 383 <div class="doc-section">
 384
 385 <p>GetNextImageInList() returns the next image in the list.</p></ol>
 386
 387 <p>The format of the GetNextImageInList method is:</p>
 388
 389 <pre class="code">
 390   Image *GetNextImageInList(const Image *images)
 391 </pre>
 392
 393 <p>A description of each parameter follows:</p></ol>
 394
 395 <h5>images</h5>
 396 <ol><p>the image list.</p></ol>
 397
 398  </div>
 399 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 400 _8c.html" target="source" name="GetPreviousImageInList">GetPreviousImageInList</a></h2>
 401 <div class="doc-section">
 402
 403 <p>GetPreviousImageInList() returns the previous image in the list.</p></ol>
 404
 405 <p>The format of the GetPreviousImageInList method is:</p>
 406
 407 <pre class="code">
 408   Image *GetPreviousImageInList(const Image *images)
 409 </pre>
 410
 411 <p>A description of each parameter follows:</p></ol>
 412
 413 <h5>images</h5>
 414 <ol><p>the image list.</p></ol>
 415
 416  </div>
 417 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 418 _8c.html" target="source" name="ImageListToArray">ImageListToArray</a></h2>
 419 <div class="doc-section">
 420
 421 <p>ImageListToArray() is a convenience method that converts an image list to a sequential array.  For example,</p></ol>
 422
 423 <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>
 424
 425 <p>The format of the ImageListToArray method is:</p>
 426
 427 <pre class="code">
 428   Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
 429 </pre>
 430
 431 <p>A description of each parameter follows:</p></ol>
 432
 433 <h5>image</h5>
 434 <ol><p>the image list.</p></ol>
 435
 436 <h5>exception</h5>
 437 <ol><p>return any errors or warnings in this structure.</p></ol>
 438
 439  </div>
 440 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 441 _8c.html" target="source" name="InsertImageInList">InsertImageInList</a></h2>
 442 <div class="doc-section">
 443
 444 <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>
 445
 446 <p>The format of the InsertImageInList method is:</p>
 447
 448 <pre class="code">
 449   InsertImageInList(Image **images,Image *image)
 450 </pre>
 451
 452 <p>A description of each parameter follows:</p></ol>
 453
 454 <h5>images</h5>
 455 <ol><p>the image list to insert into.</p></ol>
 456
 457 <h5>image</h5>
 458 <ol><p>the image list to insert.</p></ol>
 459
 460  </div>
 461 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 462 _8c.html" target="source" name="NewImageList">NewImageList</a></h2>
 463 <div class="doc-section">
 464
 465 <p>NewImageList() creates an empty image list.</p></ol>
 466
 467 <p>The format of the NewImageList method is:</p>
 468
 469 <pre class="code">
 470   Image *NewImageList(void)
 471 </pre>
 472
 473  </div>
 474 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 475 _8c.html" target="source" name="PrependImageToList">PrependImageToList</a></h2>
 476 <div class="doc-section">
 477
 478 <p>PrependImageToList() prepends the image to the beginning of the list.</p></ol>
 479
 480 <p>The format of the PrependImageToList method is:</p>
 481
 482 <pre class="code">
 483   PrependImageToList(Image *images,Image *image)
 484 </pre>
 485
 486 <p>A description of each parameter follows:</p></ol>
 487
 488 <h5>images</h5>
 489 <ol><p>the image list.</p></ol>
 490
 491 <h5>image</h5>
 492 <ol><p>the image.</p></ol>
 493
 494  </div>
 495 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 496 _8c.html" target="source" name="RemoveImageFromList">RemoveImageFromList</a></h2>
 497 <div class="doc-section">
 498
 499 <p>RemoveImageFromList() removes and returns the image pointed to.</p></ol>
 500
 501 <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>
 502
 503 <p>The format of the RemoveImageFromList method is:</p>
 504
 505 <pre class="code">
 506   Image *RemoveImageFromList(Image **images)
 507 </pre>
 508
 509 <p>A description of each parameter follows:</p></ol>
 510
 511 <h5>images</h5>
 512 <ol><p>the image list.</p></ol>
 513
 514  </div>
 515 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 516 _8c.html" target="source" name="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
 517 <div class="doc-section">
 518
 519 <p>RemoveFirstImageFromList() removes and returns the first image in the list.</p></ol>
 520
 521 <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>
 522
 523 <p>The format of the RemoveFirstImageFromList method is:</p>
 524
 525 <pre class="code">
 526   Image *RemoveFirstImageFromList(Image **images)
 527 </pre>
 528
 529 <p>A description of each parameter follows:</p></ol>
 530
 531 <h5>images</h5>
 532 <ol><p>the image list.</p></ol>
 533
 534  </div>
 535 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 536 _8c.html" target="source" name="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
 537 <div class="doc-section">
 538
 539 <p>RemoveLastImageFromList() removes and returns the last image from the list.</p></ol>
 540
 541 <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>
 542
 543 <p>The format of the RemoveLastImageFromList method is:</p>
 544
 545 <pre class="code">
 546   Image *RemoveLastImageFromList(Image **images)
 547 </pre>
 548
 549 <p>A description of each parameter follows:</p></ol>
 550
 551 <h5>images</h5>
 552 <ol><p>the image list.</p></ol>
 553
 554  </div>
 555 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 556 _8c.html" target="source" name="ReplaceImageInList">ReplaceImageInList</a></h2>
 557 <div class="doc-section">
 558
 559 <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>
 560
 561 <p>The format of the ReplaceImageInList method is:</p>
 562
 563 <pre class="code">
 564   ReplaceImageInList(Image **images,Image *image)
 565 </pre>
 566
 567 <p>A description of each parameter follows:</p></ol>
 568
 569 <h5>images</h5>
 570 <ol><p>the image list.</p></ol>
 571
 572 <h5>image</h5>
 573 <ol><p>the image.</p></ol>
 574
 575  </div>
 576 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 577 _8c.html" target="source" name="ReverseImageList">ReverseImageList</a></h2>
 578 <div class="doc-section">
 579
 580 <p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p></ol>
 581
 582 <p>The format of the ReverseImageList method is:</p>
 583
 584 <pre class="code">
 585   void ReverseImageList(Image **images)
 586 </pre>
 587
 588 <p>A description of each parameter follows:</p></ol>
 589
 590 <h5>images</h5>
 591 <ol><p>the image list.</p></ol>
 592
 593  </div>
 594 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 595 _8c.html" target="source" name="SpliceImageIntoList">SpliceImageIntoList</a></h2>
 596 <div class="doc-section">
 597
 598 <p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p></ol>
 599
 600 <p>The format of the SpliceImageIntoList method is:</p>
 601
 602 <pre class="code">
 603   SpliceImageIntoList(Image **images,const unsigned long,
 604     const Image *splice)
 605 </pre>
 606
 607 <p>A description of each parameter follows:</p></ol>
 608
 609 <h5>images</h5>
 610 <ol><p>the image list.</p></ol>
 611
 612 <h5>length</h5>
 613 <ol><p>the length of the image list to remove.</p></ol>
 614
 615 <h5>splice</h5>
 616 <ol><p>Replace the removed image list with this list.</p></ol>
 617
 618  </div>
 619 <h2><a href="http://www.imagemagick.org/api/MagickCore/list
 620 _8c.html" target="source" name="SplitImageList">SplitImageList</a></h2>
 621 <div class="doc-section">
 622
 623 <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>
 624
 625 <p>The format of the SplitImageList method is:</p>
 626
 627 <pre class="code">
 628   Image *SplitImageList(Image *images)
 629 </pre>
 630
 631 <p>A description of each parameter follows:</p></ol>
 632
 633 <h5>images</h5>
 634 <ol><p>the image list.</p></ol>
 635
 636  </div>
 637 \r
 638 </div>\r
 639 \r
 640 <div id="linkbar">\r
 641  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 642     <span id="linkbar-center">\r
 643       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 644       <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;\r
 645     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 646     </span>\r
 647     <span id="linkbar-east">&nbsp;</span>\r
 648   </div>\r
 649   <div class="footer">\r
 650     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
 651     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 652   </div>\r
 653   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 654 </body>\r
 655 </html>\r