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