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