• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1
2
3
4
5<!DOCTYPE html>
6<html lang="en">
7<head>
8  <meta charset="utf-8"  />
9  <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no"  />
10  <title>MagickCore, C API: Working with Image Lists @ ImageMagick</title>
11  <meta name="application-name" content="ImageMagick" />
12  <meta name="description" content="Use ImageMagick® to create, edit, compose, or convert bitmap images. You can resize your image, crop it, change its shades and colors, add captions, among other operations." />
13  <meta name="application-url" content="https://imagemagick.org" />
14  <meta name="generator" content="PHP" />
15  <meta name="keywords" content="magickcore, c, api:, working, with, image, lists, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" />
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-2019 ImageMagick Studio LLC" />
23  <meta name="distribution" content="Global" />
24  <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
25  <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
26  <link href="list.html" rel="canonical" />
27  <link href="../../images/wand.png" rel="icon" />
28  <link href="../../images/wand.ico" rel="shortcut icon" />
29  <link href="../assets/magick.css" rel="stylesheet" />
30</head>
31<body>
32  <header>
33  <nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
34    <a class="navbar-brand" href="../../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../../images/wand.ico"/></a>
35    <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsMagick" aria-controls="navbarsMagick" aria-expanded="false" aria-label="Toggle navigation">
36      <span class="navbar-toggler-icon"></span>
37    </button>
38
39    <div class="navbar-collapse collapse" id="navbarsMagick" style="">
40    <ul class="navbar-nav mr-auto">
41      <li class="nav-item ">
42        <a class="nav-link" href="quantize.html">Home <span class="sr-only">(current)</span></a>
43      </li>
44      <li class="nav-item ">
45        <a class="nav-link" href="../../www/download.html">Download</a>
46      </li>
47      <li class="nav-item ">
48        <a class="nav-link" href="../../www/command-line-tools.html">Tools</a>
49      </li>
50      <li class="nav-item ">
51        <a class="nav-link" href="../../www/command-line-processing.html">Command-line</a>
52      </li>
53      <li class="nav-item ">
54        <a class="nav-link" href="../../www/resources.html">Resources</a>
55      </li>
56      <li class="nav-item ">
57        <a class="nav-link" href="../../www/develop.html">Develop</a>
58      </li>
59      <li class="nav-item">
60        <a class="nav-link" target="_blank" href="https://imagemagick.org/discourse-server/">Community</a>
61      </li>
62    </ul>
63    <form class="form-inline my-2 my-lg-0" action="https://imagemagick.org/script/search.php">
64      <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search">
65      <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button>
66    </form>
67    </div>
68  </nav>
69  <div class="container">
70   <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
71         style="display:block"
72         data-ad-client="ca-pub-3129977114552745"
73         data-ad-slot="6345125851"
74         data-ad-format="auto"></ins>
75    <script>
76      (adsbygoogle = window.adsbygoogle || []).push({});
77    </script>
78
79  </div>
80  </header>
81  <main class="container">
82    <div class="magick-template">
83<div class="magick-header">
84<p class="text-center"><a href="list.html#AppendImageToList">AppendImageToList</a> &#8226; <a href="list.html#CloneImageList">CloneImageList</a> &#8226; <a href="list.html#CloneImages">CloneImages</a> &#8226; <a href="list.html#DeleteImageFromList">DeleteImageFromList</a> &#8226; <a href="list.html#DeleteImages">DeleteImages</a> &#8226; <a href="list.html#DestroyImageList">DestroyImageList</a> &#8226; <a href="list.html#DuplicateImages">DuplicateImages</a> &#8226; <a href="list.html#GetFirstImageInList">GetFirstImageInList</a> &#8226; <a href="list.html#GetImageFromList">GetImageFromList</a> &#8226; <a href="list.html#GetImageIndexInList">GetImageIndexInList</a> &#8226; <a href="list.html#GetImageListLength">GetImageListLength</a> &#8226; <a href="list.html#GetLastImageInList">GetLastImageInList</a> &#8226; <a href="list.html#GetNextImageInList">GetNextImageInList</a> &#8226; <a href="list.html#GetPreviousImageInList">GetPreviousImageInList</a> &#8226; <a href="list.html#ImageListToArray">ImageListToArray</a> &#8226; <a href="list.html#InsertImageInList">InsertImageInList</a> &#8226; <a href="list.html#NewImageList">NewImageList</a> &#8226; <a href="list.html#PrependImageToList">PrependImageToList</a> &#8226; <a href="list.html#RemoveImageFromList">RemoveImageFromList</a> &#8226; <a href="list.html#RemoveFirstImageFromList">RemoveFirstImageFromList</a> &#8226; <a href="list.html#RemoveLastImageFromList">RemoveLastImageFromList</a> &#8226; <a href="list.html#ReplaceImageInList">ReplaceImageInList</a> &#8226; <a href="list.html#ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a> &#8226; <a href="list.html#ReverseImageList">ReverseImageList</a> &#8226; <a href="list.html#SpliceImageIntoList">SpliceImageIntoList</a> &#8226; <a href="list.html#SplitImageList">SplitImageList</a></p>
85
86<h2><a href="../../api/MagickCore/list_8c.html" id="AppendImageToList">AppendImageToList</a></h2>
87
88<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>
89
90<p>The format of the AppendImageToList method is:</p>
91
92<pre class="text">
93AppendImageToList(Image *images,const Image *image)
94</pre>
95
96<p>A description of each parameter follows:</p>
97
98<dd>
99</dd>
100
101<dd> </dd>
102<dl class="dl-horizontal">
103<dt>images</dt>
104<dd>the image list to be appended to. </dd>
105
106<dd> </dd>
107<dt>image</dt>
108<dd>the appended image or image list. </dd>
109
110<dd>  </dd>
111</dl>
112<h2><a href="../../api/MagickCore/list_8c.html" id="CloneImageList">CloneImageList</a></h2>
113
114<p>CloneImageList() returns a duplicate of the image list.</p>
115
116<p>The format of the CloneImageList method is:</p>
117
118<pre class="text">
119Image *CloneImageList(const Image *images,ExceptionInfo *exception)
120</pre>
121
122<p>A description of each parameter follows:</p>
123
124<dd>
125</dd>
126
127<dd> </dd>
128<dl class="dl-horizontal">
129<dt>images</dt>
130<dd>the image list. </dd>
131
132<dd> </dd>
133<dt>exception</dt>
134<dd>return any errors or warnings in this structure. </dd>
135
136<dd>  </dd>
137</dl>
138<h2><a href="../../api/MagickCore/list_8c.html" id="CloneImages">CloneImages</a></h2>
139
140<p>CloneImages() clones one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
141
142<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 referred to multiple times to clone them multiple times. Images referred beyond the available number of images in list are ignored.</p>
143
144<p>Images referenced may be reversed, and results in a clone of those images also being made with a reversed order.</p>
145
146<p>The format of the CloneImages method is:</p>
147
148<pre class="text">
149Image *CloneImages(const Image *images,const char *scenes,
150  ExceptionInfo *exception)
151</pre>
152
153<p>A description of each parameter follows:</p>
154
155<dd>
156</dd>
157
158<dd> </dd>
159<dl class="dl-horizontal">
160<dt>images</dt>
161<dd>the image sequence. </dd>
162
163<dd> </dd>
164<dt>scenes</dt>
165<dd>This character string specifies which scenes to clone (e.g. 1,3-5,7-3,2). </dd>
166
167<dd> </dd>
168<dt>exception</dt>
169<dd>return any errors or warnings in this structure. </dd>
170
171<dd>  </dd>
172</dl>
173<h2><a href="../../api/MagickCore/list_8c.html" id="DeleteImageFromList">DeleteImageFromList</a></h2>
174
175<p>DeleteImageFromList() deletes an image from the list. List pointer is moved to the next image, if one is present. See RemoveImageFromList().</p>
176
177<p>The format of the DeleteImageFromList method is:</p>
178
179<pre class="text">
180DeleteImageFromList(Image **images)
181</pre>
182
183<p>A description of each parameter follows:</p>
184
185<dd>
186</dd>
187
188<dd> </dd>
189<dl class="dl-horizontal">
190<dt>images</dt>
191<dd>the image list. </dd>
192
193<dd>  </dd>
194</dl>
195<h2><a href="../../api/MagickCore/list_8c.html" id="DeleteImages">DeleteImages</a></h2>
196
197<p>DeleteImages() deletes one or more images from an image sequence, using a comma separated list of image numbers or ranges.</p>
198
199<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 referred to multiple times without problems. Image referred beyond the available number of images in list are ignored.</p>
200
201<p>If the referenced images are in the reverse order, that range will be completely ignored, unlike CloneImages().</p>
202
203<p>The format of the DeleteImages method is:</p>
204
205<pre class="text">
206DeleteImages(Image **images,const char *scenes,ExceptionInfo *exception)
207</pre>
208
209<p>A description of each parameter follows:</p>
210
211<dd>
212</dd>
213
214<dd> </dd>
215<dl class="dl-horizontal">
216<dt>images</dt>
217<dd>the image sequence. </dd>
218
219<dd> </dd>
220<dt>scenes</dt>
221<dd>This character string specifies which scenes to delete (e.g. 1,3-5,-2-6,2). </dd>
222
223<dd> </dd>
224<dt>exception</dt>
225<dd>return any errors or warnings in this structure. </dd>
226
227<dd>  </dd>
228</dl>
229<h2><a href="../../api/MagickCore/list_8c.html" id="DestroyImageList">DestroyImageList</a></h2>
230
231<p>DestroyImageList() destroys an image list.</p>
232
233<p>The format of the DestroyImageList method is:</p>
234
235<pre class="text">
236Image *DestroyImageList(Image *image)
237</pre>
238
239<p>A description of each parameter follows:</p>
240
241<dd>
242</dd>
243
244<dd> </dd>
245<dl class="dl-horizontal">
246<dt>image</dt>
247<dd>the image sequence. </dd>
248
249<dd>  </dd>
250</dl>
251<h2><a href="../../api/MagickCore/list_8c.html" id="DuplicateImages">DuplicateImages</a></h2>
252
253<p>DuplicateImages() duplicates one or more images from an image sequence, using a count and a comma separated list of image numbers or ranges.</p>
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 referred to multiple times without problems. Image referred beyond the available number of images in list are ignored.</p>
256
257<p>The format of the DuplicateImages method is:</p>
258
259<pre class="text">
260Image *DuplicateImages(Image *images,const size_t number_duplicates,
261  const char *scenes,ExceptionInfo *exception)
262</pre>
263
264<p>A description of each parameter follows:</p>
265
266<dd>
267</dd>
268
269<dd> </dd>
270<dl class="dl-horizontal">
271<dt>images</dt>
272<dd>the image sequence. </dd>
273
274<dd> </dd>
275<dt>number_duplicates</dt>
276<dd>duplicate the image sequence this number of times. </dd>
277
278<dd> </dd>
279<dt>scenes</dt>
280<dd>This character string specifies which scenes to duplicate (e.g. 1,3-5,-2-6,2). </dd>
281
282<dd> </dd>
283<dt>exception</dt>
284<dd>return any errors or warnings in this structure. </dd>
285
286<dd>  </dd>
287</dl>
288<h2><a href="../../api/MagickCore/list_8c.html" id="GetFirstImageInList">GetFirstImageInList</a></h2>
289
290<p>GetFirstImageInList() returns a pointer to the first image in the list.</p>
291
292<p>The format of the GetFirstImageInList method is:</p>
293
294<pre class="text">
295Image *GetFirstImageInList(const Image *images)
296</pre>
297
298<p>A description of each parameter follows:</p>
299
300<dd>
301</dd>
302
303<dd> </dd>
304<dl class="dl-horizontal">
305<dt>images</dt>
306<dd>the image list. </dd>
307
308<dd>  </dd>
309</dl>
310<h2><a href="../../api/MagickCore/list_8c.html" id="GetImageFromList">GetImageFromList</a></h2>
311
312<p>GetImageFromList() returns an image at the specified index from the image list. Starting with 0 as the first image in the list.</p>
313
314<p>A negative offset will return the image from the end of the list, such that an index of -1 is the last image.</p>
315
316<p>If no such image exists at the specified offset a NULL image pointer is returned.  This will only happen if index is less that the negative of the list length, or larger than list length -1.  EG: ( -N to N-1 )</p>
317
318<p>The format of the GetImageFromList method is:</p>
319
320<pre class="text">
321Image *GetImageFromList(const Image *images,const ssize_t index)
322</pre>
323
324<p>A description of each parameter follows:</p>
325
326<dd>
327</dd>
328
329<dd> </dd>
330<dl class="dl-horizontal">
331<dt>images</dt>
332<dd>the image list. </dd>
333
334<dd> </dd>
335<dt>index</dt>
336<dd>the position within the list. </dd>
337
338<dd>  </dd>
339</dl>
340<h2><a href="../../api/MagickCore/list_8c.html" id="GetImageIndexInList">GetImageIndexInList</a></h2>
341
342<p>GetImageIndexInList() returns the offset in the list of the specified image.</p>
343
344<p>The format of the GetImageIndexInList method is:</p>
345
346<pre class="text">
347ssize_t GetImageIndexInList(const Image *images)
348</pre>
349
350<p>A description of each parameter follows:</p>
351
352<dd>
353</dd>
354
355<dd> </dd>
356<dl class="dl-horizontal">
357<dt>images</dt>
358<dd>the image list. </dd>
359
360<dd>  </dd>
361</dl>
362<h2><a href="../../api/MagickCore/list_8c.html" id="GetImageListLength">GetImageListLength</a></h2>
363
364<p>GetImageListLength() returns the length of the list (the number of images in the list).</p>
365
366<p>The format of the GetImageListLength method is:</p>
367
368<pre class="text">
369size_t GetImageListLength(const Image *images)
370</pre>
371
372<p>A description of each parameter follows:</p>
373
374<dd>
375</dd>
376
377<dd> </dd>
378<dl class="dl-horizontal">
379<dt>images</dt>
380<dd>the image list. </dd>
381
382<dd>  </dd>
383</dl>
384<h2><a href="../../api/MagickCore/list_8c.html" id="GetLastImageInList">GetLastImageInList</a></h2>
385
386<p>GetLastImageInList() returns a pointer to the last image in the list.</p>
387
388<p>The format of the GetLastImageInList method is:</p>
389
390<pre class="text">
391Image *GetLastImageInList(const Image *images)
392</pre>
393
394<p>A description of each parameter follows:</p>
395
396<dd>
397</dd>
398
399<dd> </dd>
400<dl class="dl-horizontal">
401<dt>images</dt>
402<dd>the image list. </dd>
403
404<dd>  </dd>
405</dl>
406<h2><a href="../../api/MagickCore/list_8c.html" id="GetNextImageInList">GetNextImageInList</a></h2>
407
408<p>GetNextImageInList() returns the next image in the list.</p>
409
410<p>The format of the GetNextImageInList method is:</p>
411
412<pre class="text">
413Image *GetNextImageInList(const Image *images)
414</pre>
415
416<p>A description of each parameter follows:</p>
417
418<dd>
419</dd>
420
421<dd> </dd>
422<dl class="dl-horizontal">
423<dt>images</dt>
424<dd>the image list. </dd>
425
426<dd>  </dd>
427</dl>
428<h2><a href="../../api/MagickCore/list_8c.html" id="GetPreviousImageInList">GetPreviousImageInList</a></h2>
429
430<p>GetPreviousImageInList() returns the previous image in the list.</p>
431
432<p>The format of the GetPreviousImageInList method is:</p>
433
434<pre class="text">
435Image *GetPreviousImageInList(const Image *images)
436</pre>
437
438<p>A description of each parameter follows:</p>
439
440<dd>
441</dd>
442
443<dd> </dd>
444<dl class="dl-horizontal">
445<dt>images</dt>
446<dd>the image list. </dd>
447
448<dd>  </dd>
449</dl>
450<h2><a href="../../api/MagickCore/list_8c.html" id="ImageListToArray">ImageListToArray</a></h2>
451
452<p>ImageListToArray() is a convenience method that converts an image list to a sequential array, with a NULL image pointer at the end of the array.</p>
453
454<p>The images remain part of the original image list, with the array providing an alternative means of indexing the image array.</p>
455
456<p>group = ImageListToArray(images, exception); while (i = 0; group[i] != (Image *) NULL; i++) printf("s\n", group[i]-&gt;filename); printf("d images\n", i); group = RelinquishMagickMemory(group);</p>
457
458<p>The format of the ImageListToArray method is:</p>
459
460<pre class="text">
461Image **ImageListToArray(const Image *images,ExceptionInfo *exception)
462</pre>
463
464<p>A description of each parameter follows:</p>
465
466<dd>
467</dd>
468
469<dd> </dd>
470<dl class="dl-horizontal">
471<dt>image</dt>
472<dd>the image list. </dd>
473
474<dd> </dd>
475<dt>exception</dt>
476<dd>return any errors or warnings in this structure. </dd>
477
478<dd>  </dd>
479</dl>
480<h2><a href="../../api/MagickCore/list_8c.html" id="InsertImageInList">InsertImageInList</a></h2>
481
482<p>InsertImageInList() insert the given image or image list, into the first image list, immediately AFTER the image pointed to.  The given image list pointer is left unchanged unless previously empty.</p>
483
484<p>The format of the InsertImageInList method is:</p>
485
486<pre class="text">
487InsertImageInList(Image **images,Image *insert)
488</pre>
489
490<p>A description of each parameter follows:</p>
491
492<dd>
493</dd>
494
495<dd> </dd>
496<dl class="dl-horizontal">
497<dt>images</dt>
498<dd>the image list to insert into. </dd>
499
500<dd> </dd>
501<dt>insert</dt>
502<dd>the image list to insert. </dd>
503
504<dd>  </dd>
505</dl>
506<h2><a href="../../api/MagickCore/list_8c.html" id="NewImageList">NewImageList</a></h2>
507
508<p>NewImageList() creates an empty image list.</p>
509
510<p>The format of the NewImageList method is:</p>
511
512<pre class="text">
513Image *NewImageList(void)
514</pre>
515
516<h2><a href="../../api/MagickCore/list_8c.html" id="PrependImageToList">PrependImageToList</a></h2>
517
518<p>PrependImageToList() prepends the image to the beginning of the list.</p>
519
520<p>The format of the PrependImageToList method is:</p>
521
522<pre class="text">
523PrependImageToList(Image *images,Image *image)
524</pre>
525
526<p>A description of each parameter follows:</p>
527
528<dd>
529</dd>
530
531<dd> </dd>
532<dl class="dl-horizontal">
533<dt>images</dt>
534<dd>the image list. </dd>
535
536<dd> </dd>
537<dt>image</dt>
538<dd>the image. </dd>
539
540<dd>  </dd>
541</dl>
542<h2><a href="../../api/MagickCore/list_8c.html" id="RemoveImageFromList">RemoveImageFromList</a></h2>
543
544<p>RemoveImageFromList() removes and returns the image pointed to.</p>
545
546<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>
547
548<p>The format of the RemoveImageFromList method is:</p>
549
550<pre class="text">
551Image *RemoveImageFromList(Image **images)
552</pre>
553
554<p>A description of each parameter follows:</p>
555
556<dd>
557</dd>
558
559<dd> </dd>
560<dl class="dl-horizontal">
561<dt>images</dt>
562<dd>the image list. </dd>
563
564<dd>  </dd>
565</dl>
566<h2><a href="../../api/MagickCore/list_8c.html" id="RemoveFirstImageFromList">RemoveFirstImageFromList</a></h2>
567
568<p>RemoveFirstImageFromList() removes and returns the first image in the list.</p>
569
570<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>
571
572<p>The format of the RemoveFirstImageFromList method is:</p>
573
574<pre class="text">
575Image *RemoveFirstImageFromList(Image **images)
576</pre>
577
578<p>A description of each parameter follows:</p>
579
580<dd>
581</dd>
582
583<dd> </dd>
584<dl class="dl-horizontal">
585<dt>images</dt>
586<dd>the image list. </dd>
587
588<dd>  </dd>
589</dl>
590<h2><a href="../../api/MagickCore/list_8c.html" id="RemoveLastImageFromList">RemoveLastImageFromList</a></h2>
591
592<p>RemoveLastImageFromList() removes and returns the last image from the list.</p>
593
594<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>
595
596<p>The format of the RemoveLastImageFromList method is:</p>
597
598<pre class="text">
599Image *RemoveLastImageFromList(Image **images)
600</pre>
601
602<p>A description of each parameter follows:</p>
603
604<dd>
605</dd>
606
607<dd> </dd>
608<dl class="dl-horizontal">
609<dt>images</dt>
610<dd>the image list. </dd>
611
612<dd>  </dd>
613</dl>
614<h2><a href="../../api/MagickCore/list_8c.html" id="ReplaceImageInList">ReplaceImageInList</a></h2>
615
616<p>ReplaceImageInList() replaces an image in the list with the given image, or list of images.  Old image is destroyed.</p>
617
618<p>The images list pointer is set to point to the first image of the inserted list of images.</p>
619
620<p>The format of the ReplaceImageInList method is:</p>
621
622<pre class="text">
623ReplaceImageInList(Image **images,Image *replace)
624</pre>
625
626<p>A description of each parameter follows:</p>
627
628<dd>
629</dd>
630
631<dd> </dd>
632<dl class="dl-horizontal">
633<dt>images</dt>
634<dd>the list and pointer to image to replace </dd>
635
636<dd> </dd>
637<dt>replace</dt>
638<dd>the image or image list replacing the original </dd>
639
640<dd>  </dd>
641</dl>
642<h2><a href="../../api/MagickCore/list_8c.html" id="ReplaceImageInListReturnLast">ReplaceImageInListReturnLast</a></h2>
643
644<p>ReplaceImageInListReturnLast() is exactly as ReplaceImageInList() except the images pointer is set to the last image in the list of replacement images.</p>
645
646<p>This allows you to simply use GetNextImageInList() to go to the image that follows the just replaced image, even if a list of replacement images was inserted.</p>
647
648<p>The format of the ReplaceImageInList method is:</p>
649
650<pre class="text">
651ReplaceImageInListReturnLast(Image **images,Image *replace)
652</pre>
653
654<p>A description of each parameter follows:</p>
655
656<dd>
657</dd>
658
659<dd> </dd>
660<dl class="dl-horizontal">
661<dt>images</dt>
662<dd>the list and pointer to image to replace </dd>
663
664<dd> </dd>
665<dt>replace</dt>
666<dd>the image or image list replacing the original </dd>
667
668<dd>  </dd>
669</dl>
670<h2><a href="../../api/MagickCore/list_8c.html" id="ReverseImageList">ReverseImageList</a></h2>
671
672<p>ReverseImageList() reverses the order of an image list. The list pointer is reset to that start of the re-ordered list.</p>
673
674<p>The format of the ReverseImageList method is:</p>
675
676<pre class="text">
677void ReverseImageList(Image **images)
678</pre>
679
680<p>A description of each parameter follows:</p>
681
682<dd>
683</dd>
684
685<dd> </dd>
686<dl class="dl-horizontal">
687<dt>images</dt>
688<dd>the image list. </dd>
689
690<dd>  </dd>
691</dl>
692<h2><a href="../../api/MagickCore/list_8c.html" id="SpliceImageIntoList">SpliceImageIntoList</a></h2>
693
694<p>SpliceImageIntoList() removes 'length' images from the list and replaces them with the specified splice. Removed images are returned.</p>
695
696<p>The format of the SpliceImageIntoList method is:</p>
697
698<pre class="text">
699SpliceImageIntoList(Image **images,const size_t,
700  const Image *splice)
701</pre>
702
703<p>A description of each parameter follows:</p>
704
705<dd>
706</dd>
707
708<dd> </dd>
709<dl class="dl-horizontal">
710<dt>images</dt>
711<dd>the image list. </dd>
712
713<dd> </dd>
714<dt>length</dt>
715<dd>the length of the image list to remove. </dd>
716
717<dd> </dd>
718<dt>splice</dt>
719<dd>Replace the removed image list with this list. </dd>
720
721<dd>  </dd>
722</dl>
723<h2><a href="../../api/MagickCore/list_8c.html" id="SplitImageList">SplitImageList</a></h2>
724
725<p>SplitImageList() splits an image into two lists, after given image The list that was split off is returned, which may be empty.</p>
726
727<p>The format of the SplitImageList method is:</p>
728
729<pre class="text">
730Image *SplitImageList(Image *images)
731</pre>
732
733<p>A description of each parameter follows:</p>
734
735<dd>
736</dd>
737
738<dd> </dd>
739<dl class="dl-horizontal">
740<dt>images</dt>
741<dd>the image list. </dd>
742
743<dd>  </dd>
744</dl>
745</div>
746    </div>
747  </main><!-- /.container -->
748  <footer class="magick-footer">
749    <p><a href="../../www/security-policy.html">Security</a> •
750    <a href="../../www/architecture.html">Architecture</a> •
751    <a href="../../www/links.html">Related</a> •
752     <a href="../../www/sitemap.html">Sitemap</a>
753
754    <a href="list.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../../images/wand.ico"/></a>
755
756    <a href="http://pgp.mit.edu/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
757    <a href="../../www/support.html">Donate</a> •
758    <a href="../../www/contact.html">Contact Us</a>
759    <br/>
760    <small>© 1999-2019 ImageMagick Studio LLC</small></p>
761  </footer>
762
763  <!-- Javascript assets -->
764  <script src="../assets/magick.js" crossorigin="anonymous"></script>
765  <script>window.jQuery || document.write('<script src="https://localhost/ajax/libs/jquery/3.3.1/jquery.min.js"><\/script>')</script>
766</body>
767</html>
768<!-- Magick Cache 3rd January 2019 20:45 -->