Magick++ STL Support

Magick++ provides a set of Standard Template Libary (STL ) algorithms for operating across ranges of image frames in a container. It also provides a set of STL unary function objects to apply an operation on image frames in a container via an algorithm which uses unary function objects. A good example of a standard algorithm which is useful for processing containers of image frames is the STL for_each algorithm which invokes a unary function object on a range of container elements.

Magick++ uses a limited set of template argument types. The current template argument types are:

Container
A container having the properties of a Back Insertion Sequence . Sequences support forward iterators and Back Insertion Sequences support the additional abilty to append an element via push_back(). Common compatable container types are the STL < vector > and <list > template containers. This template argument is usually used to represent an output container in which one or more image frames may be appended. Containers like STL <vector > which have a given default capacity may need to have their capacity adjusted via reserve() to a larger capacity in order to support the expected final size . Since Magick++ images are very small, it is likely that the default capacity of STL < vector > is sufficient for most situations.
InputIterator
An input iterator used to express a position in a container. These template arguments are typically used to represent a range of elements with first_ representing the first element to be processed and last_ representing the element to stop at. When processing the entire contents of a container, it is handy to know that STL containers usually provide the begin() and end() methods to return input interators which correspond with the first and last elements, respectively.
The following is an example of how frames from a GIF animation "test_image_anim.gif" may be appended horizontally with the resulting image written to the file "appended_image.miff":

#include <list>
#include <Magick++.h>
using namespace std;
using namespace Magick;

int main(int /*argc*/,char **/*argv*/)
{
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list&lt>
   list