小试ImageMagik——开发篇

=====================================================

ImageMagick的使用和开发的文章：

小试ImageMagik——使用篇

小试ImageMagik——开发篇

=====================================================





本文介绍使用ImageMagick开发程序的方法。ImageMagick安装之后就可以支持C/C++程序的开发，提供了3种接口。在这里首先介绍一下ImageMagick的3种接口。

MagickCore：

底层的C语言接口。较复杂，但是可以修改很多参数，只适合高端用户使用。

MagickWand：

推荐的C语言接口。相比于MagickCore接口，简单很多。适合普通用户使用。

Magick++：

提供面向对象的C++接口。

 

下面回顾一下ImageMagick安装后目录：



其中几个和开发有关的文件：

Lib文件夹：开发需要使用的静态库文件。包含4个库，前3个对应ImageMagick的3个接口：

CORE_RL_magick_.lib; CORE_RL_Magick++_.lib; CORE_RL_wand_.lib; X11.lib;

 

Include文件夹：开发需要使用的头文件。包含3个文件夹，对应ImageMagick的3个接口：

magick; Magick++; wand;

 

*.dll：开发和使用过程中需要使用的动态链接库文件。

 

在开发中我们需要3种文件：头文件（*.h），静态库文件（*.lib），动态库文件（*.dll）。因此我们在VC中新建一个工程，然后将Lib文件夹，Include文件夹，以及dll拷贝到工程目录下，并且配置一下头文件和静态库的路径，就可以了。

 

下面分别给出ImageMagick的3种接口对应的例子。

MagickCore（底层的C语言接口。较复杂，但是可以修改很多参数，只适合高端用户使用）

功能：读取文件，创建缩略图，并保存成文件。

/*
* 雷霄骅
* leixiaohua1020@126.com
* http://blog.csdn.net/leixiaohua1020 * 中国传媒大学/数字电视技术
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <magick/MagickCore.h>

int main(int argc,char **argv)
{
ExceptionInfo
*exception;

Image
*image,
*images,
*resize_image,
*thumbnails;

ImageInfo
*image_info;

if (argc != 3)
{
(void) fprintf(stdout,"Usage: %s image thumbnail\n",argv[0]);
exit(0);
}
/*
Initialize the image info structure and read an image.
*/
MagickCoreGenesis(*argv,MagickTrue);
exception=AcquireExceptionInfo();
image_info=CloneImageInfo((ImageInfo *) NULL);
(void) strcpy(image_info->filename,argv[1]);
images=ReadImage(image_info,exception);
if (exception->severity != UndefinedException)
CatchException(exception);
if (images == (Image *) NULL)
exit(1);
/*
Convert the image to a thumbnail.
*/
thumbnails=NewImageList();
while ((image=RemoveFirstImageFromList(&images)) != (Image *) NULL)
{
resize_image=ResizeImage(image,106,80,LanczosFilter,1.0,exception);
if (resize_image == (Image *) NULL)
MagickError(exception->severity,exception->reason,exception->description);
(void) AppendImageToList(&thumbnails,resize_image);
DestroyImage(image);
}
/*
Write the image thumbnail.
*/
(void) strcpy(thumbnails->filename,argv[2]);
WriteImage(image_info,thumbnails);
/*
Destroy the image thumbnail and exit.
*/
thumbnails=DestroyImageList(thumbnails);
image_info=DestroyImageInfo(image_info);
exception=DestroyExceptionInfo(exception);
MagickCoreTerminus();
return(0);
}


MagickWand（推荐的C语言接口。相比于MagickCore接口，简单很多。适合普通用户使用）

功能： 读取文件，创建缩略图，并保存成文件。

/*
* 雷霄骅
* leixiaohua1020@126.com
* http://blog.csdn.net/leixiaohua1020 * 中国传媒大学/数字电视技术
*/
#include <stdio.h>
#include <stdlib.h>
#include <wand/MagickWand.h>

int main(int argc,char **argv)
{

MagickBooleanType status;

MagickWand *magick_wand;

if (argc != 3)
{
(void) fprintf(stdout,"Usage: %s image thumbnail\n",argv[0]);
exit(0);
}
/*
Read an image.
*/
MagickWandGenesis();
magick_wand=NewMagickWand();
status=MagickReadImage(magick_wand,argv[1]);
/*
Turn the images into a thumbnail sequence.
*/
MagickResetIterator(magick_wand);
while (MagickNextImage(magick_wand) != MagickFalse)
MagickResizeImage(magick_wand,106,80,LanczosFilter,1.0);
/*
Write the image then destroy it.
*/
status=MagickWriteImages(magick_wand,argv[2],MagickTrue);

magick_wand=DestroyMagickWand(magick_wand);
MagickWandTerminus();
return(0);
}

Magick++（提供面向对象的C++接口）

/*
* 雷霄骅
* leixiaohua1020@126.com
* http://blog.csdn.net/leixiaohua1020 * 中国传媒大学/数字电视技术
*/
//创建Image对象，
// create a blank image canvas with 640x480 size and 'white' color as background:
Image blank_image( Geometry(640, 480), Color(MaxRGB, MaxRGB, MaxRGB, 0));
// or also, by using the automatic C++ type conversions for the arguments:
Image blank_image("640x480", "white");

// create an image from URL
Image url_image("http://www.serverName.com/image.gif");
Image local_file_image("my_image.gif"); // here the URL points to the local filesystem
//获取/设置属性
// Canvas geometry
// returns an unsigned int representing the my_image width
unsigned int Image::columns();
// returns an unsigned int representing the my_image heigth
unsigned int Image::rows();
// sets the my_image format; the format string can be "GIF", etc
void Image::magick("png");
// returns a string value representing the image format (e.g. “GIF”, “JPEG”, etc)
string Image::magick();
//读取/保存图像文件
// Reading the contents of a disk file into an image object can be performed
Image my_image(); // create an *empty* image using the default Image constructor
// read a GIF image file from disk; the image format is automatically set to GIF
my_image.read("aGIFImageFile.gif");
// Writing an Image object to a disk file. set the "format" attribute of my_image to PNG
my_image.magick("png");
// write to disk an image file
my_image.write("file_name_explicit_extension.gif");

MagickWand一般情况下属于使用比较普遍的，下面记录两个MagickWand开发的例子。

更多的例子可以参考：http://members.shaw.ca/el.supremo/MagickWand/

功能：将图像的宽高变成源图像的50%

/*
* 雷霄骅
* leixiaohua1020@126.com
* http://blog.csdn.net/leixiaohua1020 * 中国传媒大学/数字电视技术
*/
#include <windows.h>
#include <wand/magick_wand.h>

void test_wand(void)
{
MagickWand *m_wand = NULL;

int width,height;

MagickWandGenesis();

m_wand = NewMagickWand();
// Read the image - all you need to do is change "logo:" to some other
// filename to have this resize and, if necessary, convert a different file
MagickReadImage(m_wand,"logo:");

// Get the image's width and height
width = MagickGetImageWidth(m_wand);
height = MagickGetImageHeight(m_wand);

// Cut them in half but make sure they don't underflow
if((width /= 2) < 1)width = 1;
if((height /= 2) < 1)height = 1;

// Resize the image using the Lanczos filter
// The blur factor is a "double", where > 1 is blurry, < 1 is sharp
// I haven't figured out how you would change the blur parameter of MagickResizeImage
// on the command line so I have set it to its default of one.
MagickResizeImage(m_wand,width,height,LanczosFilter,1);

// Set the compression quality to 95 (high quality = low compression)
MagickSetImageCompressionQuality(m_wand,95);

/* Write the new image */
MagickWriteImage(m_wand,"logo_resize.jpg");

/* Clean up */
if(m_wand)m_wand = DestroyMagickWand(m_wand);

MagickWandTerminus();
}

功能：在图像的周围加上边框

/*
* 雷霄骅
* leixiaohua1020@126.com
* http://blog.csdn.net/leixiaohua1020 * 中国传媒大学/数字电视技术
*/
#include <windows.h>
#include <wand/magick_wand.h>

void test_wand(void)
{
MagickWand *m_wand = NULL;
PixelWand *p_wand;
int w,h;

MagickWandGenesis();

/* Create a wand */
m_wand = NewMagickWand();
p_wand = NewPixelWand();

// Change this to whatever colour you like - e.g. "none"
PixelSetColor(p_wand, "blue");
/* Read the input image */
MagickReadImage(m_wand,"logo:");
w = MagickGetImageWidth(m_wand);
h = MagickGetImageHeight(m_wand);
MagickSetImageBackgroundColor(m_wand,p_wand);
// This centres the original image on the new canvas.
// Note that the extent's offset is relative to the
// top left corner of the *original* image, so adding an extent
// around it means that the offset will be negative
MagickExtentImage(m_wand,1024,768,-(1024-w)/2,-(768-h)/2);
MagickWriteImage(m_wand,"logo_extent.jpg");

/* Tidy up */
m_wand = DestroyMagickWand(m_wand);
p_wand = DestroyPixelWand(p_wand);
MagickWandTerminus();
}补充：详细的教程可以从ImageMagick的官网（http://www.imagemagick.org/）左侧的目录中查看。在Program
Interfaces里面有几种接口的详细开发说明。