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