ImageMagick has a number of functions that allow you to read, manipulate, write, or display an image. These functions are accessible through the various tools or the object-oriented Perl interface, PerlMagick. However, you can also access the functions directly from your program through the Magick Application Programmer Interface. To invoke the functions, write your program in your favorite language while making calls to the Magick image functions and link with libMagick.a, libMagick.so, or Magick.dll depending on your system.
The API is divided into a number of categories:
Here is a full example of a program, example.c, that reads a JPEG image, creates a thumbnail, and writes it to disk in the GIF image format.
#include <magick.h> int main(int argc,char **argv) { Image *image, *scaled_image; ImageInfo image_info; /* Initialize the image info structure and read an image. */ GetImageInfo(&image_info); (void) strcpy(image_info.filename,"image.jpg"); image=ReadImage(&image_info); if (image == (Image *) NULL) exit(1); /* Turn the image into a thumbnail. */ scaled_image=ZoomImage(image,106,80); if (scaled_image != (Image *) NULL) { DestroyImage(image); image=scaled_image; } /* Write the image as GIF and destroy it. */ (void) strcpy(image->filename,"image.png"); WriteImage(&image_info,image); DestroyImage(image); }Now we need to compile. On Unix, the command would look something like this:
cc -o example -O -I/usr/local/include/magick example.c \ -L/usr/local/lib -lMagick -ltiff -ljpeg -lX11 -lz -lmAnother example is smile.c. Compile and excute it to display a smiley face on your X server.
If you compile with C++ you must undefine class (since it is a C++ reserved word). The class element of the Image structure in C++ is defined as c_class. Both of these requirements are illustrated here:
#include <magick.h> #if defined(__cplusplus) || defined(c_plusplus) #undef class #endif ... if (image->c_class == DirectClass)