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